Legatus.Escript (legatus v0.2.0)

Copy Markdown View Source

Escriptum est forma invocationis terminalis Legati.

This module is the command-line operational envelope around runtime entry. It translates shell invocation into process startup and controlled exit.

Its role is executability, not domain semantics.

Usage

./legatus <upstream-url> [--ws] [--log]

Token(if your MCP reqiires it)

export token="your-token"

Examples

./legatus http://localhost:4000/jsonrpc
./legatus https://api.example.com/rpc
./legatus ws://localhost:4000/ws --ws --log

Operatio

  1. Parse CLI arguments once.
  2. Invoke one runtime process via Legatus.invoke(upstream, mode, opts).
  3. Runtime loop (STDIN/WS lifecycle) is owned by Legatus.Paramount.*.
  4. Exit when runtime process terminates.

Nota

  • UTF-8 encoding configuratur pro STDOUT
  • Chronica scribit ad legatus.log solum cum --log
  • Sine --log Chronica manet muta
  • STDIN error tractatur ut graceful shutdown

Summary

Functions

main(args)

parse_args(args)

@spec parse_args([binary()]) ::
  {:ok, String.t(), :http | :websocket, keyword()} | :error

run(args, message)

@spec run([binary()], binary()) :: :ok | no_return()