openadmin-dev 0.3.0__py3-none-any.whl → 0.4.0__py3-none-any.whl

openadmin/fastapi/__init__.py

@@ -4,8 +4,6 @@
 
 from .admin_page import AdminPage
 from .admin_panel import AdminPanel
+from .deps import PageDep, SearchQueryDep
 
-__all__ = [
-    "AdminPage",
-    "AdminPanel",
-]
+__all__ = ["AdminPage", "AdminPanel", "PageDep", "SearchQueryDep"]

openadmin/fastapi/deps.py

@@ -0,0 +1,26 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from typing import Annotated
+
+from fastapi import Depends, Query
+
+from .types import PaginationParams
+
+
+def pagination_params(
+    page: int = Query(default=0, ge=0, description="Page number"),
+    per_page: int = Query(default=10, ge=1, description="Number of items per page"),
+) -> PaginationParams:
+    return PaginationParams(page=page, per_page=per_page)
+
+
+def get_search_query(
+    search: str | None = Query(None, min_length=1, description="Search query"),
+) -> str | None:
+    return search
+
+
+PageDep = Annotated[PaginationParams, Depends(pagination_params)]
+SearchQueryDep = Annotated[str | None, Depends(get_search_query)]

openadmin/fastapi/types/__init__.py

@@ -11,6 +11,7 @@ from .form import Form
 from .line_chart import LineChart
 from .markdown import Markdown
 from .page_protocol import PageProtocol
+from .pagination_params import PaginationParams
 from .pie_chart import PieChart
 from .section import Section
 from .stat import Stat
@@ -33,4 +34,5 @@ __all__ = [
     "PieChart",
     "Component",
     "Markdown",
+    "PaginationParams",
 ]

openadmin/fastapi/types/action.py

@@ -3,18 +3,16 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
 from collections.abc import Callable
-
-from pydantic import BaseModel, ConfigDict
+from dataclasses import dataclass, field
 
 from openadmin import spec
 
 
-class Action(BaseModel):
-    model_config = ConfigDict(arbitrary_types_allowed=True)
-
+@dataclass
+class Action:
     function_name: str
     name: str
     description: str | None
     method: spec.HttpMethod
     is_hidden: bool
-    func: Callable | None = None
+    func: Callable | None = field(default=None)

openadmin/fastapi/types/area_chart.py

@@ -3,17 +3,15 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
 from collections.abc import Callable
-
-from pydantic import BaseModel, ConfigDict
+from dataclasses import dataclass, field
 
 from openadmin import spec
 
 
-class AreaChart(BaseModel):
-    model_config = ConfigDict(arbitrary_types_allowed=True)
-
+@dataclass
+class AreaChart:
     function_name: str
     name: str
     description: str | None
     method: spec.HttpMethod
-    func: Callable | None = None
+    func: Callable | None = field(default=None)

openadmin/fastapi/types/bar_chart.py

@@ -3,17 +3,15 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
 from collections.abc import Callable
-
-from pydantic import BaseModel, ConfigDict
+from dataclasses import dataclass, field
 
 from openadmin import spec
 
 
-class BarChart(BaseModel):
-    model_config = ConfigDict(arbitrary_types_allowed=True)
-
+@dataclass
+class BarChart:
     function_name: str
     name: str
     description: str | None
     method: spec.HttpMethod
-    func: Callable | None = None
+    func: Callable | None = field(default=None)

openadmin/fastapi/types/form.py

@@ -3,18 +3,16 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
 from collections.abc import Callable
-
-from pydantic import BaseModel, ConfigDict
+from dataclasses import dataclass, field
 
 from openadmin import spec
 
 
-class Form(BaseModel):
-    model_config = ConfigDict(arbitrary_types_allowed=True)
-
+@dataclass
+class Form:
     function_name: str
     name: str
     description: str | None
     method: spec.HttpMethod
     is_hiden: bool
-    func: Callable | None = None
+    func: Callable | None = field(default=None)

openadmin/fastapi/types/line_chart.py

@@ -3,17 +3,15 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
 from collections.abc import Callable
