Legatus (legatus v0.2.0)

Copy Markdown View Source

Legatus est ingressus primarius et invocator modorum.

This module is the public runtime entrypoint. It selects :http or :websocket mode and delegates process reality to Legatus.Paramount.

Its responsibility is orchestration, not protocol semantics.

Usage

Via escript:

./legatus <upstream-url>

Via API:

Legatus.invoke("http://localhost:4000/jsonrpc", :http)

Summary

Functions

Invoca Legatum — initiat canalis processum per Paramount.

Reads bearer token from environment.

Functions

invoke(upstream, mode \\ :http)

@spec invoke(String.t(), :http | :websocket) :: :ok

Invoca Legatum — initiat canalis processum per Paramount.

Parametri

  • upstream — URL upstream servi (String)
  • mode — :http | :websocket (default :http)

Resultatum

  • :ok — quando STDIN clauditur (EOF) vel error advenit

Exemplum

Legatus.invoke("http://localhost:4000/jsonrpc", :http)
Legatus.invoke("http://localhost:4000/ws", :websocket)

invoke(upstream, mode, opts)

@spec invoke(String.t(), :http | :websocket, keyword()) :: :ok

read_token()

@spec read_token() :: String.t() | false

Reads bearer token from environment.

Returns token string or false when missing/empty.