Finalize version 0.4.0 and update docs

Author: LeanderCS

.github/workflows/test-lib-building.yaml

@@ -30,14 +30,25 @@ jobs:
       - name: Install built library
         run: pip install "$(ls dist/*.tar.gz | head -n 1)[optional]"
 
-      - name: Verify library usage - Part I
+      - name: Verify library usage - Part I - installation
         run: |
           python -c "import flask_inputfilter.InputFilter"
           python -c "from flask_inputfilter import InputFilter"
 
-      - name: Verify library usage - Part II
+      - name: Verify library usage - Part II - functional test
         run: pytest tests/
 
+      - name: Verify library usage - Part III - correct version
+        run: |
+          output=$(python -c "from flask_inputfilter import InputFilter; print(InputFilter)")
+
+          if [ "$output" = "<class 'flask_inputfilter.InputFilter.InputFilter'>" ]; then
+            echo "Test passed: Correct class returned"
+          else
+            echo "Test failed: Unexpected output - $output"
+            exit 1
+          fi
+
   build-and-test-cython:
     runs-on: ubuntu-latest
 
@@ -61,10 +72,21 @@ jobs:
       - name: Install built library
         run: pip install "$(ls dist/*.tar.gz | head -n 1)[optional]"
 
-      - name: Verify library usage - Part I
+      - name: Verify library usage - Part I - installation
         run: |
           python -c "import flask_inputfilter.InputFilter"
           python -c "from flask_inputfilter import InputFilter"
 
-      #- name: Verify library usage - Part II
-      #  run: pytest tests/
+      - name: Verify library usage - Part II - functional test
+        run: pytest tests/
+
+      - name: Verify library usage - Part III - correct version
+        run: |
+          output=$(python -c "from flask_inputfilter import InputFilter; print(InputFilter)")
+
+          if [ "$output" = "<class 'flask_inputfilter._InputFilter.InputFilter'>" ]; then
+            echo "Test passed: Correct class returned"
+          else
+            echo "Test failed: Unexpected output - $output"
+            exit 1
+          fi

MANIFEST.in

@@ -3,3 +3,4 @@ include LICENSE
 include docs/source/changelog.rst
 recursive-include flask_inputfilter *.py *.pyx *.c *.cpp
 prune tests
+recursive-prune __pycache__

README.rst

@@ -67,6 +67,7 @@ Definition
 
     class UpdateZipcodeInputFilter(InputFilter):
         def __init__(self):
+            super().__init__()
 
             self.add(
                 'id',

docs/source/changelog.rst

@@ -3,6 +3,12 @@ Changelog
 
 All notable changes to this project will be documented in this file.
 
+[0.4.0] - 2025-04-20
+--------------------
+
+
+
+
 [0.4.0a2] - 2025-04-17
 ----------------------
 

docs/source/conf.py

@@ -1,9 +1,9 @@
 project = "flask-inputfilter"
 copyright = "2025, Leander Cain Slotosch"
 author = "Leander Cain Slotosch"
-release = "0.4.0a2"
+release = "0.4.0"
 
-extensions = ["sphinx_rtd_theme"]
+extensions = ["sphinx_rtd_theme", "sphinx_design"]
 
 templates_path = []
 exclude_patterns = []

docs/source/guides/compile.rst

@@ -0,0 +1,74 @@
+Use compiled version
+====================
+
+By default the pure python version of the lib is used as a fallback.
+
+Getting started
+---------------
+
+To use the compiled version you will first need the cython module,
+you can install the corresponding version by also installing the
+``[compile]`` dependencies of the library.
+
+.. code-block:: bash
+
+    pip install flask-inputfilter[compile]
+
+Secondly, you will need the c++ compiler.
+
+Normally this is already installed on your system, but if not,
+depending on your os, you can use:
+
+.. grid:: 1
+    :gutter: 2
+
+    .. grid-item::
+        .. card:: Linux
+
+            Install the gcc compiler using apt.
+
+            .. code-block:: bash
+
+                sudo apt install g++
+
+    .. grid-item::
+        .. card:: MacOS
+
+            Either install the Xcode command line tools or use homebrew:
+
+            .. code-block:: bash
+
+                xcode-select --install g++
+
+            .. code-block:: bash
+
+                brew install g++
+
+    .. grid-item::
+        .. card:: Windows
+
+            1. Download MinGW:
+                https://www.mingw-w64.org
+            2. Install and add ``g++.exe`` to PATH.
+
+If you have the c++ compiler installed and reinstall the library,
+with or without the ``[compile]`` flag, depending if you already installed it,
+it will automatically compile the files, that offer an optimized version.
+
+After these steps you can use the library normally and should not get the warning in the console.
+
+Verify Installation
+-------------------
+
+If you followed the steps above, you should not see the warning message in the console.
+
+Additionally, you can verify if the compiled versions are
+being used by running the following commands:
+
+.. code-block:: bash
+
+    python -c "import flask_inputfilter"
+    python -c "InputFilter"
+
+If the result is ``<class 'flask_inputfilter._InputFilter.InputFilter'>``,
+the compiled version is being used.

docs/source/guides/index.rst

@@ -7,3 +7,4 @@ Guides
 
     create_own_components
     frontend_validation
+    compile

docs/source/index.rst

@@ -33,7 +33,7 @@ Available functions:
 
 .. note::
 
-    If you like the project, please consider giving it a star on GitHub.
+    If you like the project, please consider giving it a star on `GitHub <https://github.com/LeanderCS/flask-inputfilter>`_.
 
 Installation
 ------------

flask_inputfilter/__init__.py

@@ -16,8 +16,7 @@
 
     else:
         logging.getLogger(__name__).warning(
-            "Cython is not installed and g++ is not available. "
-            "Falling back to pure Python implementation. "
-            "Consider installing Cython and g++ for better performance."
+            "Cython or g++ not available. Falling back to pure Python implementation.\n"
+            "Consult docs for better performance: https://leandercs.github.io/flask-inputfilter/guides/compile.html"
         )
         from .InputFilter import InputFilter

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "flask_inputfilter"
-version = "0.4.0a2"
+version = "0.4.0"
 description = "A library to easily filter and validate input data in Flask applications"
 readme = "README.rst"
 requires-python = ">=3.7"