pip install fastapi_amis_admin

pip install fastapi_amis_admin[sqlmodel]

from fastapi import FastAPI
from fastapi_amis_admin.admin.settings import Settings
from fastapi_amis_admin.admin.site import AdminSite

# Создание приложения FastAPI
app = FastAPI()

# Создание экземпляра AdminSite
site = AdminSite(settings=Settings(database_url_async='sqlite+aiosqlite:///amisadmin.db'))

# Подключение административной панели
site.mount_app(app)

if __name__ == '__main__':
    import uvicorn

    uvicorn.run(app)
```## Пример управления моделями

### Создание модели

- Поддерживает модели `SQLModel`, `SQLAlchemy` и `SQLAlchemy 2.0`.
- Метод 1: Создание модели через `SQLModel`.

```python
from sqlmodel import SQLModel
from fastapi_amis_admin.models.fields import Field

from sqlmodel import SQLModel
import sqlmodel


class Base(sqlmodel.SQLModel):
    pass


# Создание модели SQLModel, подробнее см.: https://sqlmodel.tiangolo.com/
class Категория(sqlmodel.SQLModel, table=True):
    id: int = sqlmodel.Field(default=None, primary_key=True, nullable=False)
    имя: str = sqlmodel.Field(title='Название категории', max_length=100, unique=True, index=True, nullable=False)
    описание: str = sqlmodel.Field(default='', title='Описание', max_length=255)


# Второй способ: создание модели через SQLAlchemy
from sqlalchemy import Column, Integer, String
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

# Создание модели SQLAlchemy, подробнее см.: https://docs.sqlalchemy.org/en/14/orm/tutorial.html
class Категория(Base):
    __tablename__ = 'категория'
    __pydantic_model__ = КатегорияSchema  # Указание соответствующего Schema класса. Опционально, но рекомендовано.

    id = Column(Integer, primary_key=True, nullable=False)
    имя = Column(String(100), unique=True, index=True, nullable=False)
    описание = Column(String(255), default='')


# Третий способ: создание модели через SQLAlchemy 2.0
from sqlalchemy import String
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column

class Base(DeclarativeBase):
    pass

# Создание модели SQLAlchemy 2.0, подробнее см.: https://docs.sqlalchemy.org/en/20/orm/quickstart.html
class Категория(Base):
    __tablename__ = "категория"
    __pydantic_model__ = КатегорияSchema  # Указание соответствующего Schema класса. Опционально, но рекомендовано.
```    id: Mapped[int] = mapped_column(primary_key=True, nullable=False)
    имя: Mapped[str] = mapped_column(String(100), unique=True, index=True, nullable=False)
    описание: Mapped[str] = mapped_column(String(255), default="")

# Если вы используете SQLAlchemy для создания моделей, рекомендуется также создать соответствующую модель Pydantic,
# и установить `orm_mode=True`.

from pydantic import BaseModel, Field

class КатегорияSchema(BaseModel):
    id: int = Field(default=None, primary_key=True, nullable=False)
    имя: str = Field(title="Название категории")
    описание: str = Field(default="", title="Описание категории")

    class Config:
        orm_mode = True

from fastapi import FastAPI
from sqlmodel import SQLModel
from fastapi_amis_admin.admin.settings import Settings
from fastapi_amis_admin.admin.site import AdminSite
from fastapi_amis_admin.admin import admin

uvicorn.run(app)

from typing import Any
from fastapi import FastAPI
from pydantic import BaseModel
from starlette.requests import Request
from fastapi_amis_admin.amis.components import Form
from fastapi_amis_admin.admin import admin
from fastapi_amis_admin.admin.settings import Settings
from fastapi_amis_admin.admin.site import AdminSite
from fastapi_amis_admin.crud.schema import BaseApiOut
from fastapi_amis_admin.models.fields import Field
```# Создание приложения FastAPI
app = FastAPI()

# Создание экземпляра AdminSite
site = AdminSite(settings=Settings(database_url_async="sqlite+aiosqlite:///amisadmin.db"))

# Регистрация формы UserLoginFormAdmin
@site.register_admin
class UserLoginFormAdmin(admin.FormAdmin):
    page_schema = "UserLoginForm"
    # Конфигурирование формы, можно пропустить
    form = Form(title="Это тестовый логинный форма", submit_text="Войти")

    # Создание модели данных формы
    class Schema(BaseModel):
        username: str = Field(..., title="Имя пользователя", min_length=3, max_length=30)
        password: str = Field(..., title="Пароль")

    # Обработка отправленных данных формы
    async def handle(self, request: Request, data: BaseModel, **kwargs) -> BaseApiOut[Any]:
        if data.username == "amisadmin" and data.password == "amisadmin":
            return BaseApiOut(msg="Вы успешно вошли!", data={"token": "xxxxxx"})
        return BaseApiOut(status=-1, msg="Неправильное имя пользователя или пароль!")

# Подключение административной панели к приложению
site.mount_app(app)

if __name__ == "__main__":
    import uvicorn

    uvicorn.run(app)


## Использование командной строки

```bash
# Установка расширения командной строки
pip install fastapi_amis_admin[cli]

# Просмотр справки
faa --help

# Инициализация проекта FastAPI-Amis-Admin
faa new project_name --init