duodiff 0.7.0

A fast, cross-platform terminal user interface (TUI) directory comparison tool
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
import os
import pathlib
import shutil

HOME = pathlib.Path(os.environ["DUODIFF_DEMO_HOME"])
WORK = HOME / "work"
LEFT = WORK / "left"
RIGHT = WORK / "right"

SAME_BYTES = "Hello, this file is exactly the same on both sides.\n"

# Explicit mtimes so the demo shows every tree state deterministically. Writing
# the two sides milliseconds apart would otherwise leave `identical.txt` with
# differing timestamps, which Fast mode reports as `≈` rather than `=`.
SAME_TIME = 1_700_000_000
NEWER_TIME = 1_700_086_400

FILES_LEFT = {
    "identical.txt": SAME_BYTES,
    # Same bytes, same size, rewritten timestamp — Fast mode cannot tell
    # whether the contents match, so this row is `≈` (content unverified).
    "timestamp_only.txt": SAME_BYTES,
    "diff_left_newer.txt": "This file differs.\nLeft side has extra lines.\n",
    "left_only.txt": "This file exists only on the left side.\n",
    # Two hunks separated by an equal line; first line is a same-length
    # replacement so intraline highlighting is visible in the diff view.
    "merge_demo.txt": (
        "mode = fast\n"
        "enabled = yes\n"
        "host = alpha\n"
    ),
    "nested_dir/nested.txt": "Nested file.\nLeft version.\n",
}

FILES_RIGHT = {
    "identical.txt": SAME_BYTES,
    "timestamp_only.txt": SAME_BYTES,
    "diff_left_newer.txt": "This file differs.\n",
    "diff_right_newer.txt": "This file differs.\nRight side is newer.\n",
    "right_only.txt": "This file exists only on the right side.\n",
    "merge_demo.txt": (
        "mode = slow\n"
        "enabled = yes\n"
        "host = beta\n"
    ),
    "nested_dir/nested.txt": "Nested file.\nRight version.\n",
}

def main():
    if WORK.exists():
        shutil.rmtree(WORK)
    LEFT.mkdir(parents=True, exist_ok=True)
    RIGHT.mkdir(parents=True, exist_ok=True)

    for name, content in FILES_LEFT.items():
        p = LEFT / name
        p.parent.mkdir(parents=True, exist_ok=True)
        p.write_text(content)

    for name, content in FILES_RIGHT.items():
        p = RIGHT / name
        p.parent.mkdir(parents=True, exist_ok=True)
        p.write_text(content)

    for side in (LEFT, RIGHT):
        os.utime(side / "identical.txt", (SAME_TIME, SAME_TIME))
    os.utime(LEFT / "timestamp_only.txt", (SAME_TIME, SAME_TIME))
    os.utime(RIGHT / "timestamp_only.txt", (NEWER_TIME, NEWER_TIME))

    # Isolate from the developer's ~/.config/duodiff: load() tries
    # $XDG_CONFIG_HOME/duodiff first, then $HOME/.config/duodiff. record.py /
    # shoot.py point both at this workspace, so a missing file here would
    # otherwise pick up a light theme or Precise-mode preference from the host.
    config_dir = HOME / "xdg" / "duodiff"
    config_dir.mkdir(parents=True, exist_ok=True)
    (config_dir / "config.toml").write_text(
        'theme = "dark"\nscan_mode = "precise"\ncheck_updates = false\n'
    )

    print(f"seeded comparison trees under {WORK}")

if __name__ == "__main__":
    main()