req === Release v\ |version|. Req helps you define the kinds of data your REST APIs deal with. With those definitions in place you can validate incoming requests, convert between internal and external data representations, output JSON Schema and Swagger specs for your API, automatically generate Python clients and more. Organization ------------ Req documentation is split into three parts: * A :doc:`tutorial ` that introduces the basic concepts of req and takes you from scratch all the way through building a simple API. * A :doc:`number of guides ` that dive deeper into the various concepts present in req. In addition to explaining the aforementioned concepts, these guides include recipes that explain the steps involved in solving common problems using req. * The Python API :doc:`reference documentation `. Assumptions ^^^^^^^^^^^ Since req currently integrates best with Falcon_, these docs assume you are at least minimally familiar with the basics of that framework. If you aren't, start with `their docs`_ first. The Tutorial ------------ Start here if you're completely new to req. The tutorial will take you through building a simple Falcon/req API from scratch. .. toctree:: :maxdepth: 2 tutorial The User Guides --------------- .. toctree:: :maxdepth: 2 guides The API Reference ----------------- .. toctree:: :maxdepth: 3 api Reporting problems ------------------ If you spot any typos, missing words, invalid code samples or stuff that's plain wrong, feel free to open an issue on the `req issue tracker`_ or to open a pull request containing a fix. .. _Falcon: http://falconframework.org/ .. _their docs: http://falcon.readthedocs.org/en/0.3.0.1/user/index.html .. _req issue tracker: https://bitbucket.org/leadbrite/req/issues?status=new&status=open