Monthly Archives: April 2014

Exporting API reference from Tornado app - Mistakes to avoid

I've developed a small RESTful service with Tornado and I wanted to generated doc for the exposed API. Lucky me, someone already thought about it and created the sphinxcontrib.autohttp.tornado addon for Sphinx.

The next few tips will help getting the work done:

  1. If you're using python-3, you need to use this file tornado.py. The latest release 1.2.1 (as of 30/04/2014) doesn't work with python-3, because

    The predicate needs to be changed to include ismethod or isfunction
  2. In the subclass of the RequestHandler, be sure that the SUPPORTED_METHODS is defined as a tuple
  3. If you add a decorator to your handler methodes, be sure to use functools.wraps or functools.update_wrapper to copy the docstring of the original method to the function returned by the decorator.

Ahja jõgi

 

GPX tracks (total: 8.5 Km):