Sean's Python3 Flask Rest Boilerplate 教程
1. 项目的目录结构及介绍
Seans-Python3-Flask-Rest-Boilerplate/
├── app/
│ ├── __init__.py
│ ├── models.py
│ ├── routes.py
│ └── utils.py
├── config/
│ ├── __init__.py
│ ├── development.py
│ ├── production.py
│ └── testing.py
├── migrations/
├── requirements.txt
├── run.py
└── .env
- app/: 包含应用程序的主要代码。
- init.py: 初始化Flask应用。
- models.py: 定义数据库模型。
- routes.py: 定义路由和视图函数。
- utils.py: 包含实用工具函数。
- config/: 包含配置文件。
- init.py: 配置文件初始化。
- development.py: 开发环境配置。
- production.py: 生产环境配置。
- testing.py: 测试环境配置。
- migrations/: 数据库迁移文件。
- requirements.txt: 项目依赖包列表。
- run.py: 项目启动文件。
- .env: 环境变量配置文件。
2. 项目的启动文件介绍
run.py 是项目的启动文件,负责启动Flask应用。以下是 run.py
的主要内容:
from app import create_app
app = create_app()
if __name__ == '__main__':
app.run(debug=True)
- from app import create_app: 从
app
模块导入create_app
函数。 - app = create_app(): 创建Flask应用实例。
- if name == 'main':: 确保脚本作为主程序运行时才执行。
- app.run(debug=True): 以调试模式启动应用。
3. 项目的配置文件介绍
配置文件位于 config/
目录下,包含不同环境的配置。
- development.py: 开发环境配置。
- production.py: 生产环境配置。
- testing.py: 测试环境配置。
每个配置文件定义了不同的配置参数,例如数据库连接、调试模式等。以下是 development.py
的示例:
import os
class Config:
DEBUG = True
SQLALCHEMY_DATABASE_URI = os.getenv('DATABASE_URL', 'sqlite:///dev.db')
SQLALCHEMY_TRACK_MODIFICATIONS = False
- DEBUG = True: 启用调试模式。
- SQLALCHEMY_DATABASE_URI: 数据库连接URI。
- SQLALCHEMY_TRACK_MODIFICATIONS: 禁用SQLAlchemy的修改跟踪。
通过这些配置文件,可以轻松地在不同环境之间切换,确保应用在不同环境下的正确运行。