patchloom 0.25.0

Structured file editing library and CLI for AI agents: parser-backed JSON/YAML/TOML edits, AST-aware code operations, multi-file batching, markdown operations, and MCP server
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

#!/usr/bin/env python3
"""Tests for scripts/pack-mcpb.sh version resolution and pack stamping."""

from __future__ import annotations

import json
import os
import shutil
import subprocess
import unittest
import zipfile
from pathlib import Path

ROOT = Path(__file__).resolve().parent.parent
SCRIPT = ROOT / "scripts" / "pack-mcpb.sh"


def _run_pack(env: dict[str, str], *extra_env: tuple[str, str]) -> subprocess.CompletedProcess[str]:
    e = os.environ.copy()
    e.update(env)
    for k, v in extra_env:
        e[k] = v
    return subprocess.run(
        ["bash", str(SCRIPT)],
        cwd=ROOT,
        env=e,
        capture_output=True,
        text=True,
        check=False,
    )


class PackMcpbTests(unittest.TestCase):
    def test_print_version_from_cargo(self) -> None:
        r = _run_pack({"PACK_MCPB_PRINT_VERSION_ONLY": "1"})
        self.assertEqual(r.returncode, 0, r.stderr)
        cargo = (ROOT / "Cargo.toml").read_text(encoding="utf-8")
        import re

        m = re.search(r'(?m)^version\s*=\s*"([^"]+)"', cargo)
        self.assertIsNotNone(m)
        self.assertEqual(r.stdout.strip(), m.group(1))

    def test_print_version_honors_version_env(self) -> None:
        r = _run_pack(
            {"PACK_MCPB_PRINT_VERSION_ONLY": "1", "VERSION": "9.9.9-test"}
        )
        self.assertEqual(r.returncode, 0, r.stderr)
        self.assertEqual(r.stdout.strip(), "9.9.9-test")

    def test_pack_stamps_manifest_and_package(self) -> None:
        # Default pack path is zip+python (no mcpb CLI). Always exercise it.
        if shutil.which("zip") is None:
            self.skipTest("zip not installed")

        ver = "0.0.0-packtest"
        out = ROOT / "target" / "mcpb" / f"patchloom-{ver}.mcpb"
        if out.exists():
            out.unlink()

        r = _run_pack({"VERSION": ver})
        self.assertEqual(r.returncode, 0, f"stdout={r.stdout}\nstderr={r.stderr}")
        self.assertTrue(out.is_file(), f"missing {out}")

        with zipfile.ZipFile(out) as zf:
            names = set(zf.namelist())
            self.assertIn("manifest.json", names)
            self.assertIn("package.json", names)
            self.assertIn("server/run.mjs", names)
            manifest = json.loads(zf.read("manifest.json"))
            package = json.loads(zf.read("package.json"))

        self.assertEqual(manifest["version"], ver)
        self.assertEqual(package["version"], ver)
        args = manifest["server"]["mcp_config"]["args"]
        self.assertEqual(args, ["-y", f"patchloom@{ver}", "mcp-server"])
        win_args = manifest["server"]["mcp_config"]["platform_overrides"]["win32"][
            "args"
        ]
        self.assertEqual(win_args, ["-y", f"patchloom@{ver}", "mcp-server"])

        # Launcher must load stamped package.json version for npx fallback.
        with zipfile.ZipFile(out) as zf:
            run_mjs = zf.read("server/run.mjs").decode("utf-8")
        self.assertIn("package.json", run_mjs)
        self.assertIn("binaryOnPath", run_mjs)


if __name__ == "__main__":
    unittest.main()