beachcomber 0.5.1

A centralized daemon that caches shell state (git, battery, hostname, etc.) so every consumer reads from one fast cache instead of independently forking shells
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

"""Socket path discovery for the beachcomber daemon.

Discovery order:
1. ``$XDG_RUNTIME_DIR/beachcomber/sock``
2. ``$TMPDIR/beachcomber-<uid>/sock``
3. ``/tmp/beachcomber-<uid>/sock``
"""

import os


def get_uid() -> int:
    """Return the effective user ID of the current process."""
    return os.geteuid()


def discover_socket_path() -> str:
    """Return the expected socket path for the running daemon.

    Checks the standard locations in order. Returns the first path that
    *should* exist according to the discovery rules — callers are
    responsible for verifying the socket is reachable.

    Returns:
        Absolute path string for the Unix domain socket.
    """
    xdg_runtime = os.environ.get("XDG_RUNTIME_DIR", "")
    if xdg_runtime:
        candidate = os.path.join(xdg_runtime, "beachcomber", "sock")
        if os.path.exists(candidate):
            return candidate

    uid = get_uid()
    tmpdir = os.environ.get("TMPDIR", "/tmp").rstrip("/")
    return os.path.join(tmpdir, f"beachcomber-{uid}", "sock")