Skip to content
the foundry for unfolding Timeless Stack builds. Reach evaluates higher-level pipelines which template Repeatr formulas, and automatically invokes Repeatr in sequences to do build pipelines.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gopath
actors/maestro
app
cmd/reach
examples
gadgets
lib/iofilter
.gitignore
.gitmodules
CONTRIBUTING.md
HACKME.md
LICENSE
README.md
module.tl

README.md

Reach

Reach is a core part of the Timeless Stack; Reach understands pipelines of computations, and generates formulas for Repeatr to evaluate.

tl;dr: if you're looking at Repeatr and thinking "wow, that's neat, but I don't want to copy-paste a bunch of hashes"... Reach is the thing that fixes that for you.

By Example

hellomodule

This is a very basic example, and only has one "step" -- so it will only generate one formula.

This example is still interesting, because it demonstrates the use of catalogs to solve the human-readable-name => hash usability issue.

more examples

Look at the other directories in ./examples :)

You'll find examples of more complex modules with multiple steps -- Reach will automatically resolve dependencies in these modules, and execute steps in dependency order, feeding outputs of one step into inputs of the next.

You'll also find examples of modules which contain "submodules", which are nested definitions that look like more modules, but can have "parent:{localName}" references as their imports -- these give us a way to create reusable snippets of pipeline which have locally scoped names (like a function), and thus we can compose them without having to do name munging. (You should still probably write Layer 3 helper functions to compose things, but locally scoped names in the serial format help by taking the munging work out, and also make the result clearer to read.)

API edges

Reach drives Repeatr around via JSON API.

Reach is meant to be a user-facing CLI tool. You can configure it with json config files.

Reach json files (namely modules) are meant to be human-readable and human-writable. However, they can also get quite verbose for large projects. It is explicitly intended to be reasonable to generate module json with a higher level language. (In other words, Reach is "Layer 2" in the Timeless Stack model, and you should feel free to implement your own business logic constructs in "Layer 3" that generate module json.)

Reach only performs non-turing complete operations (excluding what occurs inside containers, of course) -- that is, the Reach modules express a dependency DAG, but there is not (and will not be) support for modules which generate more steps, etc. Build this kind of feature at Layer 3.

Other things that deserve a mention in docs

Reach development is in a rapid iteration phase and PRs for documentation are more than welcome :)

  • workspaces
  • ingests -- git and pack and how to use them (well)
  • ci mode
  • catalog authoring and syncing tools
  • relationship of "modules" to "replay instructions" in releases (they're the same!)
  • "candidates mode" for distro-scale multi-module release coordination
You can’t perform that action at this time.