plushie/connect

Connect to an already-running plushie renderer via Unix socket or TCP.

Replaces stdio mode when the renderer uses --listen to create a socket and either spawns this process (via --exec) or prints connection info for manual use.

Usage

import plushie/connect

pub fn main() {
  connect.main(my_app.app())
}

Socket resolution (in order)

1. --socket CLI flag
2. PLUSHIE_SOCKET environment variable
3. Error

Token resolution (in order)

1. --token CLI flag
2. PLUSHIE_TOKEN environment variable
3. JSON line from stdin (1 second timeout): {"token":"..."}
4. No token (renderer decides if that’s OK)

Address auto-detection

• Paths starting with / = Unix domain socket
• :port = TCP localhost on that port
• host:port = TCP on specified host and port

pub type ConnectOpts {
  ConnectOpts(format: protocol.Format, daemon: Bool)
}

pub fn default_opts() -> ConnectOpts

pub fn run(
  app: app.App(model, event.Event),
  opts: ConnectOpts,
) -> Nil