fastapi-admin-kit 0.3.0__tar.gz → 0.3.1__tar.gz

{fastapi_admin_kit-0.3.0 → fastapi_admin_kit-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-admin-kit
-Version: 0.3.0
+Version: 0.3.1
 Summary: Drop-in admin panel for FastAPI + SQLAlchemy + SQLModel apps
 Project-URL: Homepage, https://github.com/borhanst/fastapi-admin-kit
 Project-URL: Documentation, https://borhanst.github.io/fastapi-admin-kit/
@@ -44,6 +44,8 @@ Provides-Extra: docs
 Requires-Dist: mkdocs-material>=9.5.0; extra == 'docs'
 Requires-Dist: mkdocs>=1.6.0; extra == 'docs'
 Requires-Dist: mkdocstrings[python]>=0.25.0; extra == 'docs'
+Provides-Extra: excel
+Requires-Dist: openpyxl>=3.1.0; extra == 'excel'
 Provides-Extra: full
 Requires-Dist: pyjwt>=2.13.0; extra == 'full'
 Requires-Dist: uvicorn>=0.30.0; extra == 'full'

{fastapi_admin_kit-0.3.0 → fastapi_admin_kit-0.3.1}/fastapi_admin_kit/__init__.py

@@ -5,6 +5,7 @@ from fastapi_admin_kit.admin.decorators import column
 from fastapi_admin_kit.auth.mixins import AuthModelMixin
 from fastapi_admin_kit.config import DatabaseConfig, DatabaseType
 from fastapi_admin_kit.exceptions import ConfigError
+from fastapi_admin_kit.export_import import CSVExport, CSVImport, ExportBase, ImportBase
 from fastapi_admin_kit.inline import InlineModelAdmin, StackedInline, TabularInline
 from fastapi_admin_kit.nav import (
     BuiltNavGroup,
@@ -81,5 +82,10 @@ __all__ = [
     "SearchView",
     # Per-model assets
     "AdminExtra",
+    # Export/Import
+    "ExportBase",
+    "ImportBase",
+    "CSVExport",
+    "CSVImport",
 ]
-__version__ = "0.3.0"
+__version__ = "0.3.1"

{fastapi_admin_kit-0.3.0 → fastapi_admin_kit-0.3.1}/fastapi_admin_kit/admin/admin_template.py

@@ -22,6 +22,7 @@ class AdminTemplate:
         dark_mode_default: bool = False,
         dashboard_permission: str | None = None,
         settings_permission: str | None = None,
+        sidebar_bottom_links: list[dict[str, str]] | None = None,
     ):
         self.title = title
         self.logo_url = logo_url
@@ -31,6 +32,7 @@ class AdminTemplate:
         self.dark_mode_default = dark_mode_default
         self.dashboard_permission = dashboard_permission
         self.settings_permission = settings_permission
+        self.sidebar_bottom_links: list[dict[str, str]] = sidebar_bottom_links or []
         self._nav_groups_built: list = []
 
     def _init_jinja(self, app: Any) -> None:
@@ -221,6 +223,7 @@ class AdminTemplate:
             "current_user": user_for_template,
             "dashboard_visible": dashboard_visible,
             "settings_visible": settings_visible,
+            "sidebar_bottom_links": self.sidebar_bottom_links,
         }
 
     async def apply_sidebar_context(self, request: Any, user: Any, context: dict) -> dict:

{fastapi_admin_kit-0.3.0 → fastapi_admin_kit-0.3.1}/fastapi_admin_kit/admin/core.py

@@ -180,6 +180,7 @@ class Admin:
         mobile_sidebar: str = "overlay",
         dashboard_permission: str | None = None,
         settings_permission: str | None = None,
+        sidebar_bottom_links: list[dict[str, str]] | None = None,
     ):
         self.registry = AdminRegistry()
         self._app: FastAPI | None = app
@@ -261,6 +262,7 @@ class Admin:
                     require_tags=require_tags,
                     dashboard_permission=dashboard_permission,
                     settings_permission=settings_permission,
+                    sidebar_bottom_links=sidebar_bottom_links,
                 ),
             )
 
@@ -283,6 +285,7 @@ class Admin:
                 dark_mode_default=config.ui.dark_mode_default,
                 dashboard_permission=config.nav.dashboard_permission,
                 settings_permission=config.nav.settings_permission,
+                sidebar_bottom_links=config.nav.sidebar_bottom_links,
             )
 
         self.config = config
@@ -555,7 +558,9 @@ class Admin:
                 from fastapi_admin_kit.db import create_session_factory
 
                 session_factory = create_session_factory(engine)
-                from fastapi_admin_kit.backends.sqlalchemy import SqlAlchemyAuditBackend
+                from fastapi_admin_kit.backends.sqlalchemy import (
+                    SqlAlchemyAuditBackend,
+                )
 
                 audit_backend = SqlAlchemyAuditBackend()
                 audit_backend.attach_listeners(session_factory, self.registry)
@@ -736,7 +741,9 @@ class Admin:
         # Unified signing-key source for sessions, CSRF, and JWT (see AdminState).
         app.state.admin_secret_key = state.secret_key
         # Multi-ORM backend: store composed backend and derive individual adapters
-        from fastapi_admin_kit.backends.sqlalchemy import SqlAlchemySessionAdapter
+        from fastapi_admin_kit.backends.sqlalchemy import (
+            SqlAlchemySessionAdapter,
+        )
 
         app.state.admin_backend = self.backend
         app.state.admin_session_backend_class = SqlAlchemySessionAdapter
@@ -848,6 +855,7 @@ class Admin:
             "bars-": "menu",
             "bars-3": "menu",
             "arrow-down-tray": "download",
+            "arrow-up-tray": "upload",
             "arrow-path": "refresh",
             "paper-airplane": "send",
             "exclamation-triangle": "warning",

{fastapi_admin_kit-0.3.0 → fastapi_admin_kit-0.3.1}/fastapi_admin_kit/audit/context.py

@@ -3,7 +3,10 @@
 from __future__ import annotations
 
 from contextvars import ContextVar
-from typing import Any
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from fastapi_admin_kit.audit.events import AuditEvent
 
 # Context variable to store audit context (user, IP, user_agent, etc.)
 _current_audit_context: ContextVar[dict] = ContextVar("_current_audit_context", default={})
@@ -60,3 +63,32 @@ class AuditContext:
     def clear_context(self) -> None:
         """Clear the audit context."""
         clear_audit_context()
+
+
+async def log_audit_event(request: Any, event: AuditEvent) -> None:
+    """Persist an AuditEvent directly to the database.
+
+    Used for EXPORT/IMPORT events that don't go through the SQLAlchemy
+    before_flush listener.
+    """
+    from fastapi_admin_kit.audit.models import AuditLog
+    from fastapi_admin_kit.db import get_db_session
+
+    session = get_db_session(request)
+    ctx = get_audit_context()
+
+    entry = AuditLog(
+        action=event.event_type,
+        model_name=event.model_name,
+        table_name=event.table_name,
+        object_id=event.object_id,
+        object_repr=event.object_repr,
+        changes=event.changes,
+        full_snapshot=event.full_snapshot,
+        user_id=event.user_id or ctx.get("user_id"),
+        user_email=event.user_email or ctx.get("user_email"),
+        ip_address=event.ip_address or ctx.get("ip_address"),
+        user_agent=event.user_agent or ctx.get("user_agent"),
+    )
+    session.add(entry)
+    await session.flush()

{fastapi_admin_kit-0.3.0 → fastapi_admin_kit-0.3.1}/fastapi_admin_kit/audit/events.py

@@ -9,13 +9,13 @@ from typing import Any
 
 @dataclass
 class AuditEvent:
-    """Represents a single audit event (CREATE, UPDATE, or DELETE).
+    """Represents a single audit event (CREATE, UPDATE, DELETE, EXPORT, or IMPORT).
 
     This is a pure data structure with no side effects, making it
     easy to test and serialize.
     """
 
-    event_type: str  # "CREATE" | "UPDATE" | "DELETE"
+    event_type: str  # "CREATE" | "UPDATE" | "DELETE" | "EXPORT" | "IMPORT"
     model_name: str
     table_name: str
     object_id: str

{fastapi_admin_kit-0.3.0 → fastapi_admin_kit-0.3.1}/fastapi_admin_kit/audit/logger.py

@@ -26,3 +26,11 @@ class AuditLogger(ABC):
     @abstractmethod
     def log_delete(self, event: AuditEvent) -> None:
         """Persist a DELETE audit event."""
+
+    @abstractmethod
+    def log_export(self, event: AuditEvent) -> None:
+        """Persist an EXPORT audit event."""
+
+    @abstractmethod
+    def log_import(self, event: AuditEvent) -> None:
+        """Persist an IMPORT audit event."""

{fastapi_admin_kit-0.3.0 → fastapi_admin_kit-0.3.1}/fastapi_admin_kit/audit/sqlalchemy_logger.py

@@ -32,6 +32,12 @@ class SqlAlchemyAuditLogger(AuditLogger):
     def log_delete(self, event: AuditEvent) -> None:
         self._buffer(event)
 
+    def log_export(self, event: AuditEvent) -> None:
+        self._buffer(event)
+
+    def log_import(self, event: AuditEvent) -> None:
+        self._buffer(event)
+
     def _buffer(self, event: AuditEvent) -> None:
         entry = AuditLog(
             user_id=event.user_id,

{fastapi_admin_kit-0.3.0 → fastapi_admin_kit-0.3.1}/fastapi_admin_kit/auth/models.py

@@ -129,6 +129,8 @@ class Permission(Base):
     can_create = Column(Boolean, default=False)
     can_edit = Column(Boolean, default=False)
     can_delete = Column(Boolean, default=False)
+    can_export = Column(Boolean, default=False)
+    can_import = Column(Boolean, default=False)
 
     roles = relationship("Role", secondary=admin_role_permissions, back_populates="permissions")
 

{fastapi_admin_kit-0.3.0 → fastapi_admin_kit-0.3.1}/fastapi_admin_kit/auth/permissions.py

@@ -82,6 +82,10 @@ class PermissionChecker:
                 ps.can_edit = True
             if perm.can_delete:
                 ps.can_delete = True
+            if perm.can_export:
+                ps.can_export = True
+            if perm.can_import:
+                ps.can_import = True
 
         return self._role_cache
 
@@ -116,6 +120,10 @@ class PermissionChecker:
                 ps.can_edit = True
             if perm.can_delete:
                 ps.can_delete = True
+            if perm.can_export:
+                ps.can_export = True
+            if perm.can_import:
+                ps.can_import = True
 
         return self._direct_cache
 
@@ -137,7 +145,7 @@ class PermissionChecker:
     async def has_permission(self, table_name: str, action: str) -> bool:
         """Return True if the current user may perform *action* on *table_name*.
 
-        Actions: ``"view"`` | ``"create"`` | ``"edit"`` | ``"delete"``
+        Actions: ``"view"`` | ``"create"`` | ``"edit"`` | ``"delete"`` | ``"export"`` | ``"import"``
 
         Superusers always return True. Results are cached per-request.
         """
@@ -191,6 +199,8 @@ class PermissionChecker:
                 can_create=True,
                 can_edit=True,
                 can_delete=True,
+                can_export=True,
+                can_import=True,
             )
         # Check if cache has been populated for this table
         cache_populated = any(key[0] == table_name for key in self._cache)
@@ -207,6 +217,8 @@ class PermissionChecker:
             can_create=self._cache.get((table_name, "create"), False),
             can_edit=self._cache.get((table_name, "edit"), False),
             can_delete=self._cache.get((table_name, "delete"), False),
+            can_export=self._cache.get((table_name, "export"), False),
+            can_import=self._cache.get((table_name, "import"), False),
         )
 
     async def load_permissions(self, table_name: str) -> PermissionSet:
@@ -218,4 +230,6 @@ class PermissionChecker:
         await self.has_permission(table_name, "create")
         await self.has_permission(table_name, "edit")
         await self.has_permission(table_name, "delete")
+        await self.has_permission(table_name, "export")
+        await self.has_permission(table_name, "import")
         return self.permission_set(table_name)

{fastapi_admin_kit-0.3.0 → fastapi_admin_kit-0.3.1}/fastapi_admin_kit/auth/types.py

@@ -13,6 +13,8 @@ class PermissionSet:
     can_create: bool = False
     can_edit: bool = False
     can_delete: bool = False
+    can_export: bool = False
+    can_import: bool = False
 
 
 @dataclass

{fastapi_admin_kit-0.3.0 → fastapi_admin_kit-0.3.1}/fastapi_admin_kit/config/nav.py

@@ -16,6 +16,7 @@ class NavConfig:
         site_dropdown: list[dict[str, str]] | None = None,
         dashboard_permission: str | None = None,
         settings_permission: str | None = None,
+        sidebar_bottom_links: list[dict[str, str]] | None = None,
     ):
         self.nav_groups = nav_groups or []
         self.sidebar_builder = sidebar_builder
@@ -23,6 +24,7 @@ class NavConfig:
         self.site_dropdown = site_dropdown or []
         self.dashboard_permission = dashboard_permission
         self.settings_permission = settings_permission
+        self.sidebar_bottom_links = sidebar_bottom_links or []
 
     def validate_nav_config(self) -> None:
         """Validate navigation configuration."""

fastapi_admin_kit-0.3.1/fastapi_admin_kit/export_import/__init__.py

@@ -0,0 +1,28 @@
+"""Export and Import module for FastAPI Admin Kit."""
+
+from fastapi_admin_kit.export_import.base import ExportBase, ImportBase
+from fastapi_admin_kit.export_import.csv import CSVExport, CSVImport
+from fastapi_admin_kit.export_import.registry import (
+    get_export_class,
+    get_import_class,
+    register_export,
+    register_import,
+)
+
+__all__ = [
+    "ExportBase",
+    "ImportBase",
+    "CSVExport",
+    "CSVImport",
+    "register_export",
+    "register_import",
+    "get_export_class",
+    "get_import_class",
+]
+
+try:
+    from fastapi_admin_kit.export_import.excel import ExcelExport, ExcelImport
+
+    __all__ += ["ExcelExport", "ExcelImport"]
+except ImportError:
+    pass