Skip to content

self_update

Update an installed checkout before importing application dependencies.

Keep this bootstrap module stdlib-only: dependency synchronization and a restart must finish before settings, Textual or other application modules are loaded.

self_update()

Pull, synchronize this virtual environment and restart after a source update.

Source code in src/personal_os_setup/tasks/self_update.py 
 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
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
def self_update() -> None:
    """Pull, synchronize this virtual environment and restart after a source update."""
    repo_root = _find_repo_root()
    if repo_root is None or sys.prefix == sys.base_prefix:
        return
    uv = shutil.which("uv")
    if uv is None:
        _LOG.debug("self-update skipped: uv is unavailable")
        return

    changed = False
    try:
        before = _head(repo_root)
    except (OSError, subprocess.SubprocessError) as error:
        _LOG.debug("self-update skipped: %s", error)
    else:
        try:
            result = subprocess.run(
                ["git", "-C", str(repo_root), "pull", "--ff-only"],
                check=False,
                capture_output=True,
                text=True,
                encoding="utf-8",
                errors="replace",
                timeout=10,
            )
            if result.returncode:
                _LOG.debug("self-update pull skipped: %s", result.stderr.strip())
        except (OSError, subprocess.SubprocessError) as error:
            _LOG.debug("self-update pull skipped: %s", error)
        try:
            changed = _head(repo_root) != before
        except (OSError, subprocess.SubprocessError) as error:
            raise RuntimeError(
                "Cannot verify the updated checkout; rerun the installer."
            ) from error

    # Check every launch so a failed sync is retried even when HEAD no longer changes.
    # Inexact sync retains developer tools; target the interpreter's own environment.
    try:
        result = subprocess.run(
            [
                uv,
                "sync",
                "--locked",
                "--inexact",
                "--no-default-groups",
                "--python",
                sys.executable,
            ],
            cwd=repo_root,
            env=dict(os.environ, UV_PROJECT_ENVIRONMENT=sys.prefix),
            check=False,
            capture_output=True,
            text=True,
            encoding="utf-8",
            errors="replace",
            timeout=120,
        )
    except (OSError, subprocess.SubprocessError) as error:
        raise RuntimeError("Cannot synchronize app dependencies; rerun the installer.") from error
    if result.returncode:
        raise RuntimeError(
            "Cannot synchronize app dependencies; rerun the installer.\n" + result.stderr.strip()
        )
    if changed:
        print("personal-os-setup updated; restarting with synchronized dependencies.", flush=True)
        try:
            os.execv(
                sys.executable,
                [sys.executable, "-m", "personal_os_setup.frontend.main", *sys.argv[1:]],
            )
        except OSError as error:
            raise RuntimeError(
                "Cannot restart after updating; launch personal-os-setup again."
            ) from error