Skip to content

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

License

Notifications You must be signed in to change notification settings

marshmallow-code/webargs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

b9cfe7e · Mar 3, 2025
Oct 17, 2024
Oct 17, 2024
Mar 4, 2024
Jan 28, 2025
Jan 7, 2025
May 4, 2018
Mar 3, 2025
Dec 31, 2023
Sep 11, 2024
Jan 7, 2025
Feb 2, 2019
Sep 11, 2024
Jan 30, 2024
Apr 5, 2016
Jan 7, 2025
Jan 30, 2024
Jan 30, 2024
Mar 3, 2025
Oct 17, 2024

Repository files navigation

webargs

PyPI package Build status Documentation marshmallow 3|4 compatible

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

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

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

app = Flask(__name__)


@app.route("/")
@use_args({"name": fields.Str(required=True)}, location="query")
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

Documentation

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

Support webargs

webargs is maintained by a group of volunteers. If you'd like to support the future of the project, please consider contributing to our Open Collective:

Donate to our collective

Professional Support

Professionally-supported webargs is available through the Tidelift Subscription.

Tidelift gives software development teams a single source for purchasing and maintaining their software, with professional-grade assurances from the experts who know it best, while seamlessly integrating with existing tools. [Get professional support]

Get supported marshmallow with Tidelift

Security Contact Information

To report a security vulnerability, please use the Tidelift security contact. Tidelift will coordinate the fix and disclosure.

Project Links

License

MIT licensed. See the LICENSE file for more details.