feat: ✨ add params decoder

.pre-commit-config.yaml

@@ -6,7 +6,7 @@ repos:
     -   id: trailing-whitespace
     -   id: requirements-txt-fixer
 -   repo: https://github.com/charliermarsh/ruff-pre-commit
-    rev: v0.13.2
+    rev: v0.14.5
     hooks:
     -   id: ruff
         args:

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "jetpack"
-version = "0.2.0"
+version = "0.2.1"
 description = "Project Utilities to kickstart a micro-service."
 readme = "README.md"
 authors = [
@@ -10,6 +10,7 @@ authors = [
 requires-python = ">=3.13"
 dependencies = [
     "asgi-correlation-id>=4.3.4",
+    "orjson>=3.11.4",
     "pydantic>=2.10.3",
     "pydantic-settings>=2.7.0",
     "whenever>=0.6.15",

src/jetpack/utils/parse_utils.py

@@ -0,0 +1,30 @@
+from typing import Annotated, Any, Callable
+
+from fastapi.params import Query
+import orjson
+
+
+class _ParamsDecoder:
+    def __call__(
+        self,
+        model: Callable = dict,
+        description: str = "Stringified JSON",
+        default: Any = None,
+    ) -> Callable:
+        json_schema_extra = {} if model == dict else model.model_json_schema()  # noqa
+
+        def param_decoder(
+            params: Annotated[
+                str, Query(json_schema_extra=json_schema_extra, description=description)
+            ] = default,
+        ) -> Any:
+            if not params:
+                return default
+            return model(**orjson.loads(params.strip("'\\").encode()))
+
+        return param_decoder
+
+
+ParamsDecoder = _ParamsDecoder()
+
+__all__ = ["ParamsDecoder"]