openadmin-dev 0.1.0__py3-none-any.whl

openadmin/fastapi/types/bar_chart.py

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from collections.abc import Callable
+
+from pydantic import BaseModel, ConfigDict
+
+from openadmin import spec
+
+
+class BarChart(BaseModel):
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
+    function_name: str
+    name: str
+    description: str | None
+    method: spec.HttpMethod
+    func: Callable | None = None

openadmin/fastapi/types/form.py

@@ -0,0 +1,20 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from collections.abc import Callable
+
+from pydantic import BaseModel, ConfigDict
+
+from openadmin import spec
+
+
+class Form(BaseModel):
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
+    function_name: str
+    name: str
+    description: str | None
+    method: spec.HttpMethod
+    is_hiden: bool
+    func: Callable | None = None

openadmin/fastapi/types/line_chart.py

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from collections.abc import Callable
+
+from pydantic import BaseModel, ConfigDict
+
+from openadmin import spec
+
+
+class LineChart(BaseModel):
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
+    function_name: str
+    name: str
+    description: str | None
+    method: spec.HttpMethod
+    func: Callable | None = None

openadmin/fastapi/types/markdown.py

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from collections.abc import Callable
+
+from pydantic import BaseModel, ConfigDict
+
+from openadmin import spec
+
+
+class Markdown(BaseModel):
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
+    function_name: str
+    name: str
+    description: str | None
+    method: spec.HttpMethod
+    func: Callable | None = None

openadmin/fastapi/types/page_protocol.py

@@ -0,0 +1,12 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from typing import Protocol
+
+from fastapi import FastAPI
+from openadmin import spec
+
+
+class PageProtocol(Protocol):
+    def get_page_spec(self, app: FastAPI) -> spec.Page: ...

openadmin/fastapi/types/pie_chart.py

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from collections.abc import Callable
+
+from pydantic import BaseModel, ConfigDict
+
+from openadmin import spec
+
+
+class PieChart(BaseModel):
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
+    function_name: str
+    name: str
+    description: str | None
+    method: spec.HttpMethod
+    func: Callable | None = None

openadmin/fastapi/types/section.py

@@ -0,0 +1,15 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from dataclasses import dataclass
+from typing import Sequence
+
+from .page_protocol import PageProtocol
+
+
+@dataclass
+class Section:
+    name: str
+    description: str | None
+    pages: Sequence[PageProtocol]

openadmin/fastapi/types/stat.py

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from collections.abc import Callable
+
+from pydantic import BaseModel, ConfigDict
+
+from openadmin import spec
+
+
+class Stat(BaseModel):
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
+    function_name: str
+    method: spec.HttpMethod
+    name: str
+    description: str | None
+    func: Callable | None = None

openadmin/fastapi/types/table.py

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from collections.abc import Callable
+
+from pydantic import BaseModel, ConfigDict
+
+from openadmin import spec
+
+
+class Table(BaseModel):
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
+    function_name: str
+    method: spec.HttpMethod
+    name: str
+    description: str | None
+    func: Callable | None = None

openadmin/fastapi/utils.py

