Metadata-Version: 2.0
Name: webargs
Version: 1.6.2
Summary: A friendly library for parsing and validating HTTP request arguments, with built-in support for popular web frameworks, including Flask, Django, Bottle, Tornado, Pyramid, webapp2, Falcon, and aiohttp.
Home-page: https://github.com/sloria/webargs
Author: Steven Loria
Author-email: sloria1@gmail.com
License: MIT
Keywords: webargs,http,flask,django,bottle,tornado,aiohttp,webapp2,request,arguments,validation,parameters,rest,api,marshmallow
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
Requires-Dist: marshmallow (>=2.7.0)

=======
webargs
=======

.. image:: https://badge.fury.io/py/webargs.svg
    :target: http://badge.fury.io/py/webargs

.. image:: https://travis-ci.org/sloria/webargs.svg?branch=pypi
    :target: https://travis-ci.org/sloria/webargs

Homepage: https://webargs.readthedocs.io/

webargs is a Python library for parsing and validating HTTP request arguments, with built-in support for popular web frameworks, including Flask, Django, Bottle, Tornado, Pyramid, webapp2, Falcon, and aiohttp.

.. code-block:: python

    from flask import Flask
    from webargs import fields
    from webargs.flaskparser import use_args

    app = Flask(__name__)

    hello_args = {
        'name': fields.Str(required=True)
    }

    @app.route('/')
    @use_args(hello_args)
    def index(args):
        return 'Hello ' + args['name']

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

    # curl http://localhost:5000/\?name\='World'
    # Hello World

Install
-------

::

    pip install -U webargs

webargs supports Python >= 2.7 or >= 3.4.


Documentation
-------------

Full documentation is available at https://webargs.readthedocs.io/.

Project Links
-------------

- Docs: http://webargs.readthedocs.io/
- Changelog: http://webargs.readthedocs.io/en/latest/changelog.html
- PyPI: https://pypi.python.org/pypi/webargs
- Issues: https://github.com/sloria/webargs/issues


License
-------

MIT licensed. See the `LICENSE <https://github.com/sloria/webargs/blob/dev/LICENSE>`_ file for more details.


