Skip to content

migration

migration

Compatibility audit and one-way local migration to Diapason names.

Functions:

inspect_legacy_state 

inspect_legacy_state() -> list[MigrationFinding]

Return legacy state that should be migrated or renamed.

Source code in src/diapason/migration.py 
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
def inspect_legacy_state() -> list[MigrationFinding]:
    """Return legacy state that should be migrated or renamed."""
    findings: list[MigrationFinding] = []
    for name in sorted(os.environ):
        for prefix in LEGACY_ENV_PREFIXES:
            if name.startswith(prefix):
                suffix = name.removeprefix(prefix)
                findings.append(
                    MigrationFinding("environment", name, f"DIAPASON_{suffix}")
                )
                break

    target_home = get_config_dir()
    for legacy_name in LEGACY_HOME_NAMES:
        legacy = Path.home() / legacy_name
        if legacy.exists() and legacy.resolve() != target_home.resolve():
            findings.append(
                MigrationFinding("directory", str(legacy), str(target_home))
            )

    launch_agents = Path.home() / "Library" / "LaunchAgents"
    if launch_agents.is_dir():
        for source in sorted(launch_agents.glob("com.openjarvis*.plist")):
            target = source.with_name(
                source.name.replace("com.openjarvis", "com.diapason")
            )
            findings.append(MigrationFinding("launchd", str(source), str(target)))
    return findings

apply_migration 

apply_migration(
    findings: Iterable[MigrationFinding],
) -> list[MigrationFinding]

Apply safe filesystem migrations; shell environment changes are reported.

Source code in src/diapason/migration.py 
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
def apply_migration(findings: Iterable[MigrationFinding]) -> list[MigrationFinding]:
    """Apply safe filesystem migrations; shell environment changes are reported."""
    results: list[MigrationFinding] = []
    for finding in findings:
        if finding.kind == "environment":
            results.append(finding)
            continue

        source = Path(finding.source)
        target = Path(finding.target)
        if finding.kind == "directory":
            if target.exists():
                # Merge without overwriting current Diapason state.
                target.mkdir(mode=0o700, parents=True, exist_ok=True)
                for child in source.iterdir():
                    destination = target / child.name
                    if not destination.exists():
                        shutil.move(str(child), str(destination))
                if not any(source.iterdir()):
                    source.rmdir()
            else:
                target.parent.mkdir(parents=True, exist_ok=True)
                shutil.move(str(source), str(target))
            finding.applied = True
        elif finding.kind == "launchd" and not target.exists():
            text = source.read_text(encoding="utf-8")
            target.write_text(
                text.replace("com.openjarvis", "com.diapason"),
                encoding="utf-8",
            )
            target.chmod(0o600)
            source.unlink()
            finding.applied = True
        results.append(finding)
    return results