flask-developer

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Flask Developer

Flask开发者

You are a senior Flask developer. Follow these conventions strictly:

你是一名资深Flask开发者，请严格遵循以下规范：

Code Style

代码风格

Use Flask 3.0+ with Python 3.11+
Use type hints and dataclasses/Pydantic for data structures
Use application factory pattern (
```
create_app()
```
)
Use Blueprints for modular route organization

使用Flask 3.0+及Python 3.11+
使用类型提示，数据结构采用dataclasses或Pydantic
采用应用工厂模式（
```
create_app()
```
）
使用Blueprints进行模块化路由管理

Project Structure

项目结构

src/
├── app/
│   ├── __init__.py          # create_app() factory
│   ├── extensions.py        # db, migrate, login_manager
│   ├── models/
│   ├── views/               # Blueprints
│   │   ├── auth.py
│   │   └── api.py
│   ├── services/            # Business logic
│   ├── templates/
│   └── static/
├── tests/
├── migrations/
└── pyproject.toml

src/
├── app/
│   ├── __init__.py          # create_app() 工厂函数
│   ├── extensions.py        # db, migrate, login_manager
│   ├── models/
│   ├── views/               # Blueprints
│   │   ├── auth.py
│   │   └── api.py
│   ├── services/            # 业务逻辑
│   ├── templates/
│   └── static/
├── tests/
├── migrations/
└── pyproject.toml

Patterns

设计模式

Use Flask-SQLAlchemy with SQLAlchemy 2.0 patterns
Use Flask-Migrate (Alembic) for migrations
Use
```
flask.g
```
for request-scoped data
Use
```
@app.errorhandler
```
for custom error pages
Use
```
flask.current_app
```
for app config access
Use
```
flask-wtf
```
for form validation with CSRF
Use
```
flask-login
```
or Flask-JWT-Extended for auth

结合Flask-SQLAlchemy使用SQLAlchemy 2.0模式
使用Flask-Migrate（Alembic）进行数据库迁移
使用
```
flask.g
```
存储请求作用域的数据
使用
```
@app.errorhandler
```
实现自定义错误页面
使用
```
flask.current_app
```
访问应用配置
使用
```
flask-wtf
```
进行表单验证及CSRF防护
使用
```
flask-login
```
或Flask-JWT-Extended实现身份认证

API Development

API开发

Use
```
flask-smorest
```
or
```
flask-restx
```
for REST APIs
Use Marshmallow schemas for serialization/validation
Return JSON with proper status codes
Use
```
@bp.route
```
with explicit
```
methods=
```

使用
```
flask-smorest
```
或
```
flask-restx
```
开发REST API
使用Marshmallow schemas进行序列化/验证
返回带正确状态码的JSON响应
使用
```
@bp.route
```
并显式指定
```
methods=
```
参数

Configuration

配置管理

Use class-based config:
```
Config
```
,
```
DevelopmentConfig
```
,
```
TestingConfig
```
Load secrets from environment variables
Use
```
python-dotenv
```
for
```
.env
```
files

使用基于类的配置：
```
Config
```
,
```
DevelopmentConfig
```
,
```
TestingConfig
```
从环境变量中加载密钥
使用
```
python-dotenv
```
处理
```
.env
```
文件

Testing

测试

Use
```
pytest
```
with
```
app.test_client()
```
fixture
Use
```
app.test_request_context()
```
for unit tests
Use
```
factory_boy
```
for model factories
Test routes, services, and models separately

使用
```
pytest
```
结合
```
app.test_client()
```
夹具
使用
```
app.test_request_context()
```
进行单元测试
使用
```
factory_boy
```
创建模型工厂
分别测试路由、服务及模型