fastapi-fsp 0.1.0__tar.gz → 0.1.1__tar.gz

{fastapi_fsp-0.1.0 → fastapi_fsp-0.1.1}/.gitignore

@@ -34,6 +34,8 @@ coverage.xml
 # IDEs and editors
 .vscode/
 .idea/
+.idea/*
+.idea/workspace.xml
 *.iml
 
 # OS-specific

fastapi_fsp-0.1.1/.pre-commit-config.yaml

@@ -0,0 +1,21 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    # Use a ruff-pre-commit version compatible with your ruff version
+    # You can update this as needed.
+    rev: v0.6.9
+    hooks:
+      - id: ruff
+        args: ["--fix", "--exit-non-zero-on-fix"]
+      - id: ruff-format
+
+  # Run tests on commit. This may be slower, but ensures quality.
+  - repo: local
+    hooks:
+      - id: pytest
+        name: pytest
+        entry: pytest
+        language: system
+        pass_filenames: false
+        types: [python]
+        stages: [pre-commit]
+        args: ["-q"]

{fastapi_fsp-0.1.0 → fastapi_fsp-0.1.1}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: fastapi-fsp
-Version: 0.1.0
+Version: 0.1.1
 Summary: Filter, Sort, and Paginate (FSP) utilities for FastAPI + SQLModel
-Project-URL: Homepage, https://github.com/your-org/fastapi-fsp
-Project-URL: Repository, https://github.com/your-org/fastapi-fsp
-Project-URL: Issues, https://github.com/your-org/fastapi-fsp/issues
+Project-URL: Homepage, https://github.com/fromej-dev/fastapi-fsp
+Project-URL: Repository, https://github.com/fromej-dev/fastapi-fsp
+Project-URL: Issues, https://github.com/fromej-dev/fastapi-fsp/issues
 Author-email: Evert Jan Stamhuis <ej@fromejdevelopment.nl>
 License: MIT
 License-File: LICENSE

{fastapi_fsp-0.1.0 → fastapi_fsp-0.1.1}/fastapi_fsp/fsp.py

@@ -3,7 +3,8 @@ from typing import Annotated, Any, List, Optional
 
 from fastapi import Depends, HTTPException, Query, Request, status
 from sqlalchemy import Select, func
-from sqlmodel import Session, select
+from sqlmodel import Session, not_, select
+from sqlmodel.ext.asyncio.session import AsyncSession
 
 from fastapi_fsp.models import (
     Filter,
@@ -26,7 +27,7 @@ def _parse_filters(
     if not fields:
         return None
     filters: List[Filter] = []
-    if not (len(fields) == len(operators) == len(values)):
+    if operators is None or values is None or not (len(fields) == len(operators) == len(values)):
         raise HTTPException(
             status_code=status.HTTP_400_BAD_REQUEST,
             detail="Mismatched filter parameters.",
@@ -72,11 +73,24 @@ class FSPManager:
             )
         ).all()
 
+    async def paginate_async(self, query: Select, session: AsyncSession) -> Any:
+        result = await session.exec(
+            query.offset((self.pagination.page - 1) * self.pagination.per_page).limit(
+                self.pagination.per_page
+            )
+        )
+        return result.all()
+
     def _count_total(self, query: Select, session: Session) -> int:
         # Count the total rows of the given query (with filters/sort applied) ignoring pagination
         count_query = select(func.count()).select_from(query.subquery())
         return session.exec(count_query).one()
 
+    async def _count_total_async(self, query: Select, session: AsyncSession) -> int:
+        count_query = select(func.count()).select_from(query.subquery())
+        result = await session.exec(count_query)
+        return result.one()
+
     def _apply_filters(self, query: Select) -> Select:
         # Helper: build a map of column name -> column object from the select statement
         try:
@@ -152,7 +166,7 @@ class FSPManager:
             elif op == "like":
                 query = query.where(column.like(str(raw_value)))
             elif op == "not_like":
-                query = query.where(~column.like(str(raw_value)))
+                query = query.where(not_(column.like(str(raw_value))))
             elif op == "ilike":
                 pattern = str(raw_value)
                 if ilike_supported(column):
@@ -162,15 +176,15 @@ class FSPManager:
             elif op == "not_ilike":
                 pattern = str(raw_value)
                 if ilike_supported(column):
-                    query = query.where(~column.ilike(pattern))
+                    query = query.where(not_(column.ilike(pattern)))
                 else:
-                    query = query.where(~func.lower(column).like(pattern.lower()))
+                    query = query.where(not_(func.lower(column).like(pattern.lower())))
             elif op == "in":
                 vals = [coerce_value(column, v) for v in split_values(raw_value)]
                 query = query.where(column.in_(vals))
             elif op == "not_in":
                 vals = [coerce_value(column, v) for v in split_values(raw_value)]
-                query = query.where(~column.in_(vals))
+                query = query.where(not_(column.in_(vals)))
             elif op == "between":
                 vals = split_values(raw_value)
                 if len(vals) != 2:
@@ -185,13 +199,22 @@ class FSPManager:
                 query = query.where(column.is_not(None))
             elif op == "starts_with":
                 pattern = f"{str(raw_value)}%"
-                query = query.where(column.like(pattern))
+                if ilike_supported(column):
+                    query = query.where(column.ilike(pattern))
+                else:
+                    query = query.where(func.lower(column).like(pattern.lower()))
             elif op == "ends_with":
                 pattern = f"%{str(raw_value)}"
-                query = query.where(column.like(pattern))
+                if ilike_supported(column):
+                    query = query.where(column.ilike(pattern))
+                else:
+                    query = query.where(func.lower(column).like(pattern.lower()))
             elif op == "contains":
                 pattern = f"%{str(raw_value)}%"
-                query = query.where(column.like(pattern))
+                if ilike_supported(column):
+                    query = query.where(column.ilike(pattern))
+                else:
+                    query = query.where(func.lower(column).like(pattern.lower()))
             else:
                 # Unknown operator: skip
                 continue
@@ -221,7 +244,6 @@ class FSPManager:
 
     def generate_response(self, query: Select, session: Session) -> PaginatedResponse[Any]:
         query = self._apply_filters(query)
-
         query = self._apply_sort(query)
 
         total_items = self._count_total(query, session)
@@ -267,3 +289,53 @@ class FSPManager:
                 prev=prev_url,
             ),
         )
+
+    async def generate_response_async(
+        self, query: Select, session: AsyncSession
+    ) -> PaginatedResponse[Any]:
+        query = self._apply_filters(query)
+        query = self._apply_sort(query)
+
+        total_items = await self._count_total_async(query, session)
+        per_page = self.pagination.per_page
+        current_page = self.pagination.page
+        total_pages = max(1, math.ceil(total_items / per_page)) if total_items is not None else 1
+
+        data_page = await self.paginate_async(query, session)
+
+        # Build links based on current URL, replacing/adding page and per_page parameters
+        url = self.request.url
+        first_url = str(url.include_query_params(page=1, per_page=per_page))
+        last_url = str(url.include_query_params(page=total_pages, per_page=per_page))
+        next_url = (
+            str(url.include_query_params(page=current_page + 1, per_page=per_page))
+            if current_page < total_pages
+            else None
+        )
+        prev_url = (
+            str(url.include_query_params(page=current_page - 1, per_page=per_page))
+            if current_page > 1
+            else None
+        )
+        self_url = str(url.include_query_params(page=current_page, per_page=per_page))
+
+        return PaginatedResponse(
+            data=data_page,
+            meta=Meta(
+                pagination=Pagination(
+                    total_items=total_items,
+                    per_page=per_page,
+                    current_page=current_page,
+                    total_pages=total_pages,
+                ),
+                filters=self.filters,
+                sort=self.sorting,
+            ),
+            links=Links(
+                self=self_url,
+                first=first_url,
+                last=last_url,
+                next=next_url,
+                prev=prev_url,
+            ),
+        )

{fastapi_fsp-0.1.0 → fastapi_fsp-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "fastapi-fsp"
-version = "0.1.0"
+version = "0.1.1"
 description = "Filter, Sort, and Paginate (FSP) utilities for FastAPI + SQLModel"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -30,9 +30,9 @@ dependencies = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/your-org/fastapi-fsp"
-Repository = "https://github.com/your-org/fastapi-fsp"
-Issues = "https://github.com/your-org/fastapi-fsp/issues"
+Homepage = "https://github.com/fromej-dev/fastapi-fsp"
+Repository = "https://github.com/fromej-dev/fastapi-fsp"
+Issues = "https://github.com/fromej-dev/fastapi-fsp/issues"
 
 [dependency-groups]
 dev = [
@@ -44,6 +44,7 @@ dev = [
     "pytest-cov>=6.2.1",
     "pytest-mock>=3.14.1",
     "ruff>=0.5.0",
+    "pre-commit>=3.7.0",
 ]
 
 [tool.ruff]

fastapi_fsp-0.1.1/tests/conftest_async.py

@@ -0,0 +1,40 @@
+import asyncio
+from typing import AsyncGenerator
+
+import pytest
+from sqlalchemy.ext.asyncio import AsyncEngine, create_async_engine
+from sqlmodel import SQLModel
+from sqlmodel.ext.asyncio.session import AsyncSession
+from starlette.testclient import TestClient
+
+from tests.main_async import app, get_session
+
+
+@pytest.fixture(name="async_engine")
+def async_engine_fixture(tmp_path) -> AsyncGenerator[AsyncEngine, None]:
+    db_path = tmp_path / "test_async.db"
+    engine = create_async_engine(f"sqlite+aiosqlite:///{db_path}", echo=False)
+
+    async def _setup():
+        async with engine.begin() as conn:
+            await conn.run_sync(SQLModel.metadata.create_all)
+
+    asyncio.run(_setup())
+    try:
+        yield engine
+    finally:
+        asyncio.run(engine.dispose())
+
+
+@pytest.fixture(name="client_async")
+def client_async_fixture(async_engine: AsyncEngine):
+    async def _get_session() -> AsyncGenerator[AsyncSession, None]:
+        async with AsyncSession(async_engine, expire_on_commit=False) as session:
+            yield session
+
+    app.dependency_overrides[get_session] = _get_session
+    client = TestClient(app)
+    try:
+        yield client
+    finally:
+        app.dependency_overrides.clear()

fastapi_fsp-0.1.1/tests/main_async.py

@@ -0,0 +1,51 @@
+from contextlib import asynccontextmanager
+from typing import AsyncGenerator
+
+from fastapi import Depends, FastAPI
+from fastapi_fsp.fsp import FSPManager
+from fastapi_fsp.models import PaginatedResponse
+from sqlalchemy.ext.asyncio import create_async_engine
+from sqlmodel import SQLModel, select
+from sqlmodel.ext.asyncio.session import AsyncSession
+
+from tests.main import Hero, HeroPublic
+
+sqlite_file_name = "database.db"
+sqlite_url = f"sqlite+aiosqlite:///{sqlite_file_name}"
+
+connect_args = {"check_same_thread": False}
+engine = create_async_engine(sqlite_url, echo=True, connect_args=connect_args)
+
+
+async def create_db_and_tables():
+    async with engine.begin() as conn:
+        await conn.run_sync(SQLModel.metadata.create_all)
+
+
+async def get_session() -> AsyncGenerator[AsyncSession, None]:
+    async_session = AsyncSession(engine, expire_on_commit=False)
+    try:
+        yield async_session
+    finally:
+        await async_session.close()
+
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    # Code to run on startup
+    print("Creating database and tables...")
+    await create_db_and_tables()
+    yield
+    # Code to run on shutdown (if any)
+    print("Application shutdown.")
+
+
+app = FastAPI(lifespan=lifespan)
+
+
+@app.get("/heroes_async/", response_model=PaginatedResponse[HeroPublic])
+async def read_heroes_async(
+    *, session: AsyncSession = Depends(get_session), fsp: FSPManager = Depends(FSPManager)
+):
+    heroes = select(Hero)
+    return await fsp.generate_response_async(heroes, session)

fastapi_fsp-0.1.1/tests/test_fsp_async.py

@@ -0,0 +1,180 @@
+import asyncio
+
+from sqlalchemy.ext.asyncio import AsyncEngine
+from sqlmodel.ext.asyncio.session import AsyncSession
+from starlette.testclient import TestClient
+
+from tests.main_async import Hero
+
+pytest_plugins = ("tests.conftest_async",)
+
+
+async def _seed(async_engine: AsyncEngine):
+    async with AsyncSession(async_engine, expire_on_commit=False) as session:
+        session.add_all(
+            [
+                Hero(name="Deadpond", secret_name="Dive Wilson", age=None),
+                Hero(name="Rusty-Man", secret_name="Tommy Sharp", age=48),
+                Hero(name="ALPHA", secret_name="Alpha Secret", age=10),
+                Hero(name="beta", secret_name="Beta Secret", age=20),
+            ]
+        )
+        await session.commit()
+
+
+def test_async_full_operator_coverage(async_engine: AsyncEngine, client_async: TestClient):
+    asyncio.run(_seed(async_engine))
+
+    client = client_async
+
+    # Basic pagination
+    r = client.get("/heroes_async/?page=1&per_page=2")
+    assert r.status_code == 200
+    js = r.json()
+    assert len(js["data"]) == 2
+    assert js["meta"]["pagination"]["total_items"] == 4
+    assert js["links"]["self"].endswith("page=1&per_page=2")
+
+    # eq / ne
+    assert (
+        client.get("/heroes_async/?field=name&operator=eq&value=Deadpond").json()["data"][0]["name"]
+        == "Deadpond"
+    )
+    names_ne = [
+        h["name"]
+        for h in client.get("/heroes_async/?field=name&operator=ne&value=Deadpond").json()["data"]
+    ]
+    assert "Deadpond" not in names_ne
+
+    # gt / gte / lt / lte on age
+    assert set(
+        [
+            h["name"]
+            for h in client.get("/heroes_async/?field=age&operator=gt&value=15").json()["data"]
+        ]
+    ) == {"beta", "Rusty-Man"}
+    assert set(
+        [
+            h["name"]
+            for h in client.get("/heroes_async/?field=age&operator=gte&value=20").json()["data"]
+        ]
+    ) == {"Rusty-Man", "beta"}
+    assert [
+        h["name"]
+        for h in client.get("/heroes_async/?field=age&operator=lt&value=15").json()["data"]
+    ] == ["ALPHA"]
+    assert set(
+        [
+            h["name"]
+            for h in client.get("/heroes_async/?field=age&operator=lte&value=20").json()["data"]
+        ]
+    ) == {"ALPHA", "beta"}
+
+    # like / not_like (case-sensitive) on name
+    assert [
+        h["name"]
+        for h in client.get("/heroes_async/?field=name&operator=like&value=A%").json()["data"]
+    ] == ["ALPHA"]
+    not_like_a = [
+        h["name"]
+        for h in client.get("/heroes_async/?field=name&operator=not_like&value=A%").json()["data"]
+    ]
+    assert "ALPHA" not in not_like_a
+
+    # ilike / not_ilike (case-insensitive)
+    assert set(
+        [
+            h["name"]
+            for h in client.get("/heroes_async/?field=name&operator=ilike&value=a%").json()["data"]
+        ]
+    ) == {"ALPHA"}
+    not_ilike_beta = [
+        h["name"]
+        for h in client.get("/heroes_async/?field=name&operator=not_ilike&value=%eta").json()[
+            "data"
+        ]
+    ]
+    assert "beta" not in not_ilike_beta
+
+    # in / not_in
+    in_names = client.get("/heroes_async/?field=name&operator=in&value=Deadpond,ALPHA").json()[
+        "data"
+    ]
+    assert set([h["name"] for h in in_names]) == {"Deadpond", "ALPHA"}
+    not_in_names = client.get(
+        "/heroes_async/?field=name&operator=not_in&value=Deadpond,ALPHA"
+    ).json()["data"]
+    assert "Deadpond" not in [h["name"] for h in not_in_names]
+    assert "ALPHA" not in [h["name"] for h in not_in_names]
+
+    # between
+    between_ages = [
+        h["name"]
+        for h in client.get("/heroes_async/?field=age&operator=between&value=15,48").json()["data"]
+    ]
+    assert set(between_ages) == {"beta", "Rusty-Man"}
+
+    # is_null / is_not_null
+    assert [
+        h["name"]
+        for h in client.get("/heroes_async/?field=age&operator=is_null&value=").json()["data"]
+    ] == ["Deadpond"]
+    assert set(
+        [
+            h["name"]
+            for h in client.get("/heroes_async/?field=age&operator=is_not_null&value=").json()[
+                "data"
+            ]
+        ]
+    ) == {"ALPHA", "beta", "Rusty-Man"}
+
+    # starts_with / ends_with / contains (case-insensitive behavior via ilike fallback)
+    assert set(
+        [
+            h["name"]
+            for h in client.get("/heroes_async/?field=name&operator=starts_with&value=a").json()[
+                "data"
+            ]
+        ]
+    ) == {"ALPHA"}
+    assert set(
+        [
+            h["name"]
+            for h in client.get("/heroes_async/?field=name&operator=ends_with&value=a").json()[
+                "data"
+            ]
+        ]
+    ) == {"ALPHA", "beta"}
+    assert set(
+        [
+            h["name"]
+            for h in client.get("/heroes_async/?field=name&operator=contains&value=us").json()[
+                "data"
+            ]
+        ]
+    ) == {"Rusty-Man"}
+
+    # sort invalid column ignored
+    js = client.get("/heroes_async/?sort_by=unknown&order=asc").json()
+    assert js["meta"]["sort"] is not None  # request reflected
+
+    # malformed between should not filter out anything
+    names = [
+        h["name"]
+        for h in client.get("/heroes_async/?field=age&operator=between&value=10").json()["data"]
+    ]
+    assert set(names) == {"Deadpond", "Rusty-Man", "ALPHA", "beta"}
+
+    # unknown field filter ignored
+    names = [
+        h["name"]
+        for h in client.get("/heroes_async/?field=unknown&operator=eq&value=x").json()["data"]
+    ]
+    assert set(names) == {"Deadpond", "Rusty-Man", "ALPHA", "beta"}
+
+    # pagination validation errors (422) and mismatched filter params (400)
+    assert client.get("/heroes_async/?page=0").status_code == 422
+    assert client.get("/heroes_async/?per_page=101").status_code == 422
+    # mismatched: missing value
+    resp = client.get("/heroes_async/?field=name&operator=eq")
+    assert resp.status_code == 400

fastapi_fsp-0.1.1/tests/test_fsp_filters_sync.py

@@ -0,0 +1,144 @@
+from fastapi.testclient import TestClient
+from sqlmodel import Session
+
+from tests.main import Hero
+
+
+def seed(session: Session):
+    session.add_all(
+        [
+            Hero(name="Deadpond", secret_name="Dive Wilson", age=None),
+            Hero(name="Rusty-Man", secret_name="Tommy Sharp", age=48),
+            Hero(name="ALPHA", secret_name="Alpha Secret", age=10),
+            Hero(name="beta", secret_name="Beta Secret", age=20),
+        ]
+    )
+    session.commit()
+
+
+def test_full_operator_coverage_sync(session: Session, client: TestClient):
+    seed(session)
+
+    # Basic pagination
+    r = client.get("/heroes/?page=1&per_page=2")
+    assert r.status_code == 200
+    js = r.json()
+    assert len(js["data"]) == 2
+    assert js["meta"]["pagination"]["total_items"] == 4
+
+    # eq / ne
+    assert (
+        client.get("/heroes/?field=name&operator=eq&value=Deadpond").json()["data"][0]["name"]
+        == "Deadpond"
+    )
+    names_ne = [
+        h["name"]
+        for h in client.get("/heroes/?field=name&operator=ne&value=Deadpond").json()["data"]
+    ]
+    assert "Deadpond" not in names_ne
+
+    # gt / gte / lt / lte on age
+    assert set(
+        [h["name"] for h in client.get("/heroes/?field=age&operator=gt&value=15").json()["data"]]
+    ) == {"beta", "Rusty-Man"}
+    assert set(
+        [h["name"] for h in client.get("/heroes/?field=age&operator=gte&value=20").json()["data"]]
+    ) == {"Rusty-Man", "beta"}
+    assert [
+        h["name"] for h in client.get("/heroes/?field=age&operator=lt&value=15").json()["data"]
+    ] == ["ALPHA"]
+    assert set(
+        [h["name"] for h in client.get("/heroes/?field=age&operator=lte&value=20").json()["data"]]
+    ) == {"ALPHA", "beta"}
+
+    # like / not_like
+    assert [
+        h["name"] for h in client.get("/heroes/?field=name&operator=like&value=A%").json()["data"]
+    ] == ["ALPHA"]
+    not_like_a = [
+        h["name"]
+        for h in client.get("/heroes/?field=name&operator=not_like&value=A%").json()["data"]
+    ]
+    assert "ALPHA" not in not_like_a
+
+    # ilike / not_ilike
+    assert set(
+        [
+            h["name"]
+            for h in client.get("/heroes/?field=name&operator=ilike&value=a%").json()["data"]
+        ]
+    ) == {"ALPHA"}
+    not_ilike_beta = [
+        h["name"]
+        for h in client.get("/heroes/?field=name&operator=not_ilike&value=%eta").json()["data"]
+    ]
+    assert "beta" not in not_ilike_beta
+
+    # in / not_in
+    in_names = client.get("/heroes/?field=name&operator=in&value=Deadpond,ALPHA").json()["data"]
+    assert set([h["name"] for h in in_names]) == {"Deadpond", "ALPHA"}
+    not_in_names = client.get("/heroes/?field=name&operator=not_in&value=Deadpond,ALPHA").json()[
+        "data"
+    ]
+    assert "Deadpond" not in [h["name"] for h in not_in_names]
+    assert "ALPHA" not in [h["name"] for h in not_in_names]
+
+    # between
+    between_ages = [
+        h["name"]
+        for h in client.get("/heroes/?field=age&operator=between&value=15,48").json()["data"]
+    ]
+    assert set(between_ages) == {"beta", "Rusty-Man"}
+
+    # is_null / is_not_null
+    assert [
+        h["name"] for h in client.get("/heroes/?field=age&operator=is_null&value=").json()["data"]
+    ] == ["Deadpond"]
+    assert set(
+        [
+            h["name"]
+            for h in client.get("/heroes/?field=age&operator=is_not_null&value=").json()["data"]
+        ]
+    ) == {"ALPHA", "beta", "Rusty-Man"}
+
+    # starts_with / ends_with / contains
+    assert set(
+        [
+            h["name"]
+            for h in client.get("/heroes/?field=name&operator=starts_with&value=a").json()["data"]
+        ]
+    ) == {"ALPHA"}
+    assert set(
+        [
+            h["name"]
+            for h in client.get("/heroes/?field=name&operator=ends_with&value=a").json()["data"]
+        ]
+    ) == {"ALPHA", "beta"}
+    assert set(
+        [
+            h["name"]
+            for h in client.get("/heroes/?field=name&operator=contains&value=us").json()["data"]
+        ]
+    ) == {"Rusty-Man"}
+
+    # sort invalid column ignored (should not error)
+    js = client.get("/heroes/?sort_by=unknown&order=asc").json()
+    assert js["meta"]["sort"] is not None
+
+    # malformed between should not filter
+    names = [
+        h["name"] for h in client.get("/heroes/?field=age&operator=between&value=10").json()["data"]
+    ]
+    assert set(names) == {"Deadpond", "Rusty-Man", "ALPHA", "beta"}
+
+    # unknown field filter ignored
+    names = [
+        h["name"] for h in client.get("/heroes/?field=unknown&operator=eq&value=x").json()["data"]
+    ]
+    assert set(names) == {"Deadpond", "Rusty-Man", "ALPHA", "beta"}
+
+    # validation and failure scenarios
+    assert client.get("/heroes/?page=0").status_code == 422
+    assert client.get("/heroes/?per_page=101").status_code == 422
+    # mismatched filter params -> 400
+    assert client.get("/heroes/?field=name&operator=eq").status_code == 400

{fastapi_fsp-0.1.0 → fastapi_fsp-0.1.1}/uv.lock

@@ -60,6 +60,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/e5/48/1549795ba7742c948d2ad169c1c8cdbae65bc450d6cd753d124b17c8cd32/certifi-2025.8.3-py3-none-any.whl", hash = "sha256:f6c12493cfb1b06ba2ff328595af9350c65d6644968e5d3a2ffd78699af217a5", size = 161216, upload-time = "2025-08-03T03:07:45.777Z" },
 ]
 
+[[package]]
+name = "cfgv"
+version = "3.4.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/11/74/539e56497d9bd1d484fd863dd69cbbfa653cd2aa27abfe35653494d85e94/cfgv-3.4.0.tar.gz", hash = "sha256:e52591d4c5f5dead8e0f673fb16db7949d2cfb3f7da4582893288f0ded8fe560", size = 7114, upload-time = "2023-08-12T20:38:17.776Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c5/55/51844dd50c4fc7a33b653bfaba4c2456f06955289ca770a5dbd5fd267374/cfgv-3.4.0-py2.py3-none-any.whl", hash = "sha256:b7265b1f29fd3316bfcd2b330d63d024f2bfd8bcb8b0272f8e19a504856c48f9", size = 7249, upload-time = "2023-08-12T20:38:16.269Z" },
+]
+
 [[package]]
 name = "colorama"
 version = "0.4.6"
@@ -133,6 +142,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/bb/78/983efd23200921d9edb6bd40512e1aa04af553d7d5a171e50f9b2b45d109/coverage-7.10.4-py3-none-any.whl", hash = "sha256:065d75447228d05121e5c938ca8f0e91eed60a1eb2d1258d42d5084fecfc3302", size = 208365, upload-time = "2025-08-17T00:26:41.479Z" },
 ]
 
+[[package]]
+name = "distlib"
+version = "0.4.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/96/8e/709914eb2b5749865801041647dc7f4e6d00b549cfe88b65ca192995f07c/distlib-0.4.0.tar.gz", hash = "sha256:feec40075be03a04501a973d81f633735b4b69f98b05450592310c0f401a4e0d", size = 614605, upload-time = "2025-07-17T16:52:00.465Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/33/6b/e0547afaf41bf2c42e52430072fa5658766e3d65bd4b03a563d1b6336f57/distlib-0.4.0-py2.py3-none-any.whl", hash = "sha256:9659f7d87e46584a30b5780e43ac7a2143098441670ff0a49d5f9034c54a6c16", size = 469047, upload-time = "2025-07-17T16:51:58.613Z" },
+]
+
 [[package]]
 name = "fastapi"
 version = "0.116.1"
@@ -149,7 +167,7 @@ wheels = [
 
 [[package]]
 name = "fastapi-fsp"
-version = "0.1.0"
+version = "0.1.1"
 source = { editable = "." }
 dependencies = [
     { name = "fastapi" },
@@ -161,6 +179,7 @@ dev = [
     { name = "aiosqlite" },
     { name = "build" },
     { name = "httpx" },
+    { name = "pre-commit" },
     { name = "pytest" },
     { name = "pytest-asyncio" },
     { name = "pytest-cov" },
@@ -179,6 +198,7 @@ dev = [
     { name = "aiosqlite", specifier = ">=0.21.0" },
     { name = "build", specifier = ">=1.3.0" },
     { name = "httpx", specifier = ">=0.28.1" },
+    { name = "pre-commit", specifier = ">=3.7.0" },
     { name = "pytest", specifier = ">=8.4.1" },
     { name = "pytest-asyncio", specifier = ">=1.1.0" },
     { name = "pytest-cov", specifier = ">=6.2.1" },
@@ -186,6 +206,15 @@ dev = [
     { name = "ruff", specifier = ">=0.5.0" },
 ]
 
+[[package]]
+name = "filelock"
+version = "3.19.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/40/bb/0ab3e58d22305b6f5440629d20683af28959bf793d98d11950e305c1c326/filelock-3.19.1.tar.gz", hash = "sha256:66eda1888b0171c998b35be2bcc0f6d75c388a7ce20c3f3f37aa8e96c2dddf58", size = 17687, upload-time = "2025-08-14T16:56:03.016Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/42/14/42b2651a2f46b022ccd948bca9f2d5af0fd8929c4eec235b8d6d844fbe67/filelock-3.19.1-py3-none-any.whl", hash = "sha256:d38e30481def20772f5baf097c122c3babc4fcdb7e14e57049eb9d88c6dc017d", size = 15988, upload-time = "2025-08-14T16:56:01.633Z" },
+]
+
 [[package]]
 name = "greenlet"
 version = "3.2.4"
@@ -256,6 +285,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
 ]
 
+[[package]]
+name = "identify"
+version = "2.6.13"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/82/ca/ffbabe3635bb839aa36b3a893c91a9b0d368cb4d8073e03a12896970af82/identify-2.6.13.tar.gz", hash = "sha256:da8d6c828e773620e13bfa86ea601c5a5310ba4bcd65edf378198b56a1f9fb32", size = 99243, upload-time = "2025-08-09T19:35:00.6Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e7/ce/461b60a3ee109518c055953729bf9ed089a04db895d47e95444071dcdef2/identify-2.6.13-py2.py3-none-any.whl", hash = "sha256:60381139b3ae39447482ecc406944190f690d4a2997f2584062089848361b33b", size = 99153, upload-time = "2025-08-09T19:34:59.1Z" },
+]
+
 [[package]]
 name = "idna"
 version = "3.10"
@@ -274,6 +312,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/2c/e1/e6716421ea10d38022b952c159d5161ca1193197fb744506875fbb87ea7b/iniconfig-2.1.0-py3-none-any.whl", hash = "sha256:9deba5723312380e77435581c6bf4935c94cbfab9b1ed33ef8d238ea168eb760", size = 6050, upload-time = "2025-03-19T20:10:01.071Z" },
 ]
 
+[[package]]
+name = "nodeenv"
+version = "1.9.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/43/16/fc88b08840de0e0a72a2f9d8c6bae36be573e475a6326ae854bcc549fc45/nodeenv-1.9.1.tar.gz", hash = "sha256:6ec12890a2dab7946721edbfbcd91f3319c6ccc9aec47be7c7e6b7011ee6645f", size = 47437, upload-time = "2024-06-04T18:44:11.171Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d2/1d/1b658dbd2b9fa9c4c9f32accbfc0205d532c8c6194dc0f2a4c0428e7128a/nodeenv-1.9.1-py2.py3-none-any.whl", hash = "sha256:ba11c9782d29c27c70ffbdda2d7415098754709be8a7056d79a737cd901155c9", size = 22314, upload-time = "2024-06-04T18:44:08.352Z" },
+]
+
 [[package]]
 name = "packaging"
 version = "25.0"
@@ -283,6 +330,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/20/12/38679034af332785aac8774540895e234f4d07f7545804097de4b666afd8/packaging-25.0-py3-none-any.whl", hash = "sha256:29572ef2b1f17581046b3a2227d5c611fb25ec70ca1ba8554b24b0e69331a484", size = 66469, upload-time = "2025-04-19T11:48:57.875Z" },
 ]
 
+[[package]]
+name = "platformdirs"
+version = "4.3.8"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/fe/8b/3c73abc9c759ecd3f1f7ceff6685840859e8070c4d947c93fae71f6a0bf2/platformdirs-4.3.8.tar.gz", hash = "sha256:3d512d96e16bcb959a814c9f348431070822a6496326a4be0911c40b5a74c2bc", size = 21362, upload-time = "2025-05-07T22:47:42.121Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/fe/39/979e8e21520d4e47a0bbe349e2713c0aac6f3d853d0e5b34d76206c439aa/platformdirs-4.3.8-py3-none-any.whl", hash = "sha256:ff7059bb7eb1179e2685604f4aaf157cfd9535242bd23742eadc3c13542139b4", size = 18567, upload-time = "2025-05-07T22:47:40.376Z" },
+]
+
 [[package]]
 name = "pluggy"
 version = "1.6.0"
@@ -292,6 +348,22 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
 ]
 
+[[package]]
+name = "pre-commit"
+version = "4.3.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cfgv" },
+    { name = "identify" },
+    { name = "nodeenv" },
+    { name = "pyyaml" },
+    { name = "virtualenv" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/ff/29/7cf5bbc236333876e4b41f56e06857a87937ce4bf91e117a6991a2dbb02a/pre_commit-4.3.0.tar.gz", hash = "sha256:499fe450cc9d42e9d58e606262795ecb64dd05438943c62b66f6a8673da30b16", size = 193792, upload-time = "2025-08-09T18:56:14.651Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5b/a5/987a405322d78a73b66e39e4a90e4ef156fd7141bf71df987e50717c321b/pre_commit-4.3.0-py2.py3-none-any.whl", hash = "sha256:2b0747ad7e6e967169136edffee14c16e148a778a54e4f967921aa1ebf2308d8", size = 220965, upload-time = "2025-08-09T18:56:13.192Z" },
+]
+
 [[package]]
 name = "pydantic"
 version = "2.11.7"
@@ -421,6 +493,32 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/b2/05/77b60e520511c53d1c1ca75f1930c7dd8e971d0c4379b7f4b3f9644685ba/pytest_mock-3.14.1-py3-none-any.whl", hash = "sha256:178aefcd11307d874b4cd3100344e7e2d888d9791a6a1d9bfe90fbc1b74fd1d0", size = 9923, upload-time = "2025-05-26T13:58:43.487Z" },
 ]
 
+[[package]]
+name = "pyyaml"
+version = "6.0.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/54/ed/79a089b6be93607fa5cdaedf301d7dfb23af5f25c398d5ead2525b063e17/pyyaml-6.0.2.tar.gz", hash = "sha256:d584d9ec91ad65861cc08d42e834324ef890a082e591037abe114850ff7bbc3e", size = 130631, upload-time = "2024-08-06T20:33:50.674Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/86/0c/c581167fc46d6d6d7ddcfb8c843a4de25bdd27e4466938109ca68492292c/PyYAML-6.0.2-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:c70c95198c015b85feafc136515252a261a84561b7b1d51e3384e0655ddf25ab", size = 183873, upload-time = "2024-08-06T20:32:25.131Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/0c/38374f5bb272c051e2a69281d71cba6fdb983413e6758b84482905e29a5d/PyYAML-6.0.2-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:ce826d6ef20b1bc864f0a68340c8b3287705cae2f8b4b1d932177dcc76721725", size = 173302, upload-time = "2024-08-06T20:32:26.511Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/93/9916574aa8c00aa06bbac729972eb1071d002b8e158bd0e83a3b9a20a1f7/PyYAML-6.0.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:1f71ea527786de97d1a0cc0eacd1defc0985dcf6b3f17bb77dcfc8c34bec4dc5", size = 739154, upload-time = "2024-08-06T20:32:28.363Z" },
+    { url = "https://files.pythonhosted.org/packages/95/0f/b8938f1cbd09739c6da569d172531567dbcc9789e0029aa070856f123984/PyYAML-6.0.2-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9b22676e8097e9e22e36d6b7bda33190d0d400f345f23d4065d48f4ca7ae0425", size = 766223, upload-time = "2024-08-06T20:32:30.058Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/2b/614b4752f2e127db5cc206abc23a8c19678e92b23c3db30fc86ab731d3bd/PyYAML-6.0.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:80bab7bfc629882493af4aa31a4cfa43a4c57c83813253626916b8c7ada83476", size = 767542, upload-time = "2024-08-06T20:32:31.881Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/00/dd137d5bcc7efea1836d6264f049359861cf548469d18da90cd8216cf05f/PyYAML-6.0.2-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:0833f8694549e586547b576dcfaba4a6b55b9e96098b36cdc7ebefe667dfed48", size = 731164, upload-time = "2024-08-06T20:32:37.083Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/1f/4f998c900485e5c0ef43838363ba4a9723ac0ad73a9dc42068b12aaba4e4/PyYAML-6.0.2-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:8b9c7197f7cb2738065c481a0461e50ad02f18c78cd75775628afb4d7137fb3b", size = 756611, upload-time = "2024-08-06T20:32:38.898Z" },
+    { url = "https://files.pythonhosted.org/packages/df/d1/f5a275fdb252768b7a11ec63585bc38d0e87c9e05668a139fea92b80634c/PyYAML-6.0.2-cp312-cp312-win32.whl", hash = "sha256:ef6107725bd54b262d6dedcc2af448a266975032bc85ef0172c5f059da6325b4", size = 140591, upload-time = "2024-08-06T20:32:40.241Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/e8/4f648c598b17c3d06e8753d7d13d57542b30d56e6c2dedf9c331ae56312e/PyYAML-6.0.2-cp312-cp312-win_amd64.whl", hash = "sha256:7e7401d0de89a9a855c839bc697c079a4af81cf878373abd7dc625847d25cbd8", size = 156338, upload-time = "2024-08-06T20:32:41.93Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/e3/3af305b830494fa85d95f6d95ef7fa73f2ee1cc8ef5b495c7c3269fb835f/PyYAML-6.0.2-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:efdca5630322a10774e8e98e1af481aad470dd62c3170801852d752aa7a783ba", size = 181309, upload-time = "2024-08-06T20:32:43.4Z" },
+    { url = "https://files.pythonhosted.org/packages/45/9f/3b1c20a0b7a3200524eb0076cc027a970d320bd3a6592873c85c92a08731/PyYAML-6.0.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:50187695423ffe49e2deacb8cd10510bc361faac997de9efef88badc3bb9e2d1", size = 171679, upload-time = "2024-08-06T20:32:44.801Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/9a/337322f27005c33bcb656c655fa78325b730324c78620e8328ae28b64d0c/PyYAML-6.0.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0ffe8360bab4910ef1b9e87fb812d8bc0a308b0d0eef8c8f44e0254ab3b07133", size = 733428, upload-time = "2024-08-06T20:32:46.432Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/69/864fbe19e6c18ea3cc196cbe5d392175b4cf3d5d0ac1403ec3f2d237ebb5/PyYAML-6.0.2-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:17e311b6c678207928d649faa7cb0d7b4c26a0ba73d41e99c4fff6b6c3276484", size = 763361, upload-time = "2024-08-06T20:32:51.188Z" },
+    { url = "https://files.pythonhosted.org/packages/04/24/b7721e4845c2f162d26f50521b825fb061bc0a5afcf9a386840f23ea19fa/PyYAML-6.0.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:70b189594dbe54f75ab3a1acec5f1e3faa7e8cf2f1e08d9b561cb41b845f69d5", size = 759523, upload-time = "2024-08-06T20:32:53.019Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/b2/e3234f59ba06559c6ff63c4e10baea10e5e7df868092bf9ab40e5b9c56b6/PyYAML-6.0.2-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:41e4e3953a79407c794916fa277a82531dd93aad34e29c2a514c2c0c5fe971cc", size = 726660, upload-time = "2024-08-06T20:32:54.708Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/0f/25911a9f080464c59fab9027482f822b86bf0608957a5fcc6eaac85aa515/PyYAML-6.0.2-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:68ccc6023a3400877818152ad9a1033e3db8625d899c72eacb5a668902e4d652", size = 751597, upload-time = "2024-08-06T20:32:56.985Z" },
+    { url = "https://files.pythonhosted.org/packages/14/0d/e2c3b43bbce3cf6bd97c840b46088a3031085179e596d4929729d8d68270/PyYAML-6.0.2-cp313-cp313-win32.whl", hash = "sha256:bc2fa7c6b47d6bc618dd7fb02ef6fdedb1090ec036abab80d4681424b84c1183", size = 140527, upload-time = "2024-08-06T20:33:03.001Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/de/02b54f42487e3d3c6efb3f89428677074ca7bf43aae402517bc7cca949f3/PyYAML-6.0.2-cp313-cp313-win_amd64.whl", hash = "sha256:8388ee1976c416731879ac16da0aff3f63b286ffdd57cdeb95f3f2e085687563", size = 156446, upload-time = "2024-08-06T20:33:04.33Z" },
+]
+
 [[package]]
 name = "ruff"
 version = "0.12.9"
@@ -531,3 +629,17 @@ sdist = { url = "https://files.pythonhosted.org/packages/f8/b1/0c11f5058406b3af7
 wheels = [
     { url = "https://files.pythonhosted.org/packages/17/69/cd203477f944c353c31bade965f880aa1061fd6bf05ded0726ca845b6ff7/typing_inspection-0.4.1-py3-none-any.whl", hash = "sha256:389055682238f53b04f7badcb49b989835495a96700ced5dab2d8feae4b26f51", size = 14552, upload-time = "2025-05-21T18:55:22.152Z" },
 ]
+
+[[package]]
+name = "virtualenv"
+version = "20.34.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "distlib" },
+    { name = "filelock" },
+    { name = "platformdirs" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/1c/14/37fcdba2808a6c615681cd216fecae00413c9dab44fb2e57805ecf3eaee3/virtualenv-20.34.0.tar.gz", hash = "sha256:44815b2c9dee7ed86e387b842a84f20b93f7f417f95886ca1996a72a4138eb1a", size = 6003808, upload-time = "2025-08-13T14:24:07.464Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/76/06/04c8e804f813cf972e3262f3f8584c232de64f0cde9f703b46cf53a45090/virtualenv-20.34.0-py3-none-any.whl", hash = "sha256:341f5afa7eee943e4984a9207c025feedd768baff6753cd660c857ceb3e36026", size = 5983279, upload-time = "2025-08-13T14:24:05.111Z" },
+]