FastAPI CLI 技术文档
概述
FastAPI CLI 是一个命令行工具,旨在帮助用户从命令行运行和管理 FastAPI 应用程序。通过 FastAPI CLI,用户可以轻松启动开发服务器、管理项目以及在生产环境中运行应用程序。
安装指南
系统要求
- Python 3.8 或更高版本
安装步骤
-
使用 pip 安装 FastAPI CLI
你可以通过以下命令安装 FastAPI CLI:
pip install fastapi-cli
如果你已经安装了 FastAPI,FastAPI CLI 会作为 FastAPI 的一部分自动安装。
-
验证安装
安装完成后,你可以通过以下命令验证安装是否成功:
fastapi --version
如果安装成功,你应该会看到 FastAPI CLI 的版本信息。
项目使用说明
启动开发服务器
在开发模式下启动 FastAPI 应用程序,可以使用以下命令:
fastapi dev main.py
该命令会自动检测并导入你的 FastAPI 应用程序,并在 http://127.0.0.1:8000
上启动开发服务器。开发服务器默认启用自动重载功能,以便在代码更改时自动重启服务器。
启动生产服务器
在生产环境中运行 FastAPI 应用程序,可以使用以下命令:
fastapi run main.py
该命令会以生产模式启动服务器,默认禁用自动重载功能,并监听所有可用的 IP 地址(0.0.0.0
),以便应用程序可以被公开访问。
项目 API 使用文档
fastapi dev
命令
- 描述: 在开发模式下启动 FastAPI 应用程序。
- 参数:
main.py
: 你的 FastAPI 应用程序的主文件路径。
- 选项:
--reload
: 启用自动重载功能(默认启用)。--host
: 指定服务器监听的 IP 地址(默认127.0.0.1
)。--port
: 指定服务器监听的端口(默认8000
)。
fastapi run
命令
- 描述: 在生产模式下启动 FastAPI 应用程序。
- 参数:
main.py
: 你的 FastAPI 应用程序的主文件路径。
- 选项:
--host
: 指定服务器监听的 IP 地址(默认0.0.0.0
)。--port
: 指定服务器监听的端口(默认8000
)。
项目安装方式
FastAPI CLI 可以通过 pip
安装,安装命令如下:
pip install fastapi-cli
如果你已经安装了 FastAPI,FastAPI CLI 会作为 FastAPI 的一部分自动安装。
许可证
本项目基于 MIT 许可证开源。详细信息请参阅 LICENSE 文件。
通过以上文档,你应该能够顺利安装和使用 FastAPI CLI 来管理你的 FastAPI 应用程序。如果在使用过程中遇到任何问题,请参考 FastAPI 官方文档 或 FastAPI CLI GitHub 仓库 获取更多帮助。