Blame for ruff.toml

target-version = "py312"
line-length = 120
extend-exclude = [
    "migrations",
    ".venv",
]

[lint]
select = ["E", "F", "W", "B", "C4", "SIM", "TID", "C90", "UP", "RUF", "S"]
ignore = [
    "B005",   # 不使用 .strip() 作为 str.startswith/endswith 参数：项目中存在合理用法
    "B007",   # 循环变量未在循环体中使用：部分场景仅需迭代次数
    "B008",   # 不在函数默认参数中调用函数：Django 视图层有合理用法
    "B019",   # 使用 lru_cache 装饰实例方法：项目中有意为之的缓存策略
    "B023",   # 函数在循环中定义但未绑定变量：项目中已通过其他方式处理
    "B027",   # 空方法体未使用 abstractmethod：接口定义中有意留空
    "E721",   # 使用 type() 比较类型而非 isinstance()：部分场景需精确类型匹配
    "E741",   # 模糊变量名（l/O/I）：数学公式和算法中有合理用法
    "F401",   # 未使用的导入：__init__.py 中的公开 API 导入需要保留
    "F402",   # 导入遮蔽：模块重导出场景中有合理用法
    "F811",   # 重复定义：条件导入和类型检查块中有合理用法
    "S101",   # 使用 assert：测试代码和调试断言中有合理用法
    "S105",   # 硬编码密码字符串：测试配置和示例代码中有合理用法
    "S106",   # 硬编码密码参数：测试配置和示例代码中有合理用法
    "SIM102", # 嵌套 if 可合并：部分场景分开写可读性更好
    "SIM105", # 使用 contextlib.suppress 替代 try/except/pass：显式 try/except 更清晰
    "SIM113", # 使用 enumerate 替代手动计数：部分场景手动计数更直观
    "UP035",  # 导入已废弃的 typing 成员：兼容旧版 Python 的代码需要保留
    "C401",   # 不必要的生成器（可用集合推导式）：部分场景生成器更节省内存
    "C414",   # 不必要的双重类型转换：部分场景为明确意图保留
    "E203",   # 切片中冒号前的空格：与 black 格式化工具兼容性问题
    "E402",   # 模块级导入不在文件顶部：Django apps.py 和条件导入有合理用法
    "RUF005", # 使用解包替代拼接：部分场景拼接语义更清晰
    "RUF001", # 字符串中的模糊 Unicode 字符：中文项目中全角字符属正常用法
    "RUF002", # 文档字符串中的模糊 Unicode 字符：中文注释属正常用法
    "RUF003", # 注释中的模糊 Unicode 字符：中文注释属正常用法
    "RUF012", # 可变类属性应使用 ClassVar 注解：Django Model 字段定义不适用此规则
    "RUF022", # __all__ 未排序：保持原有声明顺序以体现逻辑分组
    "RUF059", # 解包赋值中未使用的变量：部分场景需要占位符变量
    "S104",   # 绑定到所有接口（0.0.0.0）：开发环境和容器部署中有合理用法
    "S107",   # 硬编码密码默认值：测试配置和示例代码中有合理用法
    "S108",   # 临时文件路径硬编码：测试和脚本中有合理用法
    "S110",   # try/except/pass 忽略异常：爬虫和配置加载的容错处理
    "S112",   # try/except/continue 忽略异常：爬虫和配置加载的容错处理
    "S307",   # 使用 eval()：项目中有受控的动态表达式求值场景
    "S311",   # 使用伪随机数生成器：项目中非安全敏感场景（如测试数据生成）有合理用法
    "S324",   # 使用不安全的哈希函数（MD5/SHA1）：遗留数据兼容性场景有合理用法
    "S603",   # subprocess 调用：SubprocessRunner 已通过白名单校验 args 并强制 shell=False，属安全封装
    "S608",   # SQL 注入风险（字符串拼接）：项目中已通过 ORM 参数化查询防护
    "SIM103", # 直接返回条件表达式：部分场景分步写可读性更好
    "SIM108", # 使用三元运算符：部分场景 if/else 更清晰
    "SIM110", # 使用列表推导式替代 for 循环：部分场景 for 循环更易读
    "SIM115", # 使用上下文管理器打开文件：部分场景有合理的非上下文管理器用法
    "SIM118", # 使用 key in dict 替代 key in dict.keys()：部分场景显式 .keys() 更清晰
    "SIM401", # 使用 dict.get() 替代条件表达式：部分场景条件表达式语义更明确
    "UP028",  # 使用 yield from 替代 yield in for 循环：部分场景 for 循环更易读
    "UP042",  # 使用 str | int 替代 Union[str, int]：兼容旧版类型注解风格
    "F821",   # 未定义的名称：TYPE_CHECKING 块中的前向引用和动态属性有合理用法
    "C901",   # 函数复杂度过高：历史遗留复杂业务逻辑，逐步重构中
    "B904",   # except 块中 raise 缺少 from：历史遗留代码，逐步修复中
    "B905",   # zip() 缺少 strict 参数：历史遗留代码
    "F841",   # 未使用的局部变量：部分场景用于副作用或占位
    "E501",   # 行过长：历史遗留，ruff-format 已处理大部分
    "TID252", # 相对导入：历史遗留代码
    "S308",   # mark_safe 使用：Django 模板渲染中有合理用法
    "UP031",  # printf 风格字符串格式化：历史遗留代码
    "S314",   # XML 解析安全风险：项目中已控制输入来源
    "F823",   # 未定义的 __all__ 成员：动态导出场景
    "TID251", # 禁用的 API：历史遗留代码
    "SIM222", # or True 表达式：历史遗留代码
    "SIM117", # 嵌套 with 可合并：历史遗留代码
    "UP040",  # TypeAlias 改用 type 关键字：条件导入场景不适用
]

[lint.per-file-ignores]
"tests/**/*.py" = ["S101"]
"conftest.py" = ["S101"]
"docs/**/*.py" = ["S101"]
"scripts/**/*.py" = ["S101"]
"__init__.py" = ["F401", "F403"]
"admin.py" = ["F401"]
"**/admin/*.py" = ["F401"]
"apps/automation/services/token/history_recorder.py" = ["C901"]
"apps/automation/services/token/token_acquisition_orchestrator.py" = ["C901"]
"apps/cases/admin/case_inlines_admin.py" = ["C901"]
"apps/cases/admin/case_widgets_admin.py" = ["F821"]
"apps/cases/admin/base.py" = ["UP040"]  # TypeAlias 在 TYPE_CHECKING 块中无法使用 type 关键字替代
"apps/automation/services/ai/prompts.py" = ["E501"]
"apps/core/utils/typing_helpers.py" = ["UP047"]  # TypeVar 方式与 mypy --strict 更兼容，暂不迁移到 PEP 695 type parameters 语法
"apps/core/llm/structured_output.py" = ["UP047"]  # CI 在 backend 工作目录运行时使用该相对路径
"backend/apps/core/llm/structured_output.py" = ["UP047"]  # 统一沿用 TypeVar 风格，避免单文件提前切换 PEP 695 语法

[lint.mccabe]
max-complexity = 10

[lint.flake8-tidy-imports.banned-api]
requests = { msg = "禁止使用 requests，请改用 httpx" }