A friendly library for parsing HTTP request arguments.

Release v3.0.2. (Changelog)

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

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

app = Flask(__name__)

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

def index(args):
    return 'Hello ' + args['name']

if __name__ == '__main__':

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

Webargs will automatically parse:

Query Parameters

$ curl http://localhost:5000/\?name\='Freddie'
Hello Freddie

Form Data

$ curl -d 'name=Brian' http://localhost:5000/
Hello Brian


$ curl -X POST -H "Content-Type: application/json" -d '{"name":"Roger"}' http://localhost:5000/
Hello Roger

and, optionally:

  • Headers

  • Cookies

  • Files

  • Paths

Why Use It

  • Simple, declarative syntax. Define your arguments as a mapping rather than imperatively pulling values off of request objects.

  • Code reusability. If you have multiple views that have the same request parameters, you only need to define your parameters once. You can also reuse validation and pre-processing routines.

  • Self-documentation. Webargs makes it easy to understand the expected arguments and their types for your view functions.

  • Automatic documentation. The metadata that webargs provides can serve as an aid for automatically generating API documentation.

  • Cross-framework compatibility. Webargs provides a consistent request-parsing interface that will work across many Python web frameworks.

  • marshmallow integration. Webargs uses marshmallow under the hood. When you need more flexibility than dictionaries, you can use marshmallow Schemas to define your request arguments.

Get It Now

pip install -U webargs

Ready to get started? Go on to the Quickstart tutorial or check out some examples.