Flask Parameter Validation

Get and validate all Flask input parameters with ease.

Install

Pip: Install with pip install flask_parameter_validation.
Manually:
- git clone https://github.com/Ge0rg3/flask-parameter-validation.git
- python setup.py install

Simple Usage

from flask import Flask
from typing import List, Optional
from flask_parameter_validation import ValidateParameters, Route, Json, Query
from datetime import datetime

app = Flask(__name__)


@app.route("/update/<int:id>", methods=["POST"])
@ValidateParameters()
def hello(
        id: int = Route(),
        username: str = Json(min_str_length=5, blacklist="<>"),
        age: int = Json(min_int=18, max_int=99),
        nicknames: List[str] = Json(),
        date_of_birth: datetime = Json(),
        password_expiry: Optional[int] = Json(5),
        is_admin: bool = Query(False)
     ):
    return "Hello World!"


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

Detailed Usage

We use the ValidateParameters decorator on all functions that this modules should be used in.
The format for arguments is as follows: parameter_name: parameter_type = Class() In this example, parameter_name would be the field name itself, such as "username". parameter_type would be the expected python data type, such as str, int, List, Union etc. Finally, Class() is one of the class inputs, as detailed below:

Classes

Route()
This is the data passed through the URL, such as /users/<int:id>
Form()
This is the data passed by a normal HTML form, often with x-www-form-urlencoded content-type.
Json()
This is any JSON body sent -- request must have application/json content type for flask to read this.
Query()
This covers query parameters (aka GET parameters), such as /news/article?id=55
File()
The validation on files are different to the others, but file input can still be obtained here as their Flask FileStorage objects.

Input types

str
int
bool
float
typing.List
typing.Union
typing.Optional
datetime.datetime
datetime.date
datetime.time

Validation

All parameters can have default values, and automatic validation.
Route, Form, Json and Query have the following options:

default: any, Specifies the default value for the field.
min_str_length: int, Specifies the minimum character length for a string input
max_str_length: int, Specifies the maximum character length for a string input
min_list_length: int, Specifies the minimum number of elements in a list
max_list_length: int, Specifies the maximum number of elements in a list
min_int: int, Specifies the minimum number for an int input
max_int: int, Specifies the maximum number for an int input
whitelist: str, A string containing allowed characters for the value
blacklist: str, A string containing forbidden characters for the value
pattern: str, A regex pattern to test for string matches
func: Callable -> Union[bool, tuple[bool, str]], A function containing a fully customized logic to validate the value
datetime_format: str, str: datetime format string (datetime format codes)

File has the following options:

content_types: array of strings, an array of allowed content types.
min_length: Minimum content-length for a file
max_length: Maximum content-length for a file

These validators are passed into the classes in the route function, such as:

username: str = Json("defaultusername", min_length=5)
profile_picture: Any = File(content_types=["image/png", "image/jpeg"])
filter: str = Query()

Overwriting default errors

By default, the error messages are returned as a JSON response, with the detailed error in the "error" field. However, this can be edited by passing a custom error function into the ValidateParameters decorator. For example:

def error_handler(err):
    error_name = type(err)
    error_parameters = err.args
    error_message = str(err)
    return {
        "error_name": type(err).__name__,
        "error_parameters": err.args,
        "error_message": str(err)
    }, 400

@ValidateParameters(error_handler)
def api(...)

Metadata

Release files for Flask-Parameter-Validation 2.1.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Flask-Parameter-Validation 2.1.4
File	Size	Uploaded
Flask-Parameter-Validation-2.1.4.tar.gz	8.2 kB	Apr 13, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for Flask-Parameter-Validation 2.1.4
File	Interpreter	ABI	Platform	Reset
Flask_Parameter_Validation-2.1.4-py3-none-any.whl 11.1 kB Apr 13, 2023	Python 3	none	any	Details

Total release size: 19.3 kB

Release files / Flask-Parameter-Validation-2.1.4.tar.gz

Download URL	Flask-Parameter-Validation-2.1.4.tar.gz
Size	8.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`9a064ef33b4f8e44146357c23acf5306ce3ad6736c51bf56e7511bce1fea8979`
BLAKE2b-256 checksum How to use checksums	`e0c6d78ec05215dfe2d0a73c67c79f47c35f015d3aae2f6e5f369d19d85c4450`
Upload date	Apr 13, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.9.16`

Release files / Flask_Parameter_Validation-2.1.4-py3-none-any.whl

Download URL	Flask_Parameter_Validation-2.1.4-py3-none-any.whl
Size	11.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`360ecf5131277f5d70e392aa6d0c6fe0367aa9ed5f9038207b40320880930499`
BLAKE2b-256 checksum How to use checksums	`24e6629f7633c0664aa4a8ebb60c4c47a2f7c727500c774dc5b2b515ca24e91c`
Upload date	Apr 13, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.9.16`