@@ -0,0 +1,167 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+import inspect
+from typing import Annotated, get_args, get_origin, get_type_hints
+
+import pydantic
+
+from fastapi.params import Body as BodyParam
+from fastapi.params import Form as FormParam
+from fastapi.params import Query as QueryParam
+from openadmin import spec
+
+_SCALAR_LIST_TYPES: dict[type, spec.PropertyType] = {
+    str: "list[string]",
+    int: "list[integer]",
+    float: "list[float]",
+    bool: "list[bool]",
+}
+
+
+def _type_to_property_type(tp) -> spec.PropertyType:
+    origin = get_origin(tp)
+    if origin is list:
+        inner = get_args(tp)
+        if inner:
+            scalar = _SCALAR_LIST_TYPES.get(inner[0])
+            if scalar:
+                return scalar
+        return "list"
+    if tp is str:
+        return "string"
+    if tp is int:
+        return "integer"
+    if tp is float:
+        return "float"
+    if tp is bool:
+        return "bool"
+    if isinstance(tp, type) and issubclass(tp, pydantic.BaseModel):
+        return "object"
+    return "string"
+
+
+def _model_to_properties(model: type) -> list[spec.Property]:
+    props = []
+    for field_name, field_info in model.model_fields.items():
+        tp = field_info.annotation
+        prop_type = _type_to_property_type(tp)
+        nested = None
+        if (
+            prop_type == "object"
+            and isinstance(tp, type)
+            and issubclass(tp, pydantic.BaseModel)
+        ):
+            nested = _model_to_properties(tp)
+        elif prop_type == "list":
+            inner = get_args(tp)
+            if (
+                inner
+                and isinstance(inner[0], type)
+                and issubclass(inner[0], pydantic.BaseModel)
+            ):
+                nested = _model_to_properties(inner[0])
+        display = field_info.title or field_name.replace("_", " ").title()
+        alias = field_info.alias or field_name
+        props.append(
+            spec.Property(
+                name=display,
+                alias=alias,
+                type=prop_type,
+                is_required=field_info.is_required(),
+                properties=nested,
+            )
+        )
+    return props
+
+
+def _make_property(param_name: str, tp, marker) -> spec.Property:
+    prop_type = _type_to_property_type(tp)
+    nested = None
+    if (
+        prop_type == "object"
+        and isinstance(tp, type)
+        and issubclass(tp, pydantic.BaseModel)
+    ):
+        nested = _model_to_properties(tp)
+
+    display = param_name.replace("_", " ").title()
+    alias = param_name
+    required = True
+
+    if marker is not None:
+        if marker.alias:
+            alias = marker.alias
+        if marker.title:
+            display = marker.title
+        required = marker.is_required()
+
+    return spec.Property(
+        name=display,
+        alias=alias,
+        type=prop_type,
+        is_required=required,
+        properties=nested,
+    )
+
+
+def extract_params(
+    func,
+) -> tuple[
+    list[spec.Property] | None, list[spec.Property] | None, list[spec.Property] | None
+]:
+    """Return (query, body, form) properties extracted from a function's signature."""
+    try:
+        hints = get_type_hints(func, include_extras=True)
+    except Exception:
+        return None, None, None
+
+    sig = inspect.signature(func)
+    query: list[spec.Property] = []
+    body: list[spec.Property] = []
+    form: list[spec.Property] = []
+
+    for param_name, param in sig.parameters.items():
+        if param_name in ("self", "cls"):
+            continue
+
+        annotation = hints.get(param_name, inspect.Parameter.empty)
+        default = param.default
+        marker = None
+        actual_type = annotation
+
+        if get_origin(annotation) is Annotated:
+            args = get_args(annotation)
+            actual_type = args[0]
+            for arg in args[1:]:
+                if isinstance(arg, (QueryParam, BodyParam, FormParam)):
+                    marker = arg
+                    break
+
+        if marker is None and isinstance(default, (QueryParam, BodyParam, FormParam)):
+            marker = default
+
+        # 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))
+        elif isinstance(marker, FormParam):
+            form.append(_make_property(param_name, actual_type, marker))
+        elif isinstance(marker, BodyParam):
+            if isinstance(actual_type, type) and issubclass(
+                actual_type, pydantic.BaseModel
+            ):
+                body.extend(_model_to_properties(actual_type))
+            else:
+                body.append(_make_property(param_name, actual_type, marker))
+        elif (
+            annotation is not inspect.Parameter.empty
+            and default is inspect.Parameter.empty
+        ):
+            # Unannotated Pydantic model with no default → implicit JSON body
+            if isinstance(actual_type, type) and issubclass(
+                actual_type, pydantic.BaseModel
+            ):
+                body.extend(_model_to_properties(actual_type))
+
+    return query or None, body or None, form or None

openadmin/spec/__init__.py

@@ -0,0 +1,41 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from .components import (
+    Action,
+    AreaChart,
+    BarChart,
+    Component,
+    Form,
+    LineChart,
+    Markdown,
+    PieChart,
+    Property,
+    PropertyType,
+    Stat,
+    Table,
+)
+from .components.http_methods import HttpMethod
+from .page import Page
+from .section import Section
+from .spec import Spec
+
+__all__ = [
+    "Action",
+    "AreaChart",
+    "BarChart",
+    "Component",
+    "Form",
+    "HttpMethod",
+    "LineChart",
+    "Page",
+    "PieChart",
+    "Property",
+    "PropertyType",
+    "Section",
+    "Spec",
+    "Stat",
+    "Table",
+    "Markdown",
+]

openadmin/spec/components/__init__.py

@@ -0,0 +1,35 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from typing import Union
+
+from .action import Action
+from .area_chart import AreaChart
+from .bar_chart import BarChart
+from .form import Form
+from .line_chart import LineChart
+from .markdown import Markdown
+from .pie_chart import PieChart
+from .property import Property
+from .property_type import PropertyType
+from .stat import Stat
+from .table import Table
+
+type Component = Union[
+    Stat, Table, AreaChart, BarChart, LineChart, PieChart, Action, Form, Markdown
+]
+
+__all__ = [
+    "AreaChart",
+    "BarChart",
+    "Component",
+    "LineChart",
+    "PieChart",
+    "Stat",
+    "Action",
+    "Table",
+    "Form",
+    "Property",
+    "PropertyType",
+]

openadmin/spec/components/action.py

@@ -0,0 +1,22 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from typing import List, Literal
+
+from pydantic import BaseModel, Field
+
+from .http_methods import HttpMethod
+from .property import Property
+
+
+class Action(BaseModel):
+    type: Literal["action"]
+    name: str
+    description: str | None
+    url: str
+    method: HttpMethod
+    is_hidden: bool
+    form: List[Property] | None = Field(None)
+    body: List[Property] | None = Field(None)
+    query: List[Property] | None = Field(None)

