mirror of
https://github.com/fastapiadmin/FastapiAdmin.git
synced 2026-09-21 12:52:26 +00:00
zhangtao
0ce31936aa
1. 删除无用文件与废弃代码：移除locale枚举、element-plus插件、sse路由、api token模块等 2. 简化类型导入与依赖：移除大量未使用的类型导入，统一echarts导入方式 3. 优化配置与样式：调整gitignore、样式引入顺序，新增列表动画样式 4. 修复接口与模型：修正接口返回类型、查询参数配置，更新部门模型字段 5. 优化性能与体验：添加图片懒加载，优化加载逻辑与表格渲染 6. 调整环境配置：新增并更新开发/生产环境配置文件
127 lines
3.5 KiB
Python
Executable File
127 lines
3.5 KiB
Python
Executable File
import os
|
|
from typing import Annotated
|
|
|
|
import typer
|
|
import uvicorn
|
|
from alembic import command
|
|
from alembic.config import Config
|
|
from fastapi import FastAPI
|
|
|
|
from app.common.enums import EnvironmentEnum
|
|
from app.config.setting import settings
|
|
from app.utils.banner import worship
|
|
|
|
fastapiadmin_cli = typer.Typer()
|
|
alembic_cfg = Config("alembic.ini")
|
|
|
|
|
|
def create_app() -> FastAPI:
|
|
"""创建 FastAPI 应用实例并完成日志、中间件、路由与静态资源注册。
|
|
|
|
返回:
|
|
- FastAPI: 已配置生命周期的应用对象。
|
|
"""
|
|
from app.init_app import lifespan, register_docs, register_exceptions, register_frontend, register_middlewares, register_routers, register_static
|
|
|
|
# 创建FastAPI应用
|
|
app = FastAPI(**settings.FASTAPI_CONFIG, lifespan=lifespan)
|
|
# 注册异常处理器
|
|
register_exceptions(app)
|
|
# 注册中间件
|
|
register_middlewares(app)
|
|
# 注册路由
|
|
register_routers(app)
|
|
# 注册静态文件
|
|
register_static(app)
|
|
# 注册API文档（豁免限流）
|
|
register_docs(app)
|
|
# 注册前端
|
|
register_frontend(app)
|
|
return app
|
|
|
|
|
|
# typer.Option是非必填；typer.Argument是必填
|
|
@fastapiadmin_cli.command(
|
|
name="run",
|
|
help="启动 FastapiAdmin 服务, 运行 uv run main.py run --env=dev 不加参数默认 dev 环境",
|
|
)
|
|
def run(
|
|
env: Annotated[EnvironmentEnum, typer.Option("--env", help="运行环境 (dev, prod)")] = EnvironmentEnum.DEV,
|
|
) -> None:
|
|
"""按指定环境加载配置并启动 Uvicorn（开发环境开启 reload）。
|
|
|
|
参数:
|
|
- env (EnvironmentEnum): 运行环境，对应 `--env`。
|
|
|
|
返回:
|
|
- None
|
|
"""
|
|
# 设置环境变量（必须在 import settings 之前，确保加载正确环境）
|
|
os.environ["ENVIRONMENT"] = env.value
|
|
|
|
typer.secho(
|
|
message=f"{worship()}",
|
|
fg=typer.colors.GREEN,
|
|
)
|
|
|
|
# 启动uvicorn服务
|
|
uvicorn.run(
|
|
app="main:create_app",
|
|
host=settings.SERVER_HOST,
|
|
port=settings.SERVER_PORT,
|
|
reload=env.value == EnvironmentEnum.DEV.value,
|
|
factory=True,
|
|
log_config=None,
|
|
timeout_graceful_shutdown=5,
|
|
)
|
|
|
|
|
|
@fastapiadmin_cli.command(
|
|
name="revision",
|
|
help="生成新的 Alembic 迁移脚本, 运行 python main.py revision --env=dev",
|
|
)
|
|
def revision(
|
|
env: Annotated[EnvironmentEnum, typer.Option("--env", help="运行环境 (dev, prod)")] = EnvironmentEnum.DEV,
|
|
) -> None:
|
|
"""使用 Alembic 自动生成迁移脚本（autogenerate）。
|
|
|
|
参数:
|
|
- env (EnvironmentEnum): 运行环境，用于加载对应数据库模型元数据。
|
|
|
|
返回:
|
|
- None
|
|
"""
|
|
os.environ["ENVIRONMENT"] = env.value
|
|
from app.config.setting import get_settings
|
|
|
|
get_settings.cache_clear()
|
|
command.revision(alembic_cfg, autogenerate=True, message="迁移脚本")
|
|
typer.echo("迁移脚本已生成")
|
|
|
|
|
|
@fastapiadmin_cli.command(
|
|
name="upgrade",
|
|
help="应用最新的 Alembic 迁移, 运行 python main.py upgrade --env=dev",
|
|
)
|
|
def upgrade(
|
|
env: Annotated[EnvironmentEnum, typer.Option("--env", help="运行环境 (dev, prod)")] = EnvironmentEnum.DEV,
|
|
) -> None:
|
|
"""将数据库升级到 Alembic 最新版本（head）。
|
|
|
|
参数:
|
|
- env (EnvironmentEnum): 运行环境。
|
|
|
|
返回:
|
|
- None
|
|
"""
|
|
os.environ["ENVIRONMENT"] = env.value
|
|
from app.config.setting import get_settings
|
|
|
|
get_settings.cache_clear()
|
|
command.upgrade(alembic_cfg, "head")
|
|
typer.echo("所有迁移已应用。")
|
|
|
|
|
|
if __name__ == "__main__":
|
|
fastapiadmin_cli()
|