cirdan

Decorator-based documentation generation for Falcon-based web applications.


License
Other
Install
pip install cirdan==1.1.1

Documentation

Cirdan

Build Status

Decorator-based documentation generation for Falcon web applications. Named after Círdan the Shipwright. Supports Python 2.7 and 3.4.

This was built with the thought in mind that every step of documenting your API should be easy. There exist a number of solutions (such as Sphinx) that can generate HTML docs from docstrings in your code, but that means you still have to host those somewhere. Cirdan serves your API's documentation from the API server itself, meaning that your docs and code are always in sync.

Installation

pip install cirdan

Docs for Cirdan can be found here.

Quick Example

import cirdan
import falcon
from cirdan.decorators import title, description
from wsgiref import simple_server

@title("It's a resource")
@description("It does a thing.")
class SomeResource:
    @title("Get Greeted")
    @description("This route says hello.")
    def on_get(self, request, response):
        response.body = "Hello"

# Important that this comes before your app is initialized
cirdan.inject()

app = falcon.API()
app.add_route("/something", SomeResource())

simple_server.make_server("localhost", 8080, app).serve_forever()

Run that, then navigate to http://localhost:8080/docs in your browser. It's that simple - Cirdan is automatically bound, and knows about all of your routes. See demo.py for a more extended example - a running version of the docs it generates is available on Heroku.

License

MIT