How to start

To launch the admin panel you need to:

1. Install the package
2. Describe your AdminSchema schema (tables, groups, authentication etc)
3. Mount it to ASGI app to your backend

Installation

To get started, install the brilliance-admin package using any package manager:

pip install brilliance-admin

Create AdminSchema instance

You need to generate AdminSchema (see AdminSchema) instance:

from brilliance_admin import schema

# SQLAlchemy example
class UserAdmin(sqlalchemy.SQLAlchemyAdmin):
    model = User

admin_schema = schema.AdminSchema(
    title='Admin Panel',
    auth=YourAdminAuthentication(),
    groups=[
        schema.Group(slug='example', categories=[UserAdmin()]),
    ],
)

admin_app = admin_schema.generate_app()

After that you need to plug it to ASGI server.

Integration with ASGI frameworks

FastAPI

from fastapi import FastAPI
from your_project.admin import admin_app

app = FastAPI()
app.mount('/admin', admin_app)

An example of integration with FastAPI can be found here.

Starlette

from starlette.applications import Starlette
from starlette.routing import Mount

from your_project.admin import admin_app

app = Starlette(
    routes=[
        Mount('/admin', admin_app),
    ],
)

LightStar

from lightstar import LightStar, Mount
from your_project.admin import admin_app

app = LightStar(
    routes=[
        Mount('/admin', admin_app),
    ],
)

Django ASGI

Can work with uvicorn, daphne, hypercorn

asgi.py

import os

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'your_project.settings')

from django.core.asgi import get_asgi_application
from starlette.applications import Starlette
from starlette.routing import Mount

django_app = get_asgi_application()

from your_project.admin import admin_app


application = Starlette(
    routes=[
        Mount('/admin', app=admin_app),
        Mount('/', app=django_app),
    ]
)