flowmark 0.3.2

A Markdown auto-formatter for clean diffs and semantic line breaks
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

#!/usr/bin/env python3
"""Tests for scripts/sync_skill_mirror.py."""

from __future__ import annotations

import subprocess
import sys
import tempfile
import unittest
from pathlib import Path

REPO_ROOT = Path(__file__).resolve().parents[2]
SCRIPT_PATH = REPO_ROOT / "scripts" / "sync_skill_mirror.py"


class SyncSkillMirrorTests(unittest.TestCase):
    def _repo(self, root: Path) -> None:
        upstream = root / "repos/flowmark/src/flowmark/skills"
        runtime = root / "src/skills"
        (upstream / "references").mkdir(parents=True)
        runtime.mkdir(parents=True)
        (upstream / "SKILL.md").write_text("canonical skill\n", encoding="utf-8")
        (upstream / "references/project-setup.md").write_text(
            "canonical reference\n", encoding="utf-8"
        )
        (runtime / "mod.rs").write_text("// Rust implementation\n", encoding="utf-8")
        (runtime / "helper.rs").write_text("// More Rust implementation\n", encoding="utf-8")

    def _run(self, root: Path, *args: str) -> subprocess.CompletedProcess[str]:
        return subprocess.run(
            [sys.executable, str(SCRIPT_PATH), "--repo-root", str(root), *args],
            capture_output=True,
            text=True,
        )

    def test_sync_copies_complete_bundle_and_preserves_rust_code(self) -> None:
        with tempfile.TemporaryDirectory() as temp_dir:
            root = Path(temp_dir)
            self._repo(root)
            runtime = root / "src/skills"
            (runtime / "stale.md").write_text("stale\n", encoding="utf-8")

            result = self._run(root)

            self.assertEqual(result.returncode, 0, msg=result.stderr)
            self.assertEqual(
                (runtime / "SKILL.md").read_text(encoding="utf-8"), "canonical skill\n"
            )
            self.assertEqual(
                (runtime / "references/project-setup.md").read_text(encoding="utf-8"),
                "canonical reference\n",
            )
            self.assertTrue((runtime / "mod.rs").is_file())
            self.assertTrue((runtime / "helper.rs").is_file())
            self.assertFalse((runtime / "stale.md").exists())

    def test_check_reports_drift_without_writing(self) -> None:
        with tempfile.TemporaryDirectory() as temp_dir:
            root = Path(temp_dir)
            self._repo(root)
            self.assertEqual(self._run(root).returncode, 0)
            runtime_skill = root / "src/skills/SKILL.md"
            runtime_skill.write_text("different\n", encoding="utf-8")

            result = self._run(root, "--check")

            self.assertNotEqual(result.returncode, 0)
            self.assertIn("content drifted", result.stderr)
            self.assertEqual(runtime_skill.read_text(encoding="utf-8"), "different\n")

    def test_check_accepts_an_aligned_mirror(self) -> None:
        with tempfile.TemporaryDirectory() as temp_dir:
            root = Path(temp_dir)
            self._repo(root)
            self.assertEqual(self._run(root).returncode, 0)

            result = self._run(root, "--check")

            self.assertEqual(result.returncode, 0, msg=result.stderr)
            self.assertIn("is in sync", result.stdout)


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