Instantly search your Python error messages on the web.
Project description
Instantly search your Python error messages on the web.
Features
Integrate it into your code in seconds, or run it from the command line
Post-mortem mode
REPL mode
Compatible with Python 2 and 3
Can search for answers on:
Google, limited to stackoverflow.com (default)
The entire web (via Google)
StackOverflow’s own search engine
Installation
pip install tracestack
Uses and Examples
Do a post-mortem autopsy of your last exception …
>>> 1 / 0 Traceback (most recent call last): File "<console>", line 1, in <module> ZeroDivisionError: integer division or modulo by zero >>> tracestack.pm() Traceback (most recent call last): File "<console>", line 1, in <module> ZeroDivisionError: integer division or modulo by zero Type s to search this error message on Stack Overflow (using Google):
… or catch all future exceptions …
>>> tracestack.enable() >>> 1 / 0 Traceback (most recent call last): File "<console>", line 1, in <module> ZeroDivisionError: integer division or modulo by zero Type s to search this error message on Stack Overflow (using Google): >>> tracestack.disable()
… or catch exceptions in only one function …
from tracestack import trace >>> @trace >>> def divide_by_zero(): 1 / 0
… or in any Python script run from the command line …
$ tracestack manage.py runserver
… or in a read-evaluate-print loop …
$ tracestack Python 2.7.6 (default, Sep 9 2014, 15:04:36) [GCC 4.2.1 Compatible Apple LLVM 6.0 (clang-600.0.39)] on darwin Type "help", "copyright", "credits" or "license" for more information. (TracestackConsole) >>> 1 / 0
Options
usage: tracestack [-h] [-s] [-e ENGINE] [SCRIPT] [ARGUMENTS [ARGUMENTS ...]] instantly search your Python error messages on the web positional arguments: SCRIPT the Python script ARGUMENTS any arguments to the script optional arguments: -h, --help show this help message and exit -s, --skip skip the prompt and immediately search each exception -e ENGINE, --engine ENGINE the search engine to use: 'default': Google limited to stackoverflow.com, 'google': full web search on Google, 'stackoverflow': StackOverflow site search
In addition to being used on the command line, any of these arguments can be passed to the pm, enable, and trace functions:
>>> 1/0 >>> tracestack.pm(skip=True) # immediately runs search based on last exception >>> tracestack.enable(engine="google") >>> 1/0 >>> tracestack.trace(engine="stackoverflow") >>> def divide_by_zero(): ... 1/0
Excellent Alternatives
-
search and browse StackOverflow in the command line
pipe error messages directly into queries
-
get programming answers to plaintext questions in the command line
works using inexplicable Jedi magic
-
original tracestack package for the R language
written on a phone
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.