openadmin/spec/components/area_chart.py

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from typing import Literal
+
+from pydantic import BaseModel, Field
+
+from .http_methods import HttpMethod
+from .property import Property
+
+
+class AreaChart(BaseModel):
+    type: Literal["area-chart"]
+    name: str
+    description: str | None
+    url: str
+    method: HttpMethod
+    query: list[Property] | None = Field(None)

openadmin/spec/components/bar_chart.py

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from typing import Literal
+
+from pydantic import BaseModel, Field
+
+from .http_methods import HttpMethod
+from .property import Property
+
+
+class BarChart(BaseModel):
+    type: Literal["bar-chart"]
+    name: str
+    description: str | None
+    url: str
+    method: HttpMethod
+    query: list[Property] | None = Field(None)

openadmin/spec/components/form.py

@@ -0,0 +1,22 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from typing import List, Literal
+
+from pydantic import BaseModel, Field
+
+from .http_methods import HttpMethod
+from .property import Property
+
+
+class Form(BaseModel):
+    type: Literal["form"]
+    name: str
+    description: str | None
+    url: str
+    method: HttpMethod
+    is_hiden: bool
+    form: List[Property] | None = Field(None)
+    body: List[Property] | None = Field(None)
+    query: List[Property] | None = Field(None)

openadmin/spec/components/http_methods.py

@@ -0,0 +1,7 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from typing import Literal
+
+type HttpMethod = Literal["get", "post", "put", "patch", "delete", "head"]

openadmin/spec/components/line_chart.py

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from typing import Literal
+
+from pydantic import BaseModel, Field
+
+from .http_methods import HttpMethod
+from .property import Property
+
+
+class LineChart(BaseModel):
+    type: Literal["line-chart"]
+    name: str
+    description: str | None
+    url: str
+    method: HttpMethod
+    query: list[Property] | None = Field(None)

openadmin/spec/components/markdown.py

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from typing import List, Literal
+
+from pydantic import BaseModel, Field
+
+from .http_methods import HttpMethod
+from .property import Property
+
+
+class Markdown(BaseModel):
+    type: Literal["markdown"]
+    name: str
+    description: str | None
+    url: str
+    method: HttpMethod
+    query: List[Property] | None = Field(None)

openadmin/spec/components/pie_chart.py

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from typing import Literal
+
+from pydantic import BaseModel, Field
+
+from .http_methods import HttpMethod
+from .property import Property
+
+
+class PieChart(BaseModel):
+    type: Literal["pie-chart"]
+    name: str
+    description: str | None
+    url: str
+    method: HttpMethod
+    query: list[Property] | None = Field(None)

openadmin/spec/components/property.py

@@ -0,0 +1,17 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from typing import List
+
+from pydantic import BaseModel, Field
+
+from .property_type import PropertyType
+
+
+class Property(BaseModel):
+    name: str = Field(..., description="This name for showing to user in admin panel")
+    alias: str = Field(..., description="This name goes to body or form for backend")
+    type: PropertyType
+    is_required: bool
+    properties: List[Property] | None = Field(None)

openadmin/spec/components/property_type.py

@@ -0,0 +1,18 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from typing import Literal
+
+type PropertyType = Literal[
+    "integer",
+    "string",
+    "bool",
+    "float",
+    "object",
+    "list",
+    "list[integer]",
+    "list[string]",
+    "list[bool]",
+    "list[float]",
+]

openadmin/spec/components/stat.py

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from typing import Literal
+
+from pydantic import BaseModel, Field
+
+from .http_methods import HttpMethod
+from .property import Property
+
+
+class Stat(BaseModel):
+    type: Literal["stat"]
+    name: str
+    description: str | None
+    url: str
+    method: HttpMethod
+    query: list[Property] | None = Field(None)

openadmin/spec/components/table.py

@@ -0,0 +1,21 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from typing import List, Literal
+
+from pydantic import BaseModel, Field
+
+from .http_methods import HttpMethod
+from .property import Property
+
+
+class Table(BaseModel):
+    type: Literal["table"]
+    name: str
+    description: str | None
+    url: str
+    method: HttpMethod
+    form: List[Property] | None = Field(None)
+    body: List[Property] | None = Field(None)
+    query: List[Property] | None = Field(None)

openadmin/spec/page.py

@@ -0,0 +1,15 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from typing import List
+
+from pydantic import BaseModel
+
+from .components import Component
+
+
+class Page(BaseModel):
+    name: str
+    description: str | None
+    components: List[Component]

openadmin/spec/section.py

@@ -0,0 +1,15 @@
+# SPDX-FileCopyrightText: 2026 OpenAdmin
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+from typing import List
+
+from pydantic import BaseModel
+
+from .page import Page
+
+
+class Section(BaseModel):
+    name: str
+    description: str | None
+    pages: List[Page]