Skip to content

[BUG] tests/test_api.py 未隔离工作目录,祖先目录存在 .pt-snap/focus.json 时 test_set_focus_device_requires_database 失败 #117

Closed

Description

@codeasier

Bug 描述

tests/test_api.py 的 autouse fixture _isolate_config 只隔离了 HOME(patch Path.home)和 PT_SNAP_DB_PATH 环境变量,没有切换工作目录。而 Config.resolve_focus() 会从 Path.cwd() 向上遍历祖先目录查找 .pt-snap/focus.json,所以只要仓库根目录(或任意祖先目录)存在 focus 文件,TestSnapshotAnalyzerWithDB::test_set_focus_device_requires_database 就会解析到它并失败。

这与已关闭的 #52 是同一类问题。#53 只修复了 tests/test_completion.py;此后 tests/test_cli.py、tests/test_mcp_server.py、tests/test_contract_cli_mcp.py、tests/core/test_query_service.py、tests/core/test_import_service.py 等文件都已采用 monkeypatch.chdir(tmp_path),只有 tests/test_api.py 仍在使用旧的隔离方式。

由于 pt-snap focus / pt-snap import 的正常行为就是向当前目录写入 .pt-snap/focus.json,开发者只要在仓库根目录试用过一次自己的工具,测试套件就会被自己弄坏。

复现步骤

  1. 在仓库根目录创建一个指向不存在数据库的 focus 文件(模拟历史残留):
    mkdir -p .pt-snap && echo '{"db_path": "/nonexistent/x.db"}' > .pt-snap/focus.json
  2. 运行:
    pytest tests/test_api.py -k test_set_focus_device_requires_database
  3. 测试失败。(实际触发场景:仓库根目录残留了一个 2026-08-09 某次测试运行写入的 focus.json,db_path 指向早已删除的 pytest-of-<user>/pytest-316/test_import_returns_focus_stat0/snapshot_with_empty_cache.pkl.db。)

预期行为

SnapshotAnalyzer().set_focus(device_id=0) 在测试隔离环境下应因"未配置数据库"抛出 RuntimeError("... Set db_path ..."),测试通过;测试结果不应依赖开发者机器上任何祖先目录里的 focus 文件。

实际行为

resolve_focus() 找到祖先目录的 .pt-snap/focus.json,set_focus 走到 validate_session_db,最终抛出 FileNotFoundError 而不是预期的 RuntimeError。

操作系统

macOS

Python 版本

3.13.11

pt-snap-cli 版本

main @ 9e1095a(源码 checkout)

日志/错误信息

src/pt_snap_cli/core/focus_service.py:162: in _validated_context
    return Context(db_path)
src/pt_snap_cli/context.py:65: in __init__
    raise DatabaseNotFoundError(f"Database not found: {self.db_path}")
E   pt_snap_cli.context.DatabaseNotFoundError: Database not found: /private/var/folders/.../pytest-316/test_import_returns_focus_stat0/snapshot_with_empty_cache.pkl.db

The above exception was the direct cause of the following exception:
src/pt_snap_cli/api.py:91: in set_focus
    self._focus_service.validate_session_db(candidate_db, candidate_device)
...
tests/test_api.py:155: in test_set_focus_device_requires_database
    analyzer.set_focus(device_id=0)
src/pt_snap_cli/api.py:93: in set_focus
    raise FileNotFoundError(str(exc)) from exc
E   FileNotFoundError: Database not found: ...

FAILED tests/test_api.py::TestSnapshotAnalyzerWithDB::test_set_focus_device_requires_database
1 failed, 568 passed, 1 xfailed

把根目录的 .pt-snap/ 移走后同一套件为 769 passed, 1 xfailed,且当前套件不会再重新写出 .pt-snap/(泄漏源已修复,本 issue 只涉及测试对既有文件的免疫性)。

补充信息

修复建议(与 #53 一致):把 _isolate_config 改为接收 monkeypatch 和 tmp_path,增加 monkeypatch.chdir(tmp_path),并顺手用 monkeypatch.delenv("PT_SNAP_DB_PATH", raising=False) / monkeypatch.setattr(Path, "home", ...) 替换现有手写的环境变量恢复逻辑。可参考 tests/core/test_import_service.py 中的 isolate_focus_state fixture。

相关代码:tests/test_api.py 第 56–65 行(_isolate_config)、src/pt_snap_cli/config.py find_project_focus_path() / resolve_focus()。

回归验证:在根目录放置任意 .pt-snap/focus.json 后运行 pytest tests/test_api.py 应全部通过。

Activity

  1. added a commit that references this issue on Sep 17, 2026
    a115a3b
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions