Module: Beachcomber::Discovery

Defined in:
lib/beachcomber/discovery.rb

Overview

Discovers the Unix socket path for the beachcomber daemon.

Mirrors the daemon’s bind-path resolution (Config::resolve_socket_path), minus the config-file step which is daemon-only. Discovery order:

1. $BEACHCOMBER_SOCKET  (if set and non-empty)
2. $XDG_RUNTIME_DIR/beachcomber/sock  (if XDG_RUNTIME_DIR is set)
3. /tmp/beachcomber-<uid>/sock

There is no existence probe and $TMPDIR is not consulted: the result is the single path the daemon binds for the same environment. Non-standard setups point clients at the daemon via BEACHCOMBER_SOCKET.

Class Method Summary collapse

Class Method Details

.socket_path ⇒ String

Returns the resolved socket path.

Returns:

  • (String) —

    the resolved socket path



17
18
19
20
21
22
23
24
25
 
# File 'lib/beachcomber/discovery.rb', line 17

def self.socket_path
  sock = ENV['BEACHCOMBER_SOCKET']
  return sock if sock && !sock.empty?

  xdg = ENV['XDG_RUNTIME_DIR']
  return File.join(xdg, 'beachcomber', 'sock') if xdg && !xdg.empty?

  File.join('/tmp', "beachcomber-#{Process.uid}", 'sock')
end