Skip to content
A debug server for wsgi apps
Branch: develop
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
ohoh
tests
.editorconfig
.gitattributes
.gitignore
.travis.yml
LICENSE.txt
MANIFEST.in
README.rst
setup.py
tox.ini

README.rst

ohoh

build status License

OhOh is a debugger for your WSGI applications. Using OhOh, you can inspect the stack frames of a wsgi app that's thrown an exception.

Usage

Use this command to serve your wsgi app in debug mode:

> ohoh "package.module:wsgi_app" -s localost:5000

For a full range of options, see ohoh -h

OhOh provides a plug-in for the httpie utility. You can install httpie using pip install httpie. Once you send a request that results in an exception, you will enter the debugger automatically:

> http localhost:5000
HTTP/1.0 500 Internal Server Error
Date: Fri, 24 Jul 2015 23:41:20 GMT
Server: WSGIServer/0.2 CPython/3.4.2
Content-Type: text/plain; charset=utf-8
OhOh-Debug-Token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1N [Truncated (5061 chars) ...]
Location: http://localhost:5000/ohoh-debug/
Content-Length: 454

Traceback (most recent call last):
  File "c:\dev\ohoh\build\lib\ohoh\middleware.py", line 57, in __call__
    return self._app(environ, start_response)
  File "tests\mock_app.py", line 6, in simple_err_app
    path.join("foo bar", 475564)
  File "C:\Python34\lib\ntpath.py", line 110, in join
    p_drive, p_path = splitdrive(p)
  File "C:\Python34\lib\ntpath.py", line 159, in splitdrive
    if len(p) > 1:
TypeError: object of type 'int' has no len()
OhOh Interactive Debugger v0.1.dev28+n8ec9121
(odb) up
> c:\python34\lib\ntpath.py(110)join()
-> p_drive, p_path = splitdrive(p)
(odb)

Commands

The following commands are supported by the command interpreter (you can type help at the debugger prompt for online help with commands):

Command Description
Client commands
quit Exit the debugger.
token View the current debug server token.
url View or set the url to which debug requests are sent.
version View the version number of the debugger.
Debug commands
! Execute a one-line statement in the current context.
args Print the argument list to the current function.
p Print the value of an expression.
pp Pretty print the value of an expression.
where Print the stack trace, with the most recent call last.
up Move up one frame in the stack.
down Move down one frame in the stack.
You can’t perform that action at this time.