-
-from pydantic import BaseModel, ConfigDict
+from dataclasses import dataclass, field
 
 from openadmin import spec
 
 
-class LineChart(BaseModel):
-    model_config = ConfigDict(arbitrary_types_allowed=True)
-
+@dataclass
+class LineChart:
     function_name: str
     name: str
     description: str | None
     method: spec.HttpMethod
-    func: Callable | None = None
+    func: Callable | None = field(default=None)

openadmin/fastapi/types/markdown.py

@@ -3,17 +3,15 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
 from collections.abc import Callable
-
-from pydantic import BaseModel, ConfigDict
+from dataclasses import dataclass, field
 
 from openadmin import spec
 
 
-class Markdown(BaseModel):
-    model_config = ConfigDict(arbitrary_types_allowed=True)
-
+@dataclass
+class Markdown:
     function_name: str
     name: str
     description: str | None
     method: spec.HttpMethod
-    func: Callable | None = None
+    func: Callable | None = field(default=None)

openadmin/fastapi/types/pagination_params.py

@@ -0,0 +1,10 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from pydantic import BaseModel
+
+
+class PaginationParams(BaseModel):
+    page: int
+    per_page: int

openadmin/fastapi/types/pie_chart.py

@@ -3,17 +3,15 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
 from collections.abc import Callable
-
-from pydantic import BaseModel, ConfigDict
+from dataclasses import dataclass, field
 
 from openadmin import spec
 
 
-class PieChart(BaseModel):
-    model_config = ConfigDict(arbitrary_types_allowed=True)
-
+@dataclass
+class PieChart:
     function_name: str
     name: str
     description: str | None
     method: spec.HttpMethod
-    func: Callable | None = None
+    func: Callable | None = field(default=None)

openadmin/fastapi/types/stat.py

@@ -3,17 +3,15 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
 from collections.abc import Callable
-
-from pydantic import BaseModel, ConfigDict
+from dataclasses import dataclass, field
 
 from openadmin import spec
 
 
-class Stat(BaseModel):
-    model_config = ConfigDict(arbitrary_types_allowed=True)
-
+@dataclass
+class Stat:
     function_name: str
     method: spec.HttpMethod
     name: str
     description: str | None
-    func: Callable | None = None
+    func: Callable | None = field(default=None)

openadmin/fastapi/types/table.py

@@ -3,17 +3,15 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
 from collections.abc import Callable
-
-from pydantic import BaseModel, ConfigDict
+from dataclasses import dataclass, field
 
 from openadmin import spec
 
 
-class Table(BaseModel):
-    model_config = ConfigDict(arbitrary_types_allowed=True)
-
+@dataclass
+class Table:
     function_name: str
     method: spec.HttpMethod
     name: str
     description: str | None
-    func: Callable | None = None
+    func: Callable | None = field(default=None)

openadmin/fastapi/utils.py

@@ -8,6 +8,7 @@ from typing import Annotated, get_args, get_origin, get_type_hints
 import pydantic
 
 from fastapi.params import Body as BodyParam
+from fastapi.params import Depends as DependsParam
 from fastapi.params import Form as FormParam
 from fastapi.params import Query as QueryParam
 from openadmin import spec
@@ -131,10 +132,14 @@ def extract_params(
         marker = None
         actual_type = annotation
 
+        depends_marker = None
         if get_origin(annotation) is Annotated:
             args = get_args(annotation)
             actual_type = args[0]
             for arg in args[1:]:
+                if isinstance(arg, DependsParam):
+                    depends_marker = arg
+                    break
                 if isinstance(arg, (QueryParam, BodyParam, FormParam)):
                     marker = arg
                     break
@@ -142,6 +147,18 @@ def extract_params(
         if marker is None and isinstance(default, (QueryParam, BodyParam, FormParam)):
             marker = default
 
+        if depends_marker is not None:
+            dep_fn = depends_marker.dependency
+            if callable(dep_fn):
+                dep_query, dep_body, dep_form = extract_params(dep_fn)
+                if dep_query:
+                    query.extend(dep_query)
+                if dep_body:
+                    body.extend(dep_body)
+                if dep_form:
+                    form.extend(dep_form)
+            continue
+
         # FormParam must be checked before BodyParam — Form is a subclass of Body
         if isinstance(marker, QueryParam):
             query.append(_make_property(param_name, actual_type, marker))

{openadmin_dev-0.3.0.dist-info → openadmin_dev-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openadmin-dev
-Version: 0.3.0
+Version: 0.4.0
 Summary: Add your description here
 Project-URL: Homepage, https://github.com/openadmin-team/openadmin-py
 Project-URL: Issues, https://github.com/openadmin-team/openadmin-py/issues
@@ -27,7 +27,7 @@ Description-Content-Type: text/markdown
 # 🚧 Project is under development 🚧
 ---
 
-**OpenAdmin** is a FastAPI-native library for building admin dashboards. Define pages with typed decorators — no frontend code, no templates, no configuration files. Every page is just a router; every widget is just an endpoint.
+**OpenAdmin** is a FastAPI-native library for building admin dashboards. Define pages with typed decorators — no frontend code, no templates, no configuration files. Every page is just a router; every widget is just an endpoint
 
 ## Features
 

{openadmin_dev-0.3.0.dist-info → openadmin_dev-0.4.0.dist-info}/RECORD

@@ -1,19 +1,21 @@
-openadmin/fastapi/__init__.py,sha256=RiqYntBCCLt9snCMc3D-h3Y-1mTrqc9lHNmkFIjw9FI,209
+openadmin/fastapi/__init__.py,sha256=ssQtgZVSRIZfh7I2mpsj2wdlUryjPoEB3sLwDmMVv5I,269
 openadmin/fastapi/admin_page.py,sha256=kwEBjxB9iso6mtJmm41goEY-a8RTuF6fcDMzEq0Fk1E,15478
 openadmin/fastapi/admin_panel.py,sha256=LzpEjIL17Xxf1rXq4e6W2pzG9SErdlFB8NjQxEj7lys,2609
-openadmin/fastapi/utils.py,sha256=eleWv0kWZgndSJI2vFTR3C4vlNabL0Nxz1QnuxP6XhA,5180
-openadmin/fastapi/types/__init__.py,sha256=VQRRr668R0npyVWYvDSKXoAx4JHbutynHUqOdgEX34E,754
-openadmin/fastapi/types/action.py,sha256=MzFtamoavThIXrFkujBJMntZkJGv4JT5IrqOt_Blaxg,432
-openadmin/fastapi/types/area_chart.py,sha256=aoLAR6oWSI3vw14zGxRKlnlrnxJLqDDYI8BCk8oOAM8,415
-openadmin/fastapi/types/bar_chart.py,sha256=Gl9n93moh7sfFPf4CvZLmjLEuWjy5AdQaOWFi06ACPU,414
-openadmin/fastapi/types/form.py,sha256=0Ww-7vrFJP9c5J1_oGbug3fDzrWXOp7M3pYC9LRuhAo,429
-openadmin/fastapi/types/line_chart.py,sha256=OWYhEXHPFob-SPnu7shz6Zqf5x1NlqEUt__YW1Gc4jc,415
-openadmin/fastapi/types/markdown.py,sha256=2g8uX_n2Shx-6r8ukehv9LMA4iD6i7ynuph65gRgFaQ,414
+openadmin/fastapi/deps.py,sha256=WJzO6zahevIPqAollimsha-2bRF5es-UcaXzllfkktM,722
+openadmin/fastapi/utils.py,sha256=IPG2uSJSe8AeIW4iYSLrMx_8DoDiMr3z_dzG1Gxr4wo,5806
+openadmin/fastapi/types/__init__.py,sha256=v9OMUIeYzS6NNVRqQJQUNCim6Hd8Zi0hbqqssTCrCWw,826
+openadmin/fastapi/types/action.py,sha256=gfGQDHAey8ldg7JIUXFLqidiCmsEfBmYO0H-TRtRsTo,383
+openadmin/fastapi/types/area_chart.py,sha256=gRb3N-XgBJZwYMMQ-uvhdCCeIrQT0fmf6CFLAcQ0DRQ,366
+openadmin/fastapi/types/bar_chart.py,sha256=ZHnK8oE3s0YSWXYwTyh-hziXgiIH5SvL2L1-0DKJMkg,365
+openadmin/fastapi/types/form.py,sha256=tq6J3zdWT_S4y_j8UwclLqx2k8eYWhPmAht_E_1YCE0,380
+openadmin/fastapi/types/line_chart.py,sha256=61Igaw_3_S65ZQZctrfLADZEo9rKhWH9iVUwOfhAc0M,366
+openadmin/fastapi/types/markdown.py,sha256=iXTkZX4_L_-zCAWA7F6j5h0YR6BYjbl4tL6BPpfO0-g,365
 openadmin/fastapi/types/page_protocol.py,sha256=zMio8SamTFO6_Dxp_8_xnErTC6VEfryVtW_5jOM6oDw,265
-openadmin/fastapi/types/pie_chart.py,sha256=MYp1mg7YlEgAA4RiPaz0g-0ynlSRflPc4nZz85soG2M,414
+openadmin/fastapi/types/pagination_params.py,sha256=oVI5VkYYwqpZkJBErQTCbDzGgvjRJFY0rl50rbWII5g,189
+openadmin/fastapi/types/pie_chart.py,sha256=oUpOpCrgsnhsr742f10W3MoVQvtchsDJktLvmEuOLMk,365
 openadmin/fastapi/types/section.py,sha256=oWo5caUkLrdmvXnc3pdCC3cwLk8iMT4slrH5GnxI0E8,296
-openadmin/fastapi/types/stat.py,sha256=fWit9vyIEkVzkf3IxkV73lAtttxgPfWOMfsVQDP44q8,410
-openadmin/fastapi/types/table.py,sha256=JzYkV8zTa5rMmMh-tnmVm8Vl_LJefFXPsT0tJvTMjJo,411
+openadmin/fastapi/types/stat.py,sha256=eHLHzjld1E1RtiC6iVa-vdxIysNUtUynurHlxes1c-4,361
+openadmin/fastapi/types/table.py,sha256=3DrRzt7QDQBzVU4bXNsDjr6QKtMKExaEkVQDDUs_tow,362
 openadmin/spec/__init__.py,sha256=9ZZnQz67JN7TyZhoI43G7aNKkOidXFX5Lxjkr41lYQ8,660
 openadmin/spec/page.py,sha256=XCiQM_37lTQjjMQjWhrWSHof-pD_j69HZu5n27iHfcA,279
 openadmin/spec/section.py,sha256=9qZny4rGqHeMpl2VApF8vqLuR-oMsc2kE1DmQdO62BI,261
@@ -31,7 +33,7 @@ openadmin/spec/components/property.py,sha256=svoPxt3miGmK_ySFPFJmGdfZIAYBxaK37Vs
 openadmin/spec/components/property_type.py,sha256=m1eJ7H5YIP4dhaa899Qc9BCRkZOwP_DELl6vPZB31HY,306
 openadmin/spec/components/stat.py,sha256=sXQttzMJulS68foVeJ2Y0W4-UH_FSa4nOnxiLfQSGGE,400
 openadmin/spec/components/table.py,sha256=8dJFnKNj-yOE85mFWQVdoku5tTWA4UZHwV8zId0z6j8,500
-openadmin_dev-0.3.0.dist-info/METADATA,sha256=9dbag5eKVKq6sp_uij7wg5hq6KpAKTWEDIbWZ3QH9_4,8941
-openadmin_dev-0.3.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-openadmin_dev-0.3.0.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
-openadmin_dev-0.3.0.dist-info/RECORD,,
+openadmin_dev-0.4.0.dist-info/METADATA,sha256=Jn-MNBsy7UfQdNkISX2MCqswjW8xwDafTbsir0GQkNQ,8940
+openadmin_dev-0.4.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+openadmin_dev-0.4.0.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
+openadmin_dev-0.4.0.dist-info/RECORD,,