Skip to main content

A simple, lightweight parser and validator for RESTful HTTP requests

Project description

Python parser for RESTful HTTP requests

Python package

A simple, lightweight parser for RESTful HTTP request data. Python 3.6+

Installation

pip install restparse

Example usage:

from restparse.parser import Parser


parser = Parser(description="RESTful parameter parser")

parser._add_param(
    name="name",
    type=str,
    description="The users name",
    required=True
)
parser._add_param(
    name="age",
    type=int,
    description="The users age",
    required=True
)
parser._add_param(
    name="online",
    type=bool,
    description="Is the user online?",
    default=False
)
parser._add_param(
    name="height",
    type=float,
    description="The users height",
)
parser._add_param(
    name="tags",
    description="Tags",
)

payload = {
    "name": "John Doe",
    "age": "40",
    "online": False,
    "height": 6.2,
    "tags": ["python", "javascript"]
}

params = parser.parse_params(payload)

print(params.name)  # John Doe
print(params.tags)  # ['python', 'javascript']

print(params.to_dict())  # {'name': 'John Doe', 'age': 40, 'online': False, 'height': 6.2, 'tags': ['python', 'javascript']}

Usage with Flask

Parsing query strings:

@app.route("/")
def index():
    """ Parsing query strings """

    parser = Parser(description="Parsing query strings")

    parser._add_param(
        "q_from",
        type=int,
        description="Query from"
    )
    parser._add_param(
        "q_to",
        type=int,
        description="Query to"
    )
    parser._add_param(
        "search",
        type=str,
        description="Search query"
    )
    params = parser.parse_params(request.args)

    print(params.q_from)
    print(params.q_to)
    print(params.search)

    return f"Params = from: {params.q_from}, to: {params.q_to}, search: {params.search}"

Parsing request payloads:

@app.route("/json", methods=["POST"])
def json_payload():
    """ Parsing request payloads """

    parser = Parser(description="Parsing a request payload")

    parser._add_param(
        "name",
        type=str,
        description="The users name",
        required=True
    )
    parser._add_param(
        "age",
        type=int,
        description="The users age",
        required=True
    )
    parser._add_param(
        "tags",
        type=list,
        description="Tags"
    )
    params = parser.parse_params(request.get_json())

    print(params.name)
    print(params.age)
    print(params.tags)

    return jsonify(params.to_dict())

Parsing form data:

@app.route("/form", methods=["POST"])
def form_payload():
    """ Parsing form data """

    parser = Parser(description="Parsing form data")

    parser._add_param(
        "name",
        type=str,
        description="The users name",
        required=True
    )
    parser._add_param(
        "age",
        type=int,
        description="The users age",
        required=True
    )
    params = parser.parse_params(request.form)

    print(params.name)
    print(params.age)

    return redirect(url_for("index"))

_add_param()

parser._add_param(
    "name",
    type=str,
    dest="new_name",
    description="A description of the param",
    required=True,
    choices=["foo", "bar"]
)

options:

name (str): The parameter name
type (type): The type to which the parser should expect
dest (str): The name of the attribute to be added to the object returned by parse_params()
description (str): A description of the param
required (bool): Whether or not the param may be omitted
choices (container): A container of the allowable values for the argument
default: The value produced if the argument is absent from the params

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for restparse, version 0.0.3
Filename, size File type Python version Upload date Hashes
Filename, size restparse-0.0.3.tar.gz (6.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page