Add Yara ORM support, action-results refresh button, parallel tests (#134)

- Add YaraOrmModelAdmin / YaraOrmInlineModelAdmin adapter and fastadmin[yara-orm]
  extra; full introspection + CRUD (FK, O2O, M2M) mirroring the other ORMs
- Wire Yara ORM into docs, README, API reference and the install matrix; add a
  runnable examples/fastapi_yaraorm app; cross-link to the yara-orm project
- Add a refresh button to widget action results (toolbar + expand modal) so
  results re-run in place without losing scroll position (#132)
- Run the test suite in parallel: per-xdist-worker SQLite files with a busy
  timeout fix the Django/Pony 'database is locked' errors; Makefile/CI use -n auto
- Restore ADMIN_USER_MODEL after each test so a torn-down ORM cannot leak
- Release 0.7.0

Author: vsdudakov

.github/workflows/ci.yml

@@ -51,7 +51,7 @@ jobs:
       - name: Install dependencies
         run: uv sync --all-extras
       - name: Run tests with 100% coverage gate
-        run: uv run pytest -n 1 --cov=fastadmin --cov-report=term-missing --cov-report=xml -s tests
+        run: uv run pytest -n auto --cov=fastadmin --cov-report=term-missing --cov-report=xml tests
       - name: Upload coverage to Codecov
         if: matrix.python-version == '3.13'
         uses: codecov/codecov-action@v5
@@ -74,6 +74,7 @@ jobs:
           - "fastapi,tortoise-orm"
           - "fastapi,pony"
           - "fastapi,sqlalchemy"
+          - "fastapi,yara-orm"
           - "django"
           - "django,pony"
           - "flask,sqlalchemy"

CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to FastAdmin are documented in this file.
 
+## 0.7.0
+
+- Add support for [Yara ORM](https://github.com/vsdudakov/yara-orm) — a fast,
+  async Python ORM with a Rust engine. New `YaraOrmModelAdmin` /
+  `YaraOrmInlineModelAdmin` admin classes and a `fastadmin[yara-orm]` extra, with
+  a runnable FastAPI example (`examples/fastapi_yaraorm`).
+- Add a refresh button to the widget action results (toolbar and expand modal)
+  so results can be re-run in place without losing scroll position (#132).
+
 ## 0.6.0
 
 Security hardening release. No changes to the documented public API, but

Makefile

@@ -25,10 +25,11 @@ format:
 	uv run ruff format $(LINT_PATHS)
 	make -C frontend fix
 
-# Use -n 1: -n auto causes flaky failures with Django+SQLite (database is locked, 500s). conftest
-# uses a per-worker DB and SQLite timeout when xdist is used, but parallel runs remain unreliable.
+# -n auto runs the suite in parallel via pytest-xdist. Each worker gets its own
+# SQLite file (Django/Pony) with a busy timeout, so there are no "database is
+# locked" failures.
 test:
-	uv run pytest -n 1 --cov=fastadmin --cov-report=term-missing --cov-report=xml -s tests
+	uv run pytest -n auto --cov=fastadmin --cov-report=term-missing --cov-report=xml tests
 	make -C frontend test
 
 cov: test

README.md

@@ -11,7 +11,8 @@
 **FastAdmin** is an easy-to-use **admin dashboard (admin panel) for FastAPI, Flask and
 Django**, inspired by Django Admin. It gives your Python web application a
 production-ready **CRUD admin interface** in minutes — on top of **Tortoise ORM,
-Django ORM, SQLAlchemy or Pony ORM** — with authentication, filters, search,
+Django ORM, SQLAlchemy, Pony ORM or [Yara ORM](https://github.com/vsdudakov/yara-orm)** —
+with authentication, filters, search,
 inline editing, file uploads, CSV/JSON export and dashboard charts out of the box.
 
 FastAdmin is built with relationships in mind and admiration for Django Admin.
@@ -31,7 +32,8 @@ already know FastAdmin.
 - **Any web framework** — mount as a FastAPI sub-app, a Flask blueprint or
   Django urlpatterns.
 - **Any ORM** — first-class admin classes for Tortoise ORM, Django ORM,
-  SQLAlchemy (async) and Pony ORM.
+  SQLAlchemy (async), Pony ORM and [Yara ORM](https://github.com/vsdudakov/yara-orm)
+  (a fast, Rust-engine async ORM).
 - **Authentication & permissions** — pluggable sign-in against your own user
   model, per-action permission hooks, request/user context in every admin method.
 - **Rich form widgets** — 20+ antd-based widgets (rich text, JSON, async
@@ -56,6 +58,7 @@ pip install fastadmin[fastapi,django]        # FastAPI with Django ORM
 pip install fastadmin[fastapi,tortoise-orm]  # FastAPI with Tortoise ORM
 pip install fastadmin[fastapi,pony]          # FastAPI with Pony ORM
 pip install fastadmin[fastapi,sqlalchemy]    # FastAPI with SQLAlchemy (includes greenlet)
+pip install fastadmin[fastapi,yara-orm]      # FastAPI with Yara ORM
 pip install fastadmin[django]                # Django with Django ORM
 pip install fastadmin[django,pony]           # Django with Pony ORM
 pip install fastadmin[flask,sqlalchemy]      # Flask with SQLAlchemy (includes greenlet)
@@ -147,11 +150,15 @@ Runnable example apps for every framework/ORM combination are in
 ## Why FastAdmin?
 
 If you are looking for a **Django-Admin-like admin panel for FastAPI**, an
-**admin interface for SQLAlchemy or Tortoise ORM**, or a lightweight
+**admin interface for SQLAlchemy, Tortoise ORM or
+[Yara ORM](https://github.com/vsdudakov/yara-orm)**, or a lightweight
 **alternative to building a custom back office**, FastAdmin gives you a
 batteries-included, themeable admin UI without code generation, without tying
 your app to a specific framework, and without writing a single React component.
 
+Pair it with [Yara ORM](https://github.com/vsdudakov/yara-orm) — our fast, async
+Python ORM with a Rust engine — for a high-performance FastAPI + admin stack.
+
 ## Contributing
 
 Contributions are welcome — see the

docs/api-reference.md

@@ -26,6 +26,7 @@ package.
 | `DjangoModelAdmin` / `DjangoInlineModelAdmin` | Django ORM admins. |
 | `SqlAlchemyModelAdmin` / `SqlAlchemyInlineModelAdmin` | SQLAlchemy (async) admins. |
 | `PonyORMModelAdmin` / `PonyORMInlineModelAdmin` | Pony ORM admins. |
+| `YaraOrmModelAdmin` / `YaraOrmInlineModelAdmin` | [Yara ORM](https://github.com/vsdudakov/yara-orm) admins. |
 
 Attributes are documented in [Model admins](guides/model-admins.md) and
 [Inline admins](guides/inline-admins.md).

docs/getting-started/installation.md

@@ -16,6 +16,7 @@ Install the package with the extras matching your web framework and ORM:
     pip install fastadmin[fastapi,tortoise-orm]  # FastAPI with Tortoise ORM
     pip install fastadmin[fastapi,pony]          # FastAPI with Pony ORM
     pip install fastadmin[fastapi,sqlalchemy]    # FastAPI with SQLAlchemy (includes greenlet)
+    pip install fastadmin[fastapi,yara-orm]      # FastAPI with Yara ORM
     pip install fastadmin[django]                # Django with Django ORM
     pip install fastadmin[django,pony]           # Django with Pony ORM
     pip install fastadmin[flask,sqlalchemy]      # Flask with SQLAlchemy (includes greenlet)
@@ -28,6 +29,7 @@ Install the package with the extras matching your web framework and ORM:
     uv add 'fastadmin[fastapi,tortoise-orm]'
     uv add 'fastadmin[fastapi,pony]'
     uv add 'fastadmin[fastapi,sqlalchemy]'
+    uv add 'fastadmin[fastapi,yara-orm]'
     uv add 'fastadmin[django]'
     uv add 'fastadmin[django,pony]'
     uv add 'fastadmin[flask,sqlalchemy]'
@@ -40,6 +42,7 @@ Install the package with the extras matching your web framework and ORM:
     poetry add 'fastadmin[fastapi,tortoise-orm]'
     poetry add 'fastadmin[fastapi,pony]'
     poetry add 'fastadmin[fastapi,sqlalchemy]'
+    poetry add 'fastadmin[fastapi,yara-orm]'
     poetry add 'fastadmin[django]'
     poetry add 'fastadmin[django,pony]'
     poetry add 'fastadmin[flask,sqlalchemy]'

docs/guides/registering-models.md

@@ -1,6 +1,6 @@
 ---
 title: Registering models
-description: Register ORM models with FastAdmin — complete runnable examples for Tortoise ORM, Django ORM, SQLAlchemy and Pony ORM.
+description: Register ORM models with FastAdmin — complete runnable examples for Tortoise ORM, Django ORM, SQLAlchemy, Pony ORM and Yara ORM.
 ---
 
 # Registering models
@@ -14,6 +14,7 @@ The admin base class must match your ORM:
 | Django ORM | `DjangoModelAdmin` | `DjangoInlineModelAdmin` |
 | SQLAlchemy | `SqlAlchemyModelAdmin` | `SqlAlchemyInlineModelAdmin` |
 | Pony ORM | `PonyORMModelAdmin` | `PonyORMInlineModelAdmin` |
+| [Yara ORM](https://github.com/vsdudakov/yara-orm) | `YaraOrmModelAdmin` | `YaraOrmInlineModelAdmin` |
 
 ```python
 from fastadmin import TortoiseModelAdmin, register
@@ -70,3 +71,9 @@ fields, uploads and dashboard widgets), authentication and app mounting.
     ```python
     --8<-- "examples/fastapi_ponyorm/example.py"
     ```
+
+=== "Yara ORM"
+
+    ```python
+    --8<-- "examples/fastapi_yaraorm/example.py"
+    ```

docs/index.md

@@ -1,6 +1,6 @@
 ---
 title: FastAdmin — Admin dashboard for FastAPI, Flask and Django
-description: FastAdmin is an easy-to-use admin dashboard for FastAPI, Flask and Django, inspired by Django Admin. Works with Tortoise ORM, Django ORM, SQLAlchemy and Pony ORM.
+description: FastAdmin is an easy-to-use admin dashboard for FastAPI, Flask and Django, inspired by Django Admin. Works with Tortoise ORM, Django ORM, SQLAlchemy, Pony ORM and Yara ORM.
 ---
 
 # FastAdmin
@@ -16,7 +16,8 @@ description: FastAdmin is an easy-to-use admin dashboard for FastAPI, Flask and
 FastAdmin is built with relationships in mind and admiration for Django Admin.
 Its design focuses on making it as easy as possible to configure an admin
 dashboard for **FastAPI**, **Flask** or **Django** on top of **Tortoise ORM**,
-**Django ORM**, **SQLAlchemy** or **Pony ORM**. It aims to be minimal,
+**Django ORM**, **SQLAlchemy**, **Pony ORM** or
+**[Yara ORM](https://github.com/vsdudakov/yara-orm)**. It aims to be minimal,
 functional and familiar.
 
 ![FastAdmin demo](assets/images/demo.gif)
@@ -56,7 +57,8 @@ app.mount("/admin", admin_app)
 - :jigsaw: **Framework-agnostic** — mount it into FastAPI, register it as a
   Flask blueprint or include it in Django urlpatterns.
 - :file_cabinet: **ORM-agnostic** — first-class admins for Tortoise ORM,
-  Django ORM, SQLAlchemy (async) and Pony ORM.
+  Django ORM, SQLAlchemy (async), Pony ORM and
+  [Yara ORM](https://github.com/vsdudakov/yara-orm) (a fast, Rust-engine async ORM).
 - :bar_chart: **Dashboard widgets** — declarative chart and action widgets
   (line, area, column, bar, pie) with filters, powered by antd charts.
 - :outbox_tray: **Uploads & exports** — file/image upload widgets with

examples/fastapi_yaraorm/Makefile

@@ -0,0 +1,10 @@
+all: install run
+
+.PHONY: fastapi
+run:
+	uv run uvicorn example:app --reload --host=0.0.0.0 --port=8090
+
+.PHONY: install
+install:
+	uv pip install fastadmin[fastapi] yara-orm uvicorn
+	uv pip install -e ../../

examples/fastapi_yaraorm/README.md

@@ -0,0 +1,21 @@
+# FastAdmin — FastAPI + Yara ORM example
+
+A minimal admin dashboard for a FastAPI app backed by
+[Yara ORM](https://github.com/vsdudakov/yara-orm) (a fast, async, Tortoise-style
+Python ORM with a Rust engine).
+
+## Run
+
+```bash
+make install
+make run
+```
+
+Then open <http://localhost:8090/admin> and sign in with `admin` / `admin`.
+
+The example registers `User`, `Tournament`, `BaseEvent` and `Event` admins,
+demonstrating foreign keys, one-to-one and many-to-many relations, an inline,
+bulk actions, display fields, a dashboard chart widget and file uploads.
+
+See the [FastAdmin documentation](https://vsdudakov.github.io/fastadmin/) for
+details.