GatherUp helps you post essential Python config details to GitHub or Discourse, all beautifully formatted
Asciinema walk-through of GatherUp (has no sound, unlike the YouTube walk-through link above)
When something goes wrong or you want to discuss a project, a lot of the useful information is easily found on your computer but it can be tedious to gather it all together and post it neatly in a GitHub Issue or a Discourse Topic.
GatherUp can streamline and automate both the gathering and formatting steps, making this a lot easier, resulting in well formatted and helpful posts.
It focuses on the basic / common parts of your Python configuration, leaving you to craft the rest for anything more bespoke and to flesh out a meaningful question or comment (don't skimp on this last part! 🙂)
It has several command line options and offers built-in multi-lingual instructions in the terminal (please see Translation if you can help translate it into more languages)
There are four basic steps:
- Answer some config related questions in the terminal
- Copy the block of text (between the brightly coloured markers)
- Paste the text into GitHub or Discourse
- Edit if necessary and submit
Because it's working for you, and because you post the text as the final step, if there's anything you want to change or cut out, it's easy to do so, either by skipping the question all together or editing the text you'll post right before submitting it.
Usage: gatherup [OPTIONS]
GatherUp helps you post essential Python config details to GitHub or
Discourse, all beautifully formatted
Options:
-d, --debug Show debug information during usage.
-n, --no_instruct Suppress question for / display of instructions.
-l, --lang [en|de|fr|hi] Select language for instructions (ISO_639-1).
-p, --project TEXT Select project name (uses details, where found, in
"project_details.txt").
-m, --demo Demo of formatted output using built-in example files
-s, --setup Setup user config file and offer to install example
files in app directory
--version Show the version and exit.
--help Show this message and exit.
Installing via pipx means you can run GatherUp anywhere, just by using the command "gatherup" and any of the options.
- Install pipx as per their installation instructions
- Run
pipx install gatherup- that's it 🎉
You may well want to do this from within a virtual environment.
pip install gatherup
You may well want to do this from within a virtual environment.
- Download the source from the repo on GitHub: https://github.com/nmstoker/gatherup
- Extract the code and navigate to the root directory
- Run
pip install -e .
🚦 As it is intended as a small time-saver, several things are out of scope.
Some are out of scope for the foreseeable future, as I don't expect to develop them, and others are out of scope just because I am keen to get the basics working well first before expanding.
Remember that this is meant to save you time, so we mustn't be tempted to go down every rabbit hole! 🕳️🐇
Currently it has had limited testing on Windows 10, with more involved testing on Arch Linux and Raspberry Pi OS. It is untested on Mac and other Linux variants - if it can be made to work on any/all of these that would be great, but I would expect that to be gradual.
Whilst the information it gathers is not set in stone, I am wary of extending it to cover too broad a range of scenarios: better to do a common core well than a huge swathe poorly and unreliably.
I am also strongly against anything that would appear to invade user privacy with the tool - the ethos is for the user to be in the driving seat, making informed decisions about what (if anything) they share.
My hope is to get good coverage of major languages with the translations of the instructions (and in future the Question UI too).
If you are able to help or can recommend someone happy to volunteer then see TRANSLATING.md for more details.
• Customisation • License • Contributors