Native literate programming in python through doctests. This is either the best or the worst thing I have ever written.

lit.md

Imports

First the imports, this demo requires the flask_restful package. Then we set up the Flask wsgi application object, app and the api wrapper, api.

>>> from flask import Flask
>>> from flask_restful import Resource, Api

>>> app = Flask(__name__)
>>> api = Api(app)

Flask Restful resources

We define a single HelloWorld resource, that responds with a simple json object on a GET request.

>>> class HelloWorld(Resource):
...     def get(self):
...         return {'hello': 'world'}

Routing

api.add_resource() wires the Resource class HelloWorld into the flask router at /.

>>> api.add_resource(HelloWorld, '/')

Run Server

After we have created everything, we run the flask werkzeug server.

>>> if __name__ == '__main__':
...     app.run()

Or for maximum hackery, add this extended shebang to make the .md file executable!

#!/usr/bin/env python
import doctest, sys; doctest.testfile(sys.argv[0])
#
"""
# markdown here
"""

You now can execute it:

$ ./lit.md
 * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)