Metadata-Version: 2.1
Name: wthell
Version: 0.1.0
Summary: A debugging tool that can help you what happened when you code quits unexpectedly
Home-page: https://github.com/gaogaotiantian/wthell
Author: Tian Gao
Author-email: gaogaotiantian@hotmail.com
License: UNKNOWN
Description: # wthell
        
        wthell is a debugging tool for python to interactively check frame stack when your code did something unexpectedly
        
        ## Install
        
        You can install ```wthell``` from pip
        
        ```
        pip install wthell
        ```
        
        ## Usage
        
        It's super easy to use wthell. Just import it and it's done!
        
        ```python
        import wthell
        ```
        
        If there's an uncaught exception, you will enter an interactive shell like this:
        
        ```python
          def g(a, b):
              a += h(a)
              b += 3
        >     raise Exception("lol")
        
        
        Exception raised: <class 'Exception'> lol
        
        back(b)     -- go to outer frame  | in(i)    -- go to inner frame
        clear(cl)   -- clear the console  | reset(r) -- back to trigger frame
        continue(c) -- resume the program | ctrl+D   -- quit
        
        >>> 
        ```
        
        You will be in the frame(function) that raised exceptions in the beginning. 
        
        * Type ```back``` to go to outer frame(its caller). 
        * Type ```in``` to go to inner frame(when you already go out). 
        * Type ```clear``` to clear the console prints
        * Type ```reset``` to go back to the original frame that triggered wthell
        * Type ```continue``` to resume the program
        
        wthell will record the full call stack so you can check any frame. 
        
        While you are in a stack, you can type anything that you want to evaluation to help you debug.
        
        ```python
        >>> a
        13
        >>> a + 1
        14
        >>> h(a)
        16
        >>> 
        ```
        
        Or you can trigger wthell anywhere in your code 
        
        ```python
        def suspicious_function():
            # I want to check here!
            wthell.wth()
        ```
        
        wthell behaves like an interactive shell. 
        
        Happy debugging!
        
        ## License
        
        Copyright Tian Gao, 2020.
        
        Distributed under the terms of the [Apache 2.0 license](https://github.com/gaogaotiantian/wthell/blob/master/LICENSE).
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
