fastapi-admin-kit 0.3.2__tar.gz → 0.5.0__tar.gz

fastapi_admin_kit-0.5.0/CHANGELOG.md

@@ -0,0 +1,127 @@
+# 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]
+
+### Added
+- Robust Django-style filtering system
+  ([#52](https://github.com/borhanst/fastapi-admin-kit/issues/52)):
+  - New lookup types for the JSON API and admin UI list views:
+    `icontains`, `startswith`, `endswith`, `gt`, `gte`, `lt`, `lte`,
+    `range`, and `in` — in addition to exact matches.
+  - New `ChoiceFilter` for relation/FK fields (auto-detected in
+    `FilterRegistry.auto_generate()`), plus `IntegerFilter` with full
+    numeric lookups.
+  - Admin UI now renders text-input filters (case-insensitive contains)
+    and min/max inputs for numeric fields.
+  - Filters are ORM-agnostic: `QueryBackend` gained an `and_` combinator
+    and the in-memory backend now handles `%`-anchored `ilike` patterns.
+- `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.
+
+### 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.
+
+## [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.2 → fastapi_admin_kit-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: fastapi-admin-kit
-Version: 0.3.2
+Version: 0.5.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,9 +31,15 @@ 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: fakeredis>=2.26.0; extra == 'dev'
 Requires-Dist: hatch>=1.13.0; extra == 'dev'
 Requires-Dist: httpx>=0.27.0; extra == 'dev'
 Requires-Dist: pre-commit>=3.5.0; extra == 'dev'
@@ -53,8 +59,12 @@ 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: redis
+Requires-Dist: fastapi-redis-sdk>=0.8.0; extra == 'redis'
 Provides-Extra: sqlmodel
 Requires-Dist: sqlmodel>=0.0.39; extra == 'sqlmodel'
 Description-Content-Type: text/markdown
@@ -66,7 +76,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)
 
@@ -84,7 +94,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
@@ -248,7 +258,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,
@@ -257,7 +266,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.2 → fastapi_admin_kit-0.5.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.5.0/SECURITY.md

@@ -0,0 +1,32 @@
+# Security Policy
+
+## Reporting Security Issues
+
+**DO NOT report security vulnerabilities via public GitHub issues.**
+
+Instead, please report them by emailing security@fastapi-admin-kit.com with:
+
+- A detailed description of the vulnerability
+- Steps to reproduce the issue
+- Potential impact and affected versions
+- Any proof-of-concept code (if applicable)
+
+## What to Include
+
+Please include the following in your report:
+
+1. **Vulnerability type** (e.g., XSS, SQL injection, authentication bypass, etc.)
+2. **Affected components** or endpoints
+3. **Steps to reproduce**
+4. **Expected vs. actual behavior**
+5. **Environment details** (OS, Python version, framework version)
+6. **Suggested fix** (optional but appreciated)
+
+
+## Security Policy
+
+This project follows responsible disclosure. We will:
+
+- Credit reporters in the release notes (unless requested otherwise)
+- Fix security issues in a timely manner
+- Publish security advisories via the GitHub Security tab

fastapi_admin_kit-0.5.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.5.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 %}