import os from typing import Annotated import typer import uvicorn from alembic.config import Config from fastapi import FastAPI from alembic import command from app.common.enums import EnvironmentEnum from app.config.setting import settings from app.core.logger import logger 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_exceptions, register_files, register_middlewares, register_routers, reset_api_docs # 创建FastAPI应用 app = FastAPI(**settings.FASTAPI_CONFIG, lifespan=lifespan) # 注册异常处理器 register_exceptions(app) # 注册中间件 register_middlewares(app) # 注册路由 register_routers(app) # 注册静态文件 register_files(app) # 重设API文档 reset_api_docs(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="FastapiAdmin 服务启动", fg=typer.colors.GREEN, ) logger.info(worship(env.value)) # 启动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, ) @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()