Utilities for the Syndicated Actor Model
Go to file
Emery Hemingway d7dd513c97 json_translator: publish and message to initial dataspace 2023-09-05 14:23:32 +02:00
src json_translator: publish and message to initial dataspace 2023-09-05 14:23:32 +02:00
.envrc Better build system 2023-07-01 16:05:46 +01:00
.gitignore Remove http_translator 2023-05-07 09:22:47 +01:00
README.md json_translator: publish and message to initial dataspace 2023-09-05 14:23:32 +02:00
Tuprules.tup Add syndex_card 2023-08-01 10:33:49 +01:00
config.prs json_translator: publish and message to initial dataspace 2023-09-05 14:23:32 +02:00
mpv.config-example.pr Adjust to Syndicate-nim changes 2023-05-18 12:41:52 +01:00
net_mapper.prs Add lost net_mapper code 2023-07-01 16:06:16 +01:00
shell.nix Update for Nim-2.0.0 2023-08-16 10:57:30 +01:00
syndicate_utils.nimble json_translator: publish and message to initial dataspace 2023-09-05 14:23:32 +02:00

README.md

Syndicate utils

json_translator

Wrapper that executes a command, parses its JSON output, converts to Preserves record <recv @jsonData any>, and publishes and messages to its initial dataspace.

json_socket_translator

Utility to communicate with sockets that send and receive lines of JSON using <send …> and <recv …> messages. Compatible with mpv, see mpv.config-example.pr.

Do not send messages immediately to the dataspace passed json_socket_translator, wait until it asserts <connected @socketPath string>.

mintsturdyref

A utility for minting Sturdyrefs.

msg

A utility that sends a message to $SYNDICATE_SOCK in the form <ARGV0 ARG1 … ARGVn>. The $SYNDICATE_STEP variables sets the SturdyRef capability with a default to the SturdyRef generated by <ref { oid: "syndicate" key: #x"" }>.

net_mapper

Publishes ICMP packet round-trip-times. See net_mapper.prs for a protocol description. Source.

Example script:

? <machine-dataspace ?machine> [
  $machine ? <rtt "10.0.33.136" ?min ?avg ?max> [
    $log ! <log "-" { ping: { min: $min avg: $avg max: $max } }>
  ]

  $config [
    <require-service <daemon net_mapper>>
    <daemon net_mapper {
      argv: ["/bin/net_mapper"]
      protocol: application/syndicate
    }>
    ? <service-object <daemon net_mapper> ?cap> [
      $cap { dataspace: $machine }
    ]
  ]
]

preserve_process_environment

This utility serializes it's process environment to Preserves and prints it to stdout. It can be used to feed the environment variables of a nested child of the Syndicate server back to the server. For example, to retreive the environmental variables that a desktop manager passed on to its children.

syndump

Utility for printing assertions and messages. Parses the command-line arguments as a pattern, connects to $SYNDICATE_SOCK, authenticates with the SturdyRef at $SYNDICATE_STEP, and writes observations to standard-output. Published assertions are prefixed by the + character, retractions by -, and messages by !.

Example

# Print patterns in use, filter down with AWK to only the published patterns.
$ FS=':' syndump '<Observe ? _>' | awk -F : '/^+/ { print $2 }'