stackit
stackit is a Stack Overflow query CLI built at SB Hacks 2015.
Features
- Written entirely in Python
- Automatically pipes error messages into Stack Overflow queries
- Parses and displays relevant questions and answers directly on the command line in reader-friendly markdown format
Installation
There are two ways to install stackit. Both should have roughly the same outcome, but have their advantages/disadvantages.
1. PyPI/pip
This method will always produce some stable build, but may not be the most up to date version. New functionality will come slower than building from this repo.
$ pip install stackit
Note, depending on your computer's settings, you may need to sudo pip install stackit.
2. Build from this repo
This method will always include the latest features, but sometimes will not work at all. Oops!
Clone the repo, then use setup.py to install the package. Note, this process will differ only slightly in a non-bash shell.
$ git clone https://github.com/lukasschwab/stackit.git
$ cd stackit
$ python setup.py install
Note, depending on your computer's settings, you may need to sudo python setup.py install.
Usage
The install process establishes an alias, stackit, for stackit_core.py's functionality. Instead of using python stackit_core.py, you will always simply use stackit at the command prompt.
Command line arguments
-h,--help: version splash page // usage-s:--search: search by user term (string)--version: simple version report--verbose: full text of top result and accepted answer-e:--stderr: runs your program and searches by stderr output-t:--tags: searches by tags in particular (multiple arguments)
Interface flow commands
m: more: shows the next 5 questions- #: select: shows full question//top answer text in focus -- be careful that it's clearly not the SO question ID, but the list index
--b: opens focused question in browser--x: exit: go back to the list focus
Examples
To search Stack Overflow for "How do I create a bash alias" with the tags, "shell";
$ stackit -s "How do I create a bash alias?" -t "shell"
Thanks
stackit uses several pre-existing projects:
- Py-StackExchange: a Python wrapper for the StackExchange API
- Requests: "HTTP for Humans"
- Beautiful Soup 4: pretty data parsing for HTML/XML files, so you can read stuff
- Pyfancy makes your print statements colorful // legible. This project doesn't incorporate
pyfancy.pyverbatim, but this project demonstrates the method. - Karan Goel's work with joe was a tremendous help in designing a command line tool in Python, and his Medium article on putting together a good readme is an inspiration to us all. Thank you based joe.
- Peter Downs has a great article on how to submit a package to PyPI.
Contributing
If you want to write code:
- Fork the repository
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'add some feature') - Push to your branch (
git push origin my-new-feature) - Create a new Pull Request