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

fastapi_admin_kit-0.4.0/CHANGELOG.md

@@ -0,0 +1,115 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Changed
+- **AI is now gated behind `ai_enabled` (default `False`).** When AI is
+  disabled, the `admin_ai_*` tables are not created, and the AI models, nav
+  group, and routes are not registered in the admin UI or the JSON API.
+  Notifications, auth, roles, audit, and login-attempt models are unaffected.
+- Internal tables (`admin_refresh_tokens`, `admin_user_permissions`,
+  `admin_user_totp`, `admin_ai_attachments`) are no longer exposed over the
+  JSON API (previously a latent security hole). They remain hidden from the
+  sidebar.
+
+### Added
+- `Admin.setup()` now logs a non-blocking preflight warning naming any missing
+  `admin_ai_*` tables (with the command to fix them) when `ai_enabled=True`
+  but the schema is absent (Alembic / `SKIP_CREATE_TABLES=true` mode).
+- `fastapi_admin_kit.schemas.builtin.AI_TABLE_NAMES` and
+  `INTERNAL_TABLE_NAMES` constants for gating/identification.
+- `AdminRegistry.auto_discover(exclude_tables=...)` accepts a set of table
+  names to skip during discovery.
+
+## [0.3.2] - 2026-07-31
+
+### Changed
+- Added Alembic database migrations so schema changes can be versioned and
+  applied incrementally instead of relying solely on auto-create
+  ([#39](https://github.com/borhanst/fastapi-admin-kit/pull/39)).
+
+## [0.3.1] - 2026-07-29
+
+### Added
+- CSV export and import support for models, enabling bulk data download and
+  upload from the admin UI
+  ([#38](https://github.com/borhanst/fastapi-admin-kit/pull/38)).
+
+## [0.3.0] - 2026-07-28
+
+### Added
+- Per-model permission updates and refinements to the RBAC model
+  ([#20](https://github.com/borhanst/fastapi-admin-kit/pull/20)).
+- Inline formset support for `ModelAdmin`, allowing related records to be
+  edited on the same page
+  ([#21](https://github.com/borhanst/fastapi-admin-kit/pull/21)).
+- Adapter registration wired directly into `Admin`
+  ([#35](https://github.com/borhanst/fastapi-admin-kit/pull/35)).
+- Schema-first + protocol hybrid approach for built-in admin models
+  ([#34](https://github.com/borhanst/fastapi-admin-kit/pull/34)).
+
+### Changed
+- Decoupled `DefaultQueryProvider`, `search_utils`, and the `Filter` classes
+  from SQLAlchemy, improving backend portability
+  ([#33](https://github.com/borhanst/fastapi-admin-kit/pull/33)).
+
+### Fixed
+- Assorted bug fixes and stability improvements
+  ([#36](https://github.com/borhanst/fastapi-admin-kit/pull/36)).
+
+## [0.2.1] - 2026-07-21
+
+### Fixed
+- Corrected a user-permission model bug and adjusted how permissions are
+  stored and evaluated
+  ([#19](https://github.com/borhanst/fastapi-admin-kit/pull/19)).
+
+## [0.2.0] - 2026-07-13
+
+### Added
+- Authentication subsystem with session-based login, logout, and protected
+  routes ([#14](https://github.com/borhanst/fastapi-admin-kit/pull/14)).
+
+### Fixed
+- Resolved a documentation build failure
+  ([#15](https://github.com/borhanst/fastapi-admin-kit/pull/15)).
+
+## [0.1.2] - 2026-07-09
+
+### Added
+- CLI commands for project scaffolding and user management
+  ([#10](https://github.com/borhanst/fastapi-admin-kit/pull/10)).
+
+### Fixed
+- Added support for UUID primary keys on models
+  ([#12](https://github.com/borhanst/fastapi-admin-kit/pull/12)).
+
+## [0.1.1] - 2026-07-09
+
+### Added
+- Database configuration and connection handling
+  ([#1](https://github.com/borhanst/fastapi-admin-kit/pull/1)).
+- Inline editing — edit records directly from the list view
+  ([#9](https://github.com/borhanst/fastapi-admin-kit/pull/9)).
+
+### Changed
+- Renamed the CLI from `fastapi-admin-kit` to `fak-admin`
+  ([#3](https://github.com/borhanst/fastapi-admin-kit/pull/3)).
+
+### Fixed
+- Use `StrEnum` for `DatabaseType` for safer, string-compatible enums
+  ([#4](https://github.com/borhanst/fastapi-admin-kit/pull/4)).
+- Updated emoji configuration in the markdown extensions
+  ([#5](https://github.com/borhanst/fastapi-admin-kit/pull/5)).
+
+## [0.1.0] - 2026-07-08
+
+### Added
+- Initial release of FastAPI Admin Kit: a drop-in admin panel for FastAPI +
+  SQLAlchemy + SQLModel applications with auto-discovery, RBAC, audit logging,
+  and a modern UI.

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

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: fastapi-admin-kit
-Version: 0.3.1
+Version: 0.4.0
 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/
@@ -31,6 +31,13 @@ Requires-Dist: jinja2>=3.1.0
 Requires-Dist: pre-commit>=4.6.0
 Requires-Dist: python-multipart>=0.0.9
 Requires-Dist: sqlalchemy>=2.0.0
+Provides-Extra: ai
+Requires-Dist: pydantic-ai[groq]>=2.0.0; extra == 'ai'
+Provides-Extra: ai-gemini
+Requires-Dist: google-genai>=1.0.0; extra == 'ai-gemini'
+Requires-Dist: pydantic-ai>=2.0.0; extra == 'ai-gemini'
+Provides-Extra: alembic
+Requires-Dist: alembic>=1.13.0; extra == 'alembic'
 Provides-Extra: dev
 Requires-Dist: hatch>=1.13.0; extra == 'dev'
 Requires-Dist: httpx>=0.27.0; extra == 'dev'
@@ -51,6 +58,8 @@ Requires-Dist: pyjwt>=2.13.0; extra == 'full'
 Requires-Dist: uvicorn>=0.30.0; extra == 'full'
 Provides-Extra: mysql
 Requires-Dist: aiomysql>=0.2.0; extra == 'mysql'
+Provides-Extra: notifications
+Requires-Dist: twilio>=8.9.0; extra == 'notifications'
 Provides-Extra: postgres
 Requires-Dist: asyncpg>=0.29.0; extra == 'postgres'
 Provides-Extra: sqlmodel
@@ -64,7 +73,7 @@ Description-Content-Type: text/markdown
 [![License](https://img.shields.io/pypi/l/fastapi-admin-kit.svg)](https://github.com/borhanst/fastapi-admin-kit/blob/main/LICENSE)
 [![Tests](https://github.com/borhanst/fastapi-admin-kit/actions/workflows/tests.yml/badge.svg)](https://github.com/borhanst/fastapi-admin-kit/actions/workflows/tests.yml)
 
-A drop-in admin panel for FastAPI + SQLAlchemy + SQLModel apps, inspired by Django Unfold.
+A drop-in admin panel for FastAPI + SQLAlchemy + SQLModel apps, inspired by Django Admin.
 
 ![FastAPI Admin Kit Dashboard](docs/assets/images/admin-dashboard.png)
 
@@ -82,7 +91,7 @@ A drop-in admin panel for FastAPI + SQLAlchemy + SQLModel apps, inspired by Djan
 - **17 Built-in Widgets** — TextInput, Toggle, DatePicker, FileUpload, Wysiwyg, and more
 - **Inline Editing** — Edit records directly from list view with 3-dot action menu
 - **Command Palette** — `Cmd+K` / `Ctrl+K` global search across models and fields
-- **JSON API** — REST endpoints with JWT token auth for external frontends
+<!--- **JSON API** — REST endpoints with JWT token auth for external frontends-->
 - **Dashboard** — Configurable stat cards, charts, tables, and progress bars
 - **CLI Tools** — `fak-admin` / `fak` for superuser management and project scaffolding
 - **Pagination** — Offset, cursor, or dynamic strategies per model
@@ -246,7 +255,6 @@ All commands accept `-d DATABASE_URL` or read the `DATABASE_URL` environment var
 
 ```python
 from fastapi_admin_kit import Admin
-from fastapi_admin_kit.config import ThemeConfig
 
 admin = Admin(
     app=app,
@@ -255,7 +263,6 @@ admin = Admin(
     secret_key=SECRET_KEY,
     title="My Admin",           # Admin panel title
     admin_path="/admin",        # URL prefix
-    dark_mode_default=False,    # Dark mode on by default
     # Auth
     auth_backend=BuiltinAuthBackend(),
     # Environment badge

{fastapi_admin_kit-0.3.1 → fastapi_admin_kit-0.4.0}/README.md

@@ -5,7 +5,7 @@
 [![License](https://img.shields.io/pypi/l/fastapi-admin-kit.svg)](https://github.com/borhanst/fastapi-admin-kit/blob/main/LICENSE)
 [![Tests](https://github.com/borhanst/fastapi-admin-kit/actions/workflows/tests.yml/badge.svg)](https://github.com/borhanst/fastapi-admin-kit/actions/workflows/tests.yml)
 
-A drop-in admin panel for FastAPI + SQLAlchemy + SQLModel apps, inspired by Django Unfold.
+A drop-in admin panel for FastAPI + SQLAlchemy + SQLModel apps, inspired by Django Admin.
 
 ![FastAPI Admin Kit Dashboard](docs/assets/images/admin-dashboard.png)
 
@@ -23,7 +23,7 @@ A drop-in admin panel for FastAPI + SQLAlchemy + SQLModel apps, inspired by Djan
 - **17 Built-in Widgets** — TextInput, Toggle, DatePicker, FileUpload, Wysiwyg, and more
 - **Inline Editing** — Edit records directly from list view with 3-dot action menu
 - **Command Palette** — `Cmd+K` / `Ctrl+K` global search across models and fields
-- **JSON API** — REST endpoints with JWT token auth for external frontends
+<!--- **JSON API** — REST endpoints with JWT token auth for external frontends-->
 - **Dashboard** — Configurable stat cards, charts, tables, and progress bars
 - **CLI Tools** — `fak-admin` / `fak` for superuser management and project scaffolding
 - **Pagination** — Offset, cursor, or dynamic strategies per model
@@ -187,7 +187,6 @@ All commands accept `-d DATABASE_URL` or read the `DATABASE_URL` environment var
 
 ```python
 from fastapi_admin_kit import Admin
-from fastapi_admin_kit.config import ThemeConfig
 
 admin = Admin(
     app=app,
@@ -196,7 +195,6 @@ admin = Admin(
     secret_key=SECRET_KEY,
     title="My Admin",           # Admin panel title
     admin_path="/admin",        # URL prefix
-    dark_mode_default=False,    # Dark mode on by default
     # Auth
     auth_backend=BuiltinAuthBackend(),
     # Environment badge

fastapi_admin_kit-0.4.0/example/custom_templates/admin/list.html

@@ -0,0 +1,28 @@
+{# custom_templates/admin/list.html — GLOBAL list-view override.
+   Extends the built-in admin/base_list.html and replaces the page header with a
+   custom banner. Because this template lives in a custom template dir that is
+   prepended ahead of the built-ins, it wins over the default admin/list.html
+   for every registered model that doesn't provide its own per-model override.
+
+   To target a single model instead, name the file admin/<table>/list.html (see
+   the Product example in example/custom_templates/admin/products/list.html).
+#}
+{% extends "admin/base_list.html" %}
+
+{% block list_header %}
+<div class="page-header" style="border: 2px dashed #6366F1; border-radius: 0.75rem; padding: 1rem;">
+  <div class="page-header-left">
+    <h1 class="page-header-title">{{ registered.verbose_name_plural }}</h1>
+    <p class="page-header-subtitle">
+      &#10003; Custom template dir override applied — built-in header replaced.
+    </p>
+  </div>
+  <div class="page-header-right" style="display: flex; gap: 0.5rem; align-items: center;">
+    {% if permissions.can_create %}
+    <a href="{{ admin_path | default('/admin') }}/{{ registered.table_name }}/create" class="btn btn-primary">
+      + New {{ registered.verbose_name }}
+    </a>
+    {% endif %}
+  </div>
+</div>
+{% endblock %}

fastapi_admin_kit-0.4.0/example/custom_templates/admin/products/list.html

@@ -0,0 +1,27 @@
+{# custom_templates/admin/products/list.html — PER-MODEL list-view override.
+   Only applies to the Product model (table "products"). It takes priority over
+   the global admin/list.html and the built-in default.
+
+   Template resolution order (first match wins):
+     1. Explicit admin.list_template
+     2. admin/<table>/list.html          <- this file
+     3. admin/list.html                  <- global override
+     4. pages/list.html                  <- built-in default
+#}
+{% extends "admin/base_list.html" %}
+
+{% block list_header %}
+<div class="page-header" style="border: 2px solid #10B981; border-radius: 0.75rem; padding: 1rem;">
+  <div class="page-header-left">
+    <h1 class="page-header-title">&#128230; PRODUCT CATALOG (custom template)</h1>
+    <p class="page-header-subtitle">This header comes from a per-model template: admin/products/list.html</p>
+  </div>
+  <div class="page-header-right" style="display: flex; gap: 0.5rem; align-items: center;">
+    {% if permissions.can_create %}
+    <a href="{{ admin_path | default('/admin') }}/{{ registered.table_name }}/create" class="btn btn-primary">
+      + New {{ registered.verbose_name }}
+    </a>
+    {% endif %}
+  </div>
+</div>
+{% endblock %}