19 · uri_tree — connectors as a YAML URI tree

Install a set of connectors with one line, then view their URIs as a tree (scheme → host → path → {uri}) and build flows by navigating it.

Install the connectors

curl -fsSL 'https://connect.ifuri.com/install?connectors=planfile,sqlite-context,domain-monitor,http-check,time-tools,namecheap-dns,grpc-transport,browser-control' | bash

The /install endpoint turns the comma-separated selection into a bash script that pip installs the urirun runtime plus each urirun-connector-* package.

The uri_tree

build_uri_tree.py reads the same selection from the live connect.ifuri.com catalog and emits uri-tree.yaml — each connector's routes nested as a tree:

uri_tree:
  planfile_tasks:
    status: available
    verified: true
    category: Planning
    description: "Plan, group and execute daily tasks through task:// and planfile:// URI commands."
    schemes:
      task:
        host:
          tickets: { query: { list: { uri: "task://host/tickets/query/list" } } }
          ticket:
            query: { next: { uri: "task://host/ticket/query/next" }, … }
            command: { create: { uri: "task://host/ticket/command/create" }, … }
      planfile:
        host:
          dsl: { command: { run: { uri: "planfile://host/dsl/command/run" } } }

python build_uri_tree.py                         # the 8 connectors above -> uri-tree.yaml
python build_uri_tree.py http-check time-tools   # any selection

Singular vs plural is meaningful and preserved verbatim — ticket (a single resource) and tickets (the collection), record/records, check/checks — they are distinct path segments, so they stay distinct branches.

8 connectors · 39 URI leaves across task, planfile, data, artifact, check, log, monitor, browser, flow, httpcheck, time, dns, transport.

Build a flow by navigating the tree

ops_flow.py resolves leaves from uri-tree.yaml and composes them with urirun-flow — check a site, record it, open a ticket, across three connectors:

up     -> httpcheck://host/http/query/status     (http-check)
log     -> check://host/check/command/add          (sqlite-context)
ticket  -> task://host/ticket/command/create       (planfile)

make tree                                  # regenerate uri-tree.yaml
python ops_flow.py                         # emit the flow YAML
urirun-flow run ops_flow:flow --execute    # run it (needs the connectors installed)

The tree is the index; the flow is one path through it.

Files

View on GitHub →