Class: Space::Architect::SessionSync::Plist

Inherits:
Object
  • Object
show all
Defined in:
lib/space_architect/session_sync/plist.rb

Overview

Hand-rolled launchd plist emitter for the session-sync agent, imitating Space::Src::Launchd::Plist's shape. Under launchd's bare PATH, a bare env-relative ruby binstub shebang resolves to macOS system Ruby instead of the caller's toolchain, so ProgramArguments names the interpreter explicitly (ruby_bin) rather than relying on shebang resolution — no mise wrapping needed, since the sync itself pins no toolchain at run time.

Constant Summary collapse

DEFAULT_PATH = 
"/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
HEADER = 
<<~XML
  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
  <plist version="1.0">
  <dict>
XML
"</dict>\n</plist>\n"

Class Method Summary collapse

Class Method Details

.call(label:, refresh_interval:, log_dir:, bin_path:, ruby_bin:, host:, env:) ⇒ String

Returns the full plist XML.

Parameters:

  • label (String) —

    The job label (reverse-DNS; on-disk plist basename).

  • refresh_interval (Integer) —

    StartInterval in seconds (must be > 0).

  • log_dir (String) —

    Absolute directory for stdout/stderr logs.

  • bin_path (String) —

    Absolute path to the architect bin script.

  • ruby_bin (String) —

    Absolute path to the ruby to run bin_path under.

  • host (String) —

    --host value passed to sessions sync.

  • env (Hash) —

    EnvironmentVariables dict; must contain a non-empty SessionSync::TOKEN_ENV value (resolved by the caller — never resolved here). PATH defaults to DEFAULT_PATH unless the caller supplies its own.

Returns:

  • (String) —

    the full plist XML.

Raises:

  • (ArgumentError) 


35
36
37
38
39
40
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
 
# File 'lib/space_architect/session_sync/plist.rb', line 35

def call(label:, refresh_interval:, log_dir:, bin_path:, ruby_bin:, host:, env:)
  raise ArgumentError, "label is required" if label.to_s.empty?
  raise ArgumentError, "refresh_interval must be > 0" unless refresh_interval.is_a?(Integer) && refresh_interval > 0
  %w[log_dir bin_path ruby_bin].each do |k|
    v = binding.local_variable_get(k)
    raise ArgumentError, "#{k} must be absolute (got #{v.inspect})" unless v.is_a?(String) && File.absolute_path?(v)
  end
  raise ArgumentError, "host is required" if host.to_s.empty?
  raise ArgumentError, "env[#{SessionSync::TOKEN_ENV}] is required" if env.to_h[SessionSync::TOKEN_ENV].to_s.empty?

  out_log = File.join(log_dir, "#{label}.out.log")
  err_log = File.join(log_dir, "#{label}.err.log")

  body = +""
  body << key("Label") << string(label) << "\n"
  body << key("ProgramArguments") << "\n" << array([
    ruby_bin,
    bin_path,
    "sessions",
    "sync",
    "--host", host
  ])
  body << key("EnvironmentVariables") << "\n" << dict({"PATH" => DEFAULT_PATH}.merge(env.to_h))
  body << key("StartInterval") << integer(refresh_interval) << "\n"
  body << key("RunAtLoad") << boolean(true) << "\n"
  body << key("ProcessType") << string("Background") << "\n"
  body << key("StandardOutPath") << string(out_log) << "\n"
  body << key("StandardErrorPath") << string(err_log) << "\n"

  HEADER + body + FOOTER
end