.. Falcon documentation master file, created by sphinx-quickstart on Mon Feb 17 18:21:12 2014. You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. The Falcon Web Framework ================================= Release v\ |version| (:ref:`Installation `) Falcon is a minimalist WSGI library for building speedy web APIs and app backends. We like to think of Falcon as the `Dieter Rams` of web frameworks. When it comes to building HTTP APIs, other frameworks weigh you down with tons of dependencies and unnecessary abstractions. Falcon cuts to the chase with a clean design that embraces HTTP and the REST architectural style. .. code:: python class QuoteResource: def on_get(self, req, resp): """Handles GET requests""" quote = { 'quote': ( "I've always been more interested in " "the future than in the past." ), 'author': 'Grace Hopper' } resp.media = quote api = falcon.API() api.add_route('/quote', QuoteResource()) What People are Saying ---------------------- "We have been using Falcon as a replacement for [framework] and we simply love the performance (three times faster) and code base size (easily half of our original [framework] code)." "Falcon looks great so far. I hacked together a quick test for a tiny server of mine and was ~40% faster with only 20 minutes of work." "Falcon is rock solid and it's fast." "I'm loving #falconframework! Super clean and simple, I finally have the speed and flexibility I need!" "I feel like I'm just talking HTTP at last, with nothing in the middle. Falcon seems like the requests of backend." "The source code for Falcon is so good, I almost prefer it to documentation. It basically can't be wrong." "What other framework has integrated support for 786 TRY IT NOW ?" Quick Links ----------- * `Read the docs `_ * `Falcon add-ons and complementary packages `_ * `Falcon talks, podcasts, and blog posts `_ * `falconry/user for Falcon users `_ @ Gitter * `falconry/dev for Falcon contributors `_ @ Gitter Features -------- Falcon tries to do as little as possible while remaining highly effective. - Routes based on URI templates RFC - REST-inspired mapping of URIs to resources - Global, resource, and method hooks - Idiomatic HTTP error responses - Full Unicode support - Intuitive request and response objects - Works great with async libraries like gevent - Minimal attack surface for writing secure APIs - 100% code coverage with a comprehensive test suite - No dependencies on other Python packages - Supports Python 2.7, 3.5+ - Compatible with PyPy Who's Using Falcon? ------------------- Falcon is used around the world by a growing number of organizations, including: - 7ideas - Cronitor - EMC - Hurricane Electric - Leadpages - OpenStack - Rackspace - Shiftgig - tempfil.es - Opera Software If you are using the Falcon framework for a community or commercial project, please consider adding your information to our wiki under `Who's Using Falcon? `_ You might also like to view our `Add-on Catalog `_, where you can find a list of add-ons maintained by the community. Documentation ------------- .. toctree:: :maxdepth: 2 user/index api/index deploy/index community/index changes/index