Metadata-Version: 1.1
Name: tracestack
Version: 0.1.9.4
Summary: Instantly search your Python error messages on the web.
Home-page: https://www.github.com/danrobinson/tracestack
Author: Dan Robinson
Author-email: danrobinson010@gmail.com
License: UNKNOWN
Download-URL: https://github.com/danrobinson/tracestack/tarball/0.1.9.4
Description: Tracestack
        ==========
        
        Tracestack lets you search your latest Python error message on
        Stackoverflow or Google, with a single keystroke.
        
        Features
        --------
        
        -  Integrate tracestack 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)
           -  Google, searching the entire web
           -  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
            Hit spacebar 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
            Hit spacebar 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
        ----------------------
        
        -  `lukasschwab/Stackit <https://github.com/lukasschwab/stackit>`__
        
           -  search and browse StackOverflow in the command line
           -  pipe error messages directly into queries
        
        -  `gleitz/howdoi <https://github.com/gleitz/howdoi>`__
        
           -  get programming answers to plaintext questions in the command line
           -  works using inexplicable Jedi magic
        
        -  `dgrtwo/tracestack <https://github.com/dgrtwo/tracestack>`__
        
           -  original tracestack package for the R language
           -  written on a phone
        
Platform: UNKNOWN
