Changelog

All notable changes to this project will be documented in this file.

[0.8.1] - 2026-08-17

Added

flask_inputfilter.__version__ attribute.

Changed

Code cleanup across the codebase: simplified conditionals (e.g. if chains to or expressions), import sorting and other lint autofixes.
Documentation cleanup: added the missing reference entries for ToImageFilter, ToBase64ImageFilter and IsImageValidator, removed unused autodoc_type_aliases from the Sphinx configuration and fixed the IsUUIDValidator name in AGENTS.md.

Fixed

The @InputFilter.validate() decorator now preserves the route function’s name via functools.wraps. Previously two decorated routes in the same app collided with “View function mapping is overwriting an existing endpoint function: wrapper”.

[0.8.0] - 2026-08-16

Added

OpenAPI Code Generation: Generate InputFilter classes directly from an OpenAPI 3.0 specification (YAML or JSON). All components/schemas are translated into declarative InputFilter classes — including nested objects, $ref references, arrays and constraint mapping (minLength/ maxLength, minimum/maximum, pattern, enum, format such as email, date or uuid) to the matching filters and validators. Available programmatically via generate_from_openapi() or through the new flask-inputfilter CLI: flask-inputfilter generate openapi api.yaml --output filters.py (--schema for a single schema, --output-dir for one file per schema). See the OpenAPI generator guide.
OpenAPI Endpoint Generation: generate_from_openapi and the CLI can also generate one InputFilter per endpoint (--include-endpoints, --endpoints-only, --path, --method), merging path parameters, query parameters and the JSON request body. A request body referencing a generated schema class is emitted as a subclass of that class.
OpenAPI Schema Export: The reverse direction — export existing InputFilter classes to OpenAPI 3.0 schemas via to_openapi_schema() / to_openapi_components() or flask-inputfilter export openapi myapp.filters:UserInputFilter (--all for every InputFilter of a module, --format json|yaml). Nested InputFilters become $ref references in components documents, and features without an OpenAPI equivalent (custom validators, computed fields, conditions, …) degrade gracefully into x- extension keywords instead of failing. Both directions share one bidirectional type/constraint mapping registry, keeping generated code and exported schemas consistent.
New Validators: IsEmailValidator, IsIpAddressValidator (IPv4/IPv6 with optional version restriction), IsPhoneValidator, IsCreditCardValidator (with Luhn checksum) and IsMimeTypeValidator (with optional allowed_types).

Removed

BaseValidator, BaseFilter and BaseCondition can now only be accessed through flask_inputfilter/models.

[0.7.5] - 2025-10-17

Added

Nested InputFilter Support: New feature to validate nested dictionary structures using InputFilters. Use the input_filter parameter in field() to specify an InputFilter class for nested validation. This enables composition of complex validation structures with multiple levels of nesting. See Field Decorator documentation for more details.

[0.7.4] - 2025-10-08

Added

Computed Fields: New feature to define read-only fields that are automatically calculated from other fields. Use the computed parameter in field() to provide a callable that receives the current data dictionary and returns the computed value. See Computed Fields documentation for more details.

[0.7.3] - 2025-10-08

Changed

Added deprecated warnings to old methods to add, add_condition, add_global_filter and add_global_validator to prepare for a later removal.
Allowed to pass an instance on RegexEnum to RegexValidator directly, without needing to converting it to an string.

[0.7.2] - 2025-09-28

Changed

Changed the way how to use the new declarative _condition, _global_filter, _global_validator and _model. They should no longer be assigned to a variable, but should be set with the corresponding declarative method.

_condition = [Example()] => condition(Example())

_global_filter = [Example()] => global_filter(Example())

_global_validator = [Example()] => global_validator(Example())

_model = Example => model(Example)

The previous way is still supported, but is not recommended because it is not straightforward and could lead to confusion. The new methods also support multiple calls and also mass assignment.

Both of the following examples are valid and have the same effect:
```
class ExampleInputFilter(InputFilter):
    field1: str = field()
    field2: str = field()
    condition(ExactlyOneOfCondition(['field1', 'field2']))

    field3: str = field()
    field4: str = field()
    condition(AtLeastOneOfCondition(['field3', 'field4']))
```
```
class ExampleInputFilter(InputFilter):
    field1: str = field()
    field2: str = field()
    field3: str = field()
    field4: str = field()

    condition(
        ExactlyOneOfCondition(['field1', 'field2']),
        AtLeastOneOfCondition(['field3', 'field4'])
    )
```

[0.7.1] - 2025-09-27

Added

Added comprehensive py.typed file for PEP 561 compliance, improving type checking support for mypy and other static type checkers.
Added AGENTS.md to document how to use this library for various ai agents.

[0.7.0] - 2025-09-25

Added

Added that fields, conditons, global filters and global validators can be added as decorator and do not require a self.add, self.add_condition, self.add_global_filter or self.add_global_validator call in the __init__.

self.add => field

self.add_condition => condition

self.add_global_filter => global_filter

self.add_global_validator => global_validator

self.add_model => model

Before:

class UpdateZipcodeInputFilter(InputFilter):
    def __init__(self):
        super().__init__()
        self.add(
            'id',
            required=True,
            filters=[ToIntegerFilter(), ToNullFilter()],
            validators=[
                IsIntegerValidator()
            ]
        )

        self.add_condition(ExactlyOneOfCondition(['zipcode', 'city']))

        self.add_global_filter(StringTrimFilter())

        self.add_global_validator(IsStringValidator())

        self.set_model(UserModel)

After:

class UpdateZipcodeInputFilter(InputFilter):
    id: int = field(
        required=True,
        filters=[ToIntegerFilter(), ToNullFilter()],
        validators=[IsIntegerValidator()]
    )

    condition(ExactlyOneOfCondition(['zipcode', 'city']))

    global_filter(StringTrimFilter())

    global_validator(IsStringValidator())

    model(UserModel)

The Change is fully backward compatible, but the new way is more readable and maintainable.

You can also mix both ways inside a single InputFilter.

[0.6.3] - 2025-09-24

Added

Added default timeout of 30s for external api requests.

Changed

Switched to more strict exception types for image filter.

[0.6.2] - 2025-07-03

Added

Added IsImageValidator, ToBase64ImageFilter and ToImageFilter.

[0.6.1] - 2025-07-02

Changed

Fixed issue with __init__.py for compiled versions.

[0.6.0] - 2025-06-30

Removed

Removed deprecated camel case methods and properties.
Removed deprecated subfolders.

[0.5.5] - 2025-06-30

Changed

Updated InputFilter to increase performance.
Updated IsDataclassValidator to be more readable and maintainable.

[0.5.4] - 2025-05-24

Added

Added ArrayElementFilter to filter elements in an array against specific filter.

Changed

Updated ArrayElementValidator to support validators directly.
Updated IsDataclassValidator to also check against their types, including nested dataclasses, lists, and dictionaries.

[0.5.3] - 2025-04-28

Changed

Migrated methods from camel to snake case

[0.5.2] - 2025-04-27

Changed

Moved multiple internal methods to own FieldMixin - applyFilters - applySteps - checkConditions - checkForRequired - validateField

[0.5.1] - 2025-04-26

Added

Added .whl for musllinux_aarch64 to the release process.

[0.5.0] - 2025-04-26

Changed

Moved components to subfolders to improve readability and maintainability. The following components have been moved: - Condition => conditions - Enum => enums - Exception => exceptions - Filter => filters - Mixin => mixins - Model => models - Validator => validators

But the old import paths are still available for backward compatibility, but because the old path will be abandoned in the future, it is recommended to use the new paths.
Renamed files into snake_case to follow the PEP8 standard. This requires a migration if you are importing the files directly. e.g. from flask_inputfilter.Filter import Base64ImageResizeFilter to from flask_inputfilter.filters.base64_image_resize_filter import Base64ImageResizeFilter.

If you are using the components through the module, you don’t need to change anything.

[0.4.3a1] - 2025-04-26

Added

whl generation for linux too.

[0.4.2] - 2025-04-25

Added

whl generation for all major versions and envs.

[0.4.1] - 2025-04-24

Changed

Introduced first c++ vector in InputFilter to improve performance.
Updated required cython version to 3.0 or higher for python 3.7 - 3.11.
Moved static methods outside of pure InputFilter class.

[0.4.0] - 2025-04-20

Added

Added possibility to use cython for performance improvements. View the guide for more information.

[0.4.0a2] - 2025-04-17

Changed

Added fallback for cython to use python if no c++ compiler is installed.
super().__init__() is now ONLY optional, if you are using the cython version.

[0.4.0a1] - 2025-04-17

Changed

InputFilter now uses cython for performance improvements.
Made super().__init__() call optional. You will only need to call it, if you are wanting to limit the allowed methods.

[0.3.1] - 2025-04-14

Changed

Updated error handling and changed broad Exception to specific errors.
Smaller performance improvements

[0.3.0] - 2025-04-10

Added

IsDateTimeValidator
IsDateValidator

Changed

Updated IsTypedDictValidator` and ``IsDataclassValidator to require a specific model and checks if the input json is in the defined format.
Introduced Mixins for parts of InputFilter

ConditionMixin

DataMixin

ErrorHandlingMixin

ExternalApiMixin

FieldMixin

FilterMixin

ModelMixin

ValidationMixin

Removed

RemoveEmojisFilter
ToPascaleCaseFilter
SlugifyFilter

[0.2.0] - 2025-04-07

Added

getErrorMessages

Changed

Updated error handling: The first error for each field is now returned in a combined format, enabling more detailed and flexible error handling on the frontend. Check it out
Errors received through external_api request get logged.

[0.1.2] - 2025-03-29

Added

getConditions
getGlobalFilters
getGlobalValidators
clear

Changed

Fixed merge method to fit expected behavior.

[0.1.1] - 2025-03-29

Changed

Fixed unexpected message in error message of IsIntegerValidator

[0.1.0] - 2025-03-26

Added

Multiple functions to allow a broader usage aside as decorator

getErrorMessage

getRawValue

getRawValues

getUnfilteredData

getValue

getValues

hasUnknown

isValid

merge

remove

replace

setData

setUnfilteredData

Removed

IsMimeTypeValidator

[0.0.10] - 2025-03-06

Added

Added python 3.14 support.

Changed

Use FieldModel for field definition. (Only internal change, no impact on usage)

[0.0.9.1] - 2025-02-09

Changed

Updated InputFilter to fix the issue with route params.

[0.0.9] - 2025-01-29

Added

New copy functionality to copy the value of another field. Check it out

Filter

New ToDataclassFilter to convert a dictionary to a dataclass.
New ToTypedDictFilter to convert a dictionary to a TypedDict.

Validator

New CustomJsonValidator to check if a value is the format of a specific json.
New IsDataclassValidator to check if a value is a dataclass.
New IsTypedDictValidator to check if a value is a TypedDict.

Changed

Moved external API call before the filter and validation process. Before, filters and validators the the external API field where useless, because the value of the field where replaced by the API result.
Updated SlugifyFilter to remove accents and other special characters.

[0.0.8] - 2025-01-20

Added

New functionality to define steps for a field to have more control over the order of the validation and filtering process.
Documentary

Filter

New Base64ImageDownscaleFilter to reduce the size of an image.
New Base64ImageResizeFilter to reduce the file size of an image.

Validator

New IsHorizontalImageValidator to check if an image is horizontal.
New IsVerticalImageValidator to check if an image is vertical.

Changed

Added UnicodeFormEnum to show possible config values for ToNormalizedUnicodeFilter. Old config is still supported, but will be removed in a later version.

[0.0.7.1] - 2025-01-16

Changed

Updated setup.py to fix the issue with the missing subfolders.

[0.0.7] - 2025-01-14

Added

Workflow to run tests on all supported Python versions.
Added more test coverage for validators and filters.
Added tracking of coverage in tests. Check it out
New functionality for global filters and validators in InputFilters.
New functionality to define custom supported methods.

Validator

New NotInArrayValidator to check if a value is not in a list.
New NotValidator to invert the result of another validator.

[0.0.6] - 2025-01-12

Added

New date validators and filters.

Removed

Dropped support for Python 3.6.

[0.0.5] - 2025-01-12

Added

New condition functionality between fields. Check it out

Changed

Switched external_api config from dict to class. Check it out

[0.0.4] - 2025-01-09

Added

New external API functionality. Check it out