Skip to content

Linux Platform

linux

Linux-specific platform implementation.

Handles symlinks, Python detection, and admin checks on Linux systems. Long path support is a no-op (Linux has no 260-char limit).

LinuxPlatform

Bases: Platform

Linux platform implementation.

is_admin()

Check if running as root.

Source code in src/platform/linux.py 
30
31
32
def is_admin(self) -> bool:
    """Check if running as root."""
    return os.getuid() == 0

enable_long_paths(log=None)

No-op on Linux — long paths are always supported.

Source code in src/platform/linux.py 
34
35
36
37
38
39
def enable_long_paths(self, log: InstallerLogger | None = None) -> bool:
    """No-op on Linux — long paths are always supported."""
    if log is None:
        log = get_logger()
    log.sub("Long path support: native (no action needed).", style="success")
    return True

detect_python(version='3.13', log=None)

Detect a specific Python version on Linux.

Checks: python3.13, python3, python in PATH.

Parameters:

Name Type Description Default
version str

The version to look for (e.g. "3.13").

 '3.13'
log InstallerLogger | None

Optional logger instance.

 None

Returns:

Type Description
Path | None

Path to python executable, or None.
Source code in src/platform/linux.py 
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
def detect_python(self, version: str = "3.13", log: InstallerLogger | None = None) -> Path | None:
    """
    Detect a specific Python version on Linux.

    Checks: python3.13, python3, python in PATH.

    Args:
        version: The version to look for (e.g. "3.13").
        log: Optional logger instance.

    Returns:
        Path to python executable, or None.
    """
    if log is None:
        log = get_logger()

    # 1. Try version-specific binary (e.g. python3.13)
    versioned = shutil.which(f"python{version}")
    if versioned:
        log.sub(f"Python {version} found: {versioned}", style="success")
        return Path(versioned)

    # 2. Try python3 and check version
    for candidate_name in ("python3", "python"):
        candidate = shutil.which(candidate_name)
        if candidate:
            try:
                result = subprocess.run(
                    [candidate, "--version"],
                    capture_output=True,
                    text=True,
                    timeout=10,
                )
                if result.returncode == 0 and f"Python {version}" in result.stdout:
                    log.sub(f"Python {version} found: {candidate}", style="success")
                    return Path(candidate)
            except (subprocess.TimeoutExpired, OSError):
                pass

    return None

get_app_data_dir()

Get the XDG data directory (~/.local/share).

Source code in src/platform/linux.py 
82
83
84
85
86
87
def get_app_data_dir(self) -> Path:
    """Get the XDG data directory (~/.local/share)."""
    xdg = os.environ.get("XDG_DATA_HOME")
    if xdg:
        return Path(xdg)
    return Path.home() / ".local" / "share"