FastAPI-Utils 教程:安装与使用
fastapi-utilsReusable utilities for FastAPI项目地址:https://gitcode.com/gh_mirrors/fa/fastapi-utils
1. 项目目录结构及介绍
FastAPI-Utils 是一个用于增强 FastAPI 应用的工具集,其典型的项目目录结构可能如下:
your_project/
├── app/
│ ├── main.py # 主入口文件(启动文件)
│ └── config.py # 配置文件
├── db/ # 数据库相关代码
├── models/ # 模型定义
├── tests/ # 测试用例
├── requirements.txt # 依赖项列表
└── README.md # 项目说明文件
-
app
: 包含应用的核心代码,如路由、中间件等。main.py
: 启动文件,导入并设置 FastAPI 实例。config.py
: 存放应用程序的配置参数。
-
db
: 数据库相关的代码,如数据库模型和连接管理。 -
models
: 定义业务对象的 Python 类,通常对应数据库表。 -
tests
: 单元测试和其他测试脚本。 -
requirements.txt
: 项目依赖包清单。 -
README.md
: 项目的描述和指南。
2. 项目的启动文件介绍
在 app/main.py
文件中,一般你会看到类似以下的代码用来初始化 FastAPI 应用并引入自定义组件:
from fastapi import FastAPI
from .config import settings
from .routers import routers
app = FastAPI(title=settings.PROJECT_NAME)
app.include_router(routers.router)
这里:
FastAPI
初始化实例,你可以设置应用名称。include_router
用于添加路由器,routers.router
是包含多个路由规则的路由器对象。config.settings
引入配置文件中的设置。
3. 项目的配置文件介绍
app/config.py
中的配置文件通常以字典或其他数据结构存储,允许动态修改应用行为。例如:
class Settings(BaseSettings):
PROJECT_NAME: str
API_VERSION: str = "v1"
DATABASE_URL: str
SECRET_KEY: str
JWT_ACCESS_TOKEN_EXPIRE_MINUTES: int
settings = Settings()
在这里,我们定义了一个 Settings
类,继承自 BaseSettings
(可能来自第三方库如 pydantic)。这个类包含了应用的各种配置属性,如项目名、API 版本、数据库URL、JWT密钥和令牌过期时间等。创建一个实例 settings
来全局访问这些配置。
要使用这些配置,只需在其他文件中导入 settings
并按需使用,例如在数据库连接或认证部分。
注意:具体的目录结构和文件内容可能会因项目需求和开发者习惯有所不同,上述仅提供一个通用的示例。实际项目中可能还包括错误处理、日志配置、中间件等功能模块。
fastapi-utilsReusable utilities for FastAPI项目地址:https://gitcode.com/gh_mirrors/fa/fastapi-utils