SuperAPI AI 工具集

framework-integrations

通用与其它

查看项目

更新于 10-16 05:53

技能介绍

本技能用于把 Celery 集成到 Django、Flask、FastAPI 中,采用各框架特定的模式与最佳实践。适用触发场景包括:为三个框架配置 Celery、任务中的应用上下文问题、数据库事务处理、框架特定配置、异步 worker 搭建、后台任务中的请求上下文等。

主要能力:提供三类框架集成模板(templates/django-integration/、templates/flask-integration/、templates/fastapi-integration/),以及事务安全模板(transaction-safe-django.py)、FastAPI 后台任务对比模板(fastapi-background.py)、Flask 任务内应用上下文模板(flask-context.py);并提供集成测试脚本 scripts/test-integration.sh 与配置校验脚本 scripts/validate-framework.sh,以及完整示例。

必要用法:Django 侧安装 pip install celery django-celery-beat django-celery-results,模板可复制使用,任务应传主键而非模型实例、在任务内重新加载,事务相关用 transaction.on_commit() 延迟执行,配置 CELERY_BROKER_URL 与 CELERY_RESULT_BACKEND,可用 django-celery-beat 做定时任务、django-celery-results 存储结果;Flask 侧安装 pip install celery flask,采用工厂模式,任务中用 app.app_context() 访问数据库与配置;FastAPI 侧安装 pip install celery fastapi uvicorn,异步端点用 .delay() 或 .apply_async() 调用任务,短任务可用 BackgroundTasks,长任务与需重试的用 Celery,注意不要把 FastAPI 依赖注入对象传入任务,任务运行在独立 worker 进程中。校验用 ./scripts/validate-framework.sh django|flask|fastapi,测试用 ./scripts/test-integration.sh django|flask|fastapi。

限制与说明:支持的框架为 Django 4+、Flask 2+、FastAPI 0.100+,Celery 5.3+,Python 3.9+;集成代码中禁止硬编码凭据,应使用环境变量,示例里用 your_redis_url_here 占位,并把 .env 加入 .gitignore。资料中未提供具体收费、价格或平台信息。