Aspen is a filesystem dispatch library for Python web frameworks. Instead of using regular expressions, decorators, or object traversal, Aspen dispatches HTTP requests based on the natural symmetry of URL paths and filesystem paths. In the immortal words of Jeff Lindsay, “so like. a web server.” Yes! ;-)

This is the documentation for the development version of the core Aspen library, describing its filesystem dispatch behavior regardless of the web framework you’re using it with. For instructions on configuring Aspen with a specific web framework, see the docs for django-aspen, Flask-Aspen, or Pando. See the project homepage for an overview.

This version of Aspen has been tested with Python 3.6, 3.7, 3.8 and 3.9, on both Ubuntu and Windows.

Aspen’s source code is on GitHub, and is MIT-licensed.


Aspen is available on PyPI:

$ pip install aspen

See Also

The Keystone web framework was inspired by Aspen.