Depreacte old methods

Author: LeanderCS

docs/source/changelog.rst

@@ -4,12 +4,21 @@ Changelog
 All notable changes to this project will be documented in this file.
 
 
+[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.
+
+
 [0.7.2] - 2025-09-28
 --------------------
 
 Changed
 ^^^^^^^
-- Changed the way how to use the new decorator ``_condition``, ``_global_filter``, ``_global_validator`` and ``_model``.
+- 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())``
@@ -20,7 +29,7 @@ Changed
 
   ``_model = Example`` => ``model(Example)``
 
-  The previous way is still supported, but is not recommended because it is not streightforward and could lead to confusion.
+  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:
@@ -56,7 +65,8 @@ Changed
 
 Added
 ^^^^^
-- Added comprehensive ``py.typed`` file for PEP 561 compliance, improving type checking support for mypy and other static type checkers.
+- 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.
 
 

flask_inputfilter/_input_filter.pyx

@@ -15,6 +15,7 @@ import json
 import logging
 import sys
 from typing import Any, Optional, Type, TypeVar, Union
+import warnings
 
 from flask import Response, g, request
 
@@ -245,6 +246,13 @@ cdef class InputFilter:
         Args:
             condition (BaseCondition): The condition to add.
         """
+        warnings.warn(
+            "Using 'add_condition' is deprecated, use 'condition()' "
+            "instead. https://leandercs.github.io/flask-inputfilter"
+            "/options/declarative_api.html",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         self.conditions.append(condition)
 
     cdef void _register_decorator_components(self):
@@ -537,6 +545,13 @@ cdef class InputFilter:
             copy (Optional[str]): The name of the field to copy the value 
                 from.
         """
+        warnings.warn(
+            "Using 'add' is deprecated, use 'field()' "
+            "instead. https://leandercs.github.io/flask-inputfilter"
+            "/options/declarative_api.html",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         if name in self.fields:
             raise ValueError(f"Field '{name}' already exists.")
 
@@ -683,6 +698,13 @@ cdef class InputFilter:
         Args:
             filter: The filter to add.
         """
+        warnings.warn(
+            "Using 'add_global_filter' is deprecated, use 'global_filter()' "
+            "instead. https://leandercs.github.io/flask-inputfilter"
+            "/options/declarative_api.html",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         self.global_filters.append(filter)
 
     cpdef list[BaseFilter] get_global_filters(self):
@@ -784,6 +806,13 @@ cdef class InputFilter:
         Args:
             validator (BaseValidator): The validator to add.
         """
+        warnings.warn(
+            "Using 'add_global_validator' is deprecated, use 'global_validator()' "
+            "instead. https://leandercs.github.io/flask-inputfilter"
+            "/options/declarative_api.html",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         self.global_validators.append(validator)
 
     cpdef list[BaseValidator] get_global_validators(self):

flask_inputfilter/conditions/base_condition.py

@@ -9,3 +9,5 @@
     DeprecationWarning,
     stacklevel=2,
 )
+
+from flask_inputfilter.models import BaseCondition

flask_inputfilter/filters/base_filter.py

@@ -9,3 +9,5 @@
     DeprecationWarning,
     stacklevel=2,
 )
+
+from flask_inputfilter.models import BaseFilter

flask_inputfilter/input_filter.py

@@ -6,6 +6,7 @@
 import logging
 import sys
 from typing import TYPE_CHECKING, Any, Optional, Type, TypeVar, Union
+import warnings
 
 from flask import Response, g, request
 
@@ -211,6 +212,13 @@ def add_condition(self, condition: BaseCondition) -> None:
         Args:
             condition (BaseCondition): The condition to add.
         """
+        warnings.warn(
+            "Using 'add_condition' is deprecated, use 'condition()' "
+            "instead. https://leandercs.github.io/flask-inputfilter"
+            "/options/declarative_api.html",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         self.conditions.append(condition)
 
     def _register_decorator_components(self) -> None:
@@ -497,6 +505,13 @@ def add(
             copy (Optional[str]): The name of the field to copy the value
                 from.
         """
+        warnings.warn(
+            "Using 'add' is deprecated, use 'field()' "
+            "instead. https://leandercs.github.io/flask-inputfilter"
+            "/options/declarative_api.html",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         if name in self.fields:
             raise ValueError(f"Field '{name}' already exists.")
 
@@ -643,6 +658,13 @@ def add_global_filter(self, filter: BaseFilter) -> None:
         Args:
             filter: The filter to add.
         """
+        warnings.warn(
+            "Using 'add_global_filter' is deprecated, use 'global_filter()' "
+            "instead. https://leandercs.github.io/flask-inputfilter"
+            "/options/declarative_api.html",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         self.global_filters.append(filter)
 
     def get_global_filters(self) -> list[BaseFilter]:
@@ -745,6 +767,13 @@ def add_global_validator(self, validator: BaseValidator) -> None:
         Args:
             validator (BaseValidator): The validator to add.
         """
+        warnings.warn(
+            "Using 'add_global_validator' is deprecated, use 'global_validator()' "
+            "instead. https://leandercs.github.io/flask-inputfilter"
+            "/options/declarative_api.html",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         self.global_validators.append(validator)
 
     def get_global_validators(self) -> list[BaseValidator]:

flask_inputfilter/validators/base_validator.py

@@ -9,3 +9,5 @@
     DeprecationWarning,
     stacklevel=2,
 )
+
+from flask_inputfilter.models import BaseValidator

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "flask_inputfilter"
-version = "0.7.2"
+version = "0.7.3"
 description = "A library to easily filter and validate input data in Flask applications"
 readme = "README.md"
 keywords = [