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.py verbatim, 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

lukasschwab / stackit

readme