# SimpleFarm —— 项目元数据与工具配置
#
# 这个文件是**唯一真源**：依赖、Python 版本、lint 规则、类型检查规则全都写在这里。
# 日常操作全部交给 uv，不需要手动激活虚拟环境：
#
#   uv sync                  # 按 uv.lock 建好 .venv（含开发依赖）
#   uv run main.py serve --daemon
#   uv run ruff check .      # 静态检查
#   uv run ruff format .     # 格式化
#   uv run pyright           # 类型检查
#
# 为什么写 package = false：这是一个**应用**，不是要发布到 PyPI 的库。
# 关掉打包之后，uv 只负责环境与依赖，不引入任何构建后端（hatchling/setuptools 都不需要），
# `python main.py` 与 `uv run main.py` 行为完全一致。

[project]
name = "simplefarm"
version = "2.0.0"
description = "终端农场经营游戏 + 小型多人游戏服务器：人玩 TUI，AI 走 HTTP + SSE 接口"
readme = "README.md"
requires-python = ">=3.10"
license = "MIT"
keywords = ["game", "tui", "cli", "fastapi", "sse", "llm", "agent"]
classifiers = [
  "Programming Language :: Python :: 3 :: Only",
  "Topic :: Games/Entertainment :: Simulation",
]

# 运行依赖 —— 只有**服务端**需要。
# 终端界面、命令行客户端、规则机器人全部只用标准库，
# 所以 `uv run main.py solo` 这类离线玩法不需要装下面这两个。
dependencies = [
  "fastapi>=0.110",
  # ASGI 服务器本体。[standard] 带 httptools（更快的 HTTP/1.1 解析）、watchfiles 等；
  # 它还会捎带一个 websockets——本项目只用 SSE、不用 WebSocket，那是 uvicorn 的
  # 可选依赖，别误会成我们在用。
  "uvicorn[standard]>=0.53.0",
  # HTTP/2 的开关。uvicorn 自己不再内置 h2，它的 HTTP/2 实现建立在 zttp 上
  # （uvicorn/protocols/http/zttp_h2_impl.py）：配 http="zttp" + http2=True 之后，
  # AutoZttpProtocol 会在**同一个端口**按 ALPN（TLS）或 h2c 前导字节（明文）
  # 自动分流 HTTP/1.1 与 HTTP/2，应用代码一行都不用改。
  "zttp>=0.0.33",
]

# 开发依赖（`uv sync` 默认就会装，用 `uv sync --no-dev` 可以跳过）。
[dependency-groups]
dev = [
  "ruff>=0.8.0",
  "pyright>=1.1.390",
]

[tool.uv]
package = false

# --------------------------------------------------------------------- ruff
# 职责二合一：`ruff format` 管格式，`ruff check` 管正确性与一致性。
# 之所以不用 Black + isort + flake8 三件套，是因为 ruff 一个二进制就覆盖了它们，
# 而且配置在同一次解析里生效，不会出现"格式化完 lint 又报"的拉锯。
[tool.ruff]
line-length = 100          # 贴着现有代码定：只有 18 行超 100，用默认的 88 会重排 122 行
target-version = "py310"   # 与 requires-python 对齐
src = ["farm", "tools"]
# 文档里的示例代码是"给人看的排版"，不交给格式化器管
extend-exclude = ["README.md"]

[tool.ruff.lint]
select = [
  "E",   # pycodestyle 错误
  "W",   # pycodestyle 警告
  "F",   # pyflakes：未使用的导入/变量、未定义的名字
  "I",   # isort：导入排序
  "UP",  # pyupgrade：用新语法替换过时写法
  "B",   # flake8-bugbear：容易踩坑的写法（可变默认值、裸 except、丢异常链……）
  "C4",  # flake8-comprehensions
  "SIM", # flake8-simplify
  "RET", # flake8-return：多余的 else / 多余的中间变量
  "PERF",# 明显的性能坑（比如循环里做成员判断）
  "RUF", # ruff 自带规则
]
# 为什么**没有**启用 PTH（flake8-use-pathlib）：
# 这个项目的路径绝大多数是"字符串身份"——要塞进 subprocess 命令行、要写进 JSON
# 存档、要打印给用户看。全部换成 pathlib 只是把字符串包一层再拆一层，
# 换来 70 处纯风格改动，却掩盖了真正有价值的修复。路径运算本来就少，
# 现有 os.path 用法是合适的选择。
ignore = [
  # RUF001/002/003 会把中文全角标点当成"含糊的 Unicode 字符"报出来。
  # 这个项目注释与界面文案本来就是中文，全角括号是正确写法，不是错误。
  "RUF001",
  "RUF002",
  "RUF003",
  # PERF203 提示"循环里 try 有性能开销"。剩下两处都是**逐项容错**语义：
  # 逐个牧场存档（失败要立刻上报，不能静默跳过）、收获全部时跳过失败的地块。
  # 把 try 提到循环外会让"一项失败不影响其它项"这个行为消失——那是错的优化。
  # 而且循环规模是牧场数 / 地块数级别（个位数），性能开销在这里无关紧要。
  "PERF203",
]

[tool.ruff.lint.per-file-ignores]
# 内嵌的 HTML/JS 模板：整块写在一个字符串里，按 100 列硬拆反而更难读也更难改
"farm/server/webui.py" = ["E501"]

[tool.ruff.lint.isort]
known-first-party = ["farm"]

[tool.ruff.format]
quote-style = "double"
indent-style = "space"
skip-magic-trailing-comma = false
line-ending = "auto"       # Windows/Linux 混用时不要强改行尾，避免整文件 diff

# ------------------------------------------------------------------ pyright
# 只做到"能进 CI 拦住真问题"的程度：
# - basic 模式抓得住 None 误用、参数个数/类型不符、属性不存在这类真 bug；
# - 不去追 Unknown 类型（本项目的快照是 dict[str, Any] 结构，追下去全是噪音）。
[tool.pyright]
include = ["farm", "tools", "main.py", "ai_player.py"]
exclude = [".venv", "**/__pycache__", ".ruff_cache", "saves", "run"]
pythonVersion = "3.10"
# 代码里有 termios / msvcrt 这类平台专属分支。只按当前平台分析，
# 会把另一侧的调用误报成"模块没有这个属性"，所以让 pyright 同时考虑所有平台。
pythonPlatform = "All"
typeCheckingMode = "basic"
reportMissingTypeStubs = false # 让"没装 third-party 存根"保持安静
reportUnusedImport = true
reportUnnecessaryIsInstance = true
# __all__ 里写子模块名是 `farm/__init__.py` 惰性导出的正常写法，
# pyright 只认模块里真实存在的名字，这条对我们是纯噪音
reportUnsupportedDunderAll = false