brilliance-admin 0.43.5__tar.gz → 0.43.7__tar.gz

{brilliance_admin-0.43.5 → brilliance_admin-0.43.7}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: brilliance-admin
-Version: 0.43.5
-Summary: Simple and lightweight admin panel framework powered by FastAPI and Vue3 Vuetify together.. Some call it heavenly in its brilliance.
+Version: 0.43.7
+Summary: Simple and lightweight admin panel framework powered by FastAPI and Vue3 Vuetify together. Some call it heavenly in its brilliance.
 License-Expression: AGPL-3.0
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -76,9 +76,11 @@ Focused on simplified, but rich configuration.
 * **SQLAlchemy** - schema autogeneration for tables + CRUD operations + authorization
 
 **Planned:**
-* Role-based access control system
-* Nested data support for creation and detail views
-* Django ORM inegration
+* Dashboard features
+* Role-based access permissions system via interface
+* Backend interface for storing and viewing action history in the admin interface
+* Nested data support for creation and detail views (inline editing), nested CRUD workflows
+* Django ORM integration
 
 ## How to use it
 
@@ -202,13 +204,14 @@ auth = sqlalchemy.SQLAlchemyJWTAdminAuthentication(
 
 ## Comparison of Similar Projects
 
-| Criterion | Brilliance Admin | Django Admin/Unfold | FastAPI Admin | Starlette Admin |
-|---------|------------------|---------------|---------------|-----------------|
-| Base framework | FastAPI | Django | FastAPI | Starlette / FastAPI |
-| Rendering model | Prebuilt Vue 3 + Vuetify SPA + Jinja2 | Server-side Django templates | Server-side Jinja2 templates + Tabler UI | Server-side Jinja2 templates + Tabler UI |
-| Frontend architecture | Separate frontend (SPA) | Classic server-rendered UI | Server-rendered UI with JS interactivity | Server-rendered UI with JS interactivity |
-| Data source | Any source + SQLAlchemy | Django ORM | Tortoise ORM | Any source + SQLAlchemy, MongoDB |
-| Multiple databases per model | Yes | Database routers | No (global engine) | Yes (session per ModelView) |
-| Schema generation | User-defined format | From Django models | From ORM models | User-defined format |
-| Async support | Yes | No | Yes | Yes |
-| API-first approach | Yes | No | Partially | Partially |
+| Criterion | Brilliance Admin | Django Admin | FastAPI Admin | Starlette Admin | SQLAdmin |
+|---------|------------------|---------------------|---------------|-----------------|----------|
+| Base framework | FastAPI | Django | FastAPI | Starlette / FastAPI | FastAPI / Starlette |
+| Rendering model | Prebuilt Vue 3 + Vuetify SPA + Jinja2 | Server-side Django templates | Server-side Jinja2 templates + Tabler UI | Server-side Jinja2 templates + Tabler UI | Server-side Jinja2 templates + Bootstrap |
+| Frontend architecture | Separate frontend (SPA) | Classic server-rendered UI | Server-rendered UI with JS interactivity | Server-rendered UI with JS interactivity | Server-rendered UI |
+| Data source | Any source + SQLAlchemy | Django ORM | Tortoise ORM | Any source + SQLAlchemy, MongoDB | SQLAlchemy |
+| Multiple databases per model | Yes | Database routers | No (global engine) | Yes (session per ModelView) | No (single engine per Admin) |
+| Schema generation | User-defined format | From Django models | From ORM models | User-defined format | From SQLAlchemy models |
+| Async support | Yes | No | Yes | Yes | Yes |
+| API-first approach | Yes | No | Partially | Partially | No |
+| Built-in Localization | Yes | Yes | No | No | No |

{brilliance_admin-0.43.5 → brilliance_admin-0.43.7}/README.md

@@ -45,9 +45,11 @@ Focused on simplified, but rich configuration.
 * **SQLAlchemy** - schema autogeneration for tables + CRUD operations + authorization
 
 **Planned:**
-* Role-based access control system
-* Nested data support for creation and detail views
-* Django ORM inegration
+* Dashboard features
+* Role-based access permissions system via interface
+* Backend interface for storing and viewing action history in the admin interface
+* Nested data support for creation and detail views (inline editing), nested CRUD workflows
+* Django ORM integration
 
 ## How to use it
 
@@ -171,13 +173,14 @@ auth = sqlalchemy.SQLAlchemyJWTAdminAuthentication(
 
 ## Comparison of Similar Projects
 
-| Criterion | Brilliance Admin | Django Admin/Unfold | FastAPI Admin | Starlette Admin |
-|---------|------------------|---------------|---------------|-----------------|
-| Base framework | FastAPI | Django | FastAPI | Starlette / FastAPI |
-| Rendering model | Prebuilt Vue 3 + Vuetify SPA + Jinja2 | Server-side Django templates | Server-side Jinja2 templates + Tabler UI | Server-side Jinja2 templates + Tabler UI |
-| Frontend architecture | Separate frontend (SPA) | Classic server-rendered UI | Server-rendered UI with JS interactivity | Server-rendered UI with JS interactivity |
-| Data source | Any source + SQLAlchemy | Django ORM | Tortoise ORM | Any source + SQLAlchemy, MongoDB |
-| Multiple databases per model | Yes | Database routers | No (global engine) | Yes (session per ModelView) |
-| Schema generation | User-defined format | From Django models | From ORM models | User-defined format |
-| Async support | Yes | No | Yes | Yes |
-| API-first approach | Yes | No | Partially | Partially |
+| Criterion | Brilliance Admin | Django Admin | FastAPI Admin | Starlette Admin | SQLAdmin |
+|---------|------------------|---------------------|---------------|-----------------|----------|
+| Base framework | FastAPI | Django | FastAPI | Starlette / FastAPI | FastAPI / Starlette |
+| Rendering model | Prebuilt Vue 3 + Vuetify SPA + Jinja2 | Server-side Django templates | Server-side Jinja2 templates + Tabler UI | Server-side Jinja2 templates + Tabler UI | Server-side Jinja2 templates + Bootstrap |
+| Frontend architecture | Separate frontend (SPA) | Classic server-rendered UI | Server-rendered UI with JS interactivity | Server-rendered UI with JS interactivity | Server-rendered UI |
+| Data source | Any source + SQLAlchemy | Django ORM | Tortoise ORM | Any source + SQLAlchemy, MongoDB | SQLAlchemy |
+| Multiple databases per model | Yes | Database routers | No (global engine) | Yes (session per ModelView) | No (single engine per Admin) |
+| Schema generation | User-defined format | From Django models | From ORM models | User-defined format | From SQLAlchemy models |
+| Async support | Yes | No | Yes | Yes | Yes |
+| API-first approach | Yes | No | Partially | Partially | No |
+| Built-in Localization | Yes | Yes | No | No | No |

{brilliance_admin-0.43.5 → brilliance_admin-0.43.7}/brilliance_admin/integrations/sqlalchemy/__init__.py

@@ -1,5 +1,6 @@
 # pylint: disable=wildcard-import, unused-wildcard-import, unused-import
 # flake8: noqa: F405
+from .fields import SQLAlchemyRelatedField
 from .auth import SQLAlchemyJWTAdminAuthentication
 from .autocomplete import SQLAlchemyAdminAutocompleteMixin
 from .fields_schema import SQLAlchemyFieldsSchema

{brilliance_admin-0.43.5 → brilliance_admin-0.43.7}/brilliance_admin/integrations/sqlalchemy/autocomplete.py

@@ -32,7 +32,11 @@ class SQLAlchemyAdminAutocompleteMixin:
         if not field:
             raise Exception(f'Field "{data.field_slug}" is not found')
 
-        async with self.db_async_session() as session:
-            results = await field.autocomplete(self.model, data, user, extra={'db_session': session})
+        results = await field.autocomplete(
+            self.model,
+            data,
+            user,
+            extra={'db_async_session': self.db_async_session},
+        )
 
         return AutocompleteResult(results=results)

{brilliance_admin-0.43.5 → brilliance_admin-0.43.7}/brilliance_admin/integrations/sqlalchemy/fields.py

@@ -43,7 +43,7 @@ class SQLAlchemyRelatedField(TableField):
     # - для доступа к связи через ORM
     #   getattr(record, rel_name)
     # - для записи и чтения связанных объектов
-    rel_name: str | None = None
+    rel_name: str | None
 
     # Класс связанной SQLAlchemy-модели.
     # Откуда берётся:
@@ -101,11 +101,11 @@ class SQLAlchemyRelatedField(TableField):
         from sqlalchemy import select
         from sqlalchemy.sql import expression
 
-        if extra is None or extra.get('db_session') is None:
-            msg = f'SQLAlchemyRelatedField.autocomplete {type(self).__name__} requires extra["db_session"] (AsyncSession)'
+        if extra is None or extra.get('db_async_session') is None:
+            msg = f'SQLAlchemyRelatedField.autocomplete {type(self).__name__} requires extra["db_async_session"] (AsyncSession)'
             raise AttributeError(msg)
 
-        session = extra['db_session']
+        db_async_session = extra['db_async_session']
 
         results = []
 
@@ -125,7 +125,9 @@ class SQLAlchemyRelatedField(TableField):
         if existed_choices and hasattr(target_model, 'id'):
             stmt = stmt.where(getattr(target_model, 'id').in_(existed_choices) | expression.true())
 
-        records = (await session.execute(stmt)).scalars().all()
+        async with db_async_session() as session:
+            records = (await session.execute(stmt)).scalars().all()
+
         for record in records:
             results.append(Record(key=getattr(record, 'id'), title=str(record)))
 
@@ -146,18 +148,15 @@ class SQLAlchemyRelatedField(TableField):
         if record is None:
             raise FieldError(f'Missing record in serialize context in value: {value}')
 
+        related = getattr(record, self.rel_name, None)
+
         if self.many:
-            related = getattr(record, self.rel_name, None)
             if related is None:
-                msg = f'Many Related field "{self.rel_name}" is missing on record "{record}" (many=True)'
-                raise FieldError(msg)
-
+                raise FieldError(f'Many Related field "{self.rel_name}" is missing on record "{record}"')
             return [{'key': get_pk(obj), 'title': str(obj)} for obj in related]
 
-        related = getattr(record, self.rel_name, None)
         if related is None:
-            msg = f'Related field "{self.rel_name}" is missing on record "{record}" (many=False)'
-            raise FieldError(msg)
+            return None
 
         return {'key': get_pk(related), 'title': str(related)}
 

{brilliance_admin-0.43.5 → brilliance_admin-0.43.7}/brilliance_admin/schema/category.py

@@ -7,7 +7,7 @@ from pydantic_core import core_schema
 
 from brilliance_admin.auth import UserABC
 from brilliance_admin.translations import LanguageContext
-from brilliance_admin.utils import DataclassBase, SupportsStr
+from brilliance_admin.utils import DataclassBase, SupportsStr, humanize_field_name
 
 
 # pylint: disable=too-many-instance-attributes
@@ -125,7 +125,7 @@ class Category(abc.ABC):
 
     def generate_schema(self, user: UserABC, language_context: LanguageContext) -> CategorySchemaData:
         return CategorySchemaData(
-            title=language_context.get_text(self.title) or self.slug,
+            title=language_context.get_text(self.title) or humanize_field_name(self.slug),
             description=language_context.get_text(self.description),
             icon=self.icon,
             type=self._type_slug,

{brilliance_admin-0.43.5 → brilliance_admin-0.43.7}/brilliance_admin/schema/group.py

@@ -6,7 +6,7 @@ from pydantic.dataclasses import dataclass
 from brilliance_admin.auth import UserABC
 from brilliance_admin.schema.category import Category, CategorySchemaData
 from brilliance_admin.translations import LanguageContext
-from brilliance_admin.utils import DataclassBase, SupportsStr, get_logger
+from brilliance_admin.utils import DataclassBase, SupportsStr, get_logger, humanize_field_name
 
 logger = get_logger()
 
@@ -36,7 +36,7 @@ class Group(abc.ABC):
 
     def generate_schema(self, user: UserABC, language_context: LanguageContext) -> GroupSchemaData:
         result = GroupSchemaData(
-            title=language_context.get_text(self.title) or self.slug,
+            title=language_context.get_text(self.title) or humanize_field_name(self.slug),
             description=language_context.get_text(self.description),
             icon=self.icon,
             categories={},