[project]
name = "backend"
version = "2.0.0"
description = "fastapiadmin后端工程"
readme = "README.md"
requires-python = ">=3.12"
dependencies = [
 "agno==2.5.8",
 "aiofiles==24.1.0", # 文件操作
 "aiosmtplib>=3.0.2", # 异步 SMTP 邮件发送(fastapi-mail 要求 >=3.0.2)
 "aiosqlite==0.22.1", # sqlite 异步操作数据库
 "alembic==1.18.4", # 数据库迁移
 "apscheduler==3.11.0", # 定时任务
 "asyncmy==0.2.11", # mysql 异步操作数据库:基于 mysqlclient:asyncmy 是 mysqlclient 的异步版本,mysqlclient 是一个 C 语言编写的 MySQL 客户端,性能较高。性能:asyncmy 通常在性能上优于 aiomysql,特别是在高并发和大数据量的场景下。
 "asyncpg==0.31.0", # postgresql 异步操作数据库
 "bleach==6.4.0", # 过滤 HTML 标签
 "click==8.1.7", # 命令行参数解析
 "croniter>=1.0.12,<5.0.0", # cron 表达式解析
 "cryptography==49.0.0", # mysql8 密码加密
 "fastapi==0.115.2", # fastapi 框架
 "fastapi-limiter==0.1.6", # 接口限流
 "greenlet==3.5.2", # 协程核心依赖(SQLAlchemy 异步)
 "httpx==0.28.1", # HTTP 客户端
 "jinja2==3.1.6", # 模板引擎
 "loguru==0.7.3", # 日志
 "openai==2.28.0", # OpenAI API 客户端
 "openpyxl==3.1.5", # Excel
 "pandas==3.0.3", # 数据处理
 "pillow==12.2.0", # 图片处理
 "psutil==7.2.2", # 系统信息
 "psycopg[binary]==3.3.2", # postgresql 同步驱动(含预编译 libpq,开箱即用)
 "pydantic-settings>=2.6.1", # 配置设置(fastapi-mail 要求 >=2.6.1)
 "pyjwt==2.13.0", # OAuth2
 "pymysql==1.2.0", # mysql 同步步操作数据库基于 pymysql:aiomysql 是 pymysql 的异步版本,pymysql 是一个纯 Python 实现的 MySQL 客户端。成熟度:aiomysql 相对较为成熟,社区支持较好,文档也比较完善。
 "python-multipart==0.0.32", # request.form() 对表单进行「解析」时安装
 "redis==7.1.0", # redis 同/异步操作数据库(用户celery配套使用)redis 异步操作数据库 redis已经完全具备了aioredis的功能,无需重复安全,且aioredis已经不再维护也不兼容3.10+的版本
 "rich==15.0.0", # 终端打印美化
 "sqlalchemy>=2.0.51,<2.1", # 数据库ORM
 "sqlglot[rs]==27.8.0", # sql 解析
 "typer==0.26.7", # 命令行工具
 "ua-parser==1.0.2", # 解析 User-Agent 获取 OS/浏览器
 "uvicorn==0.49.0", # uvicorn web 框架
 "websockets>=16.0,<17.0", # websocket 通信
 "fastapi-mail==1.5.1", # 邮件发送(简化 EmailSendService 底层)
 "tinycss2==1.5.1",
 "weasyprint==69.0",
 "fastapi-cache2[redis]>=0.1.8",
]

[dependency-groups]
dev = [
 "fakeredis>=2.21.0,<3", # 测试:内存 Redis,配合 TESTING
 "pytest==9.0.2",
 "pytest-asyncio>=0.24.0", # 异步测试支持
 "ruff==0.14.13", # 代码检查/格式化
]

[tool.uv]
default-groups = ["dev"] # 本地 uv sync 含 dev;生产 pip -r requirements.txt 不含 pytest/ruff/fakeredis

[[tool.uv.index]]
name = "tuna"
url = "https://pypi.tuna.tsinghua.edu.cn/simple"

[tool.ruff]
line-length = 200
indent-width = 4
preview = false
fix = true
show-fixes = true
exclude = [
 ".bzr",
 ".direnv",
 ".eggs",
 ".git",
 ".git-rewrite",
 ".hg",
 ".ipynb_checkpoints",
 ".mypy_cache",
 ".nox",
 ".pants.d",
 ".pyenv",
 ".pytest_cache",
 ".pytype",
 ".ruff_cache",
 ".svn",
 ".tox",
 ".venv",
 ".vscode",
 "__pypackages__",
 "_build",
 "buck-out",
 "build",
 "dist",
 "node_modules",
 "site-packages",
 "venv",
]
extend-include = ["*.pyw"]

[tool.ruff.lint]
select = [
 "FAST",
 "F",
 "E",
 "W",
 "F",
 "I",
 "B",
 "C4",
 "UP",
]
ignore = [
 "E501", # line too long, handled by black
 "B008", # do not perform function calls in argument defaults
 "C901", # too complex
 "W191", # indentation contains tabs
 "B904", # Within an `except` clause
 "B010", # Do not call with a constant attribute value.
 "B009", # Do not use getattr() with a constant attribute value.
 "E712", # Avoid equality comparisons to `False`; use `not getattr(self.model, "is_deleted"):` for false checks
 "W293", # blank line with whitespace
]

[tool.ruff.lint.per-file-ignores]
"tests/conftest.py" = ["E402"] # 先设置 TESTING/SQLite 环境再 import 应用

[tool.ruff.format]
docstring-code-format = true
preview = false
quote-style = "double"
indent-style = "space"
skip-magic-trailing-comma = false
line-ending = "auto"

[tool.pytest.ini_options]
asyncio_mode = "auto"
asyncio_default_fixture_loop_scope = "function"