Skip to content

Reference

The low-level surface that every module is built on. Reach for these primitives when you're writing your own integration, gluing together modules, or doing one-off file/symlink/exec work.

lua
local rb = require("rootbeer")

Core

PageDescription
Core APIFile ops, symlinks, exec, profile system.
HostThe rb.host table — OS, arch, hostname, user.

Secrets

PageDescription
SecretsPluggable secret providers — 1Password, embedding vs deferred writes.

Module Authoring

PageDescription
strBlank-line-preserving line splitter and indent helper.
tblSorted iteration for deterministic generator output.

Data Formats

PageDescription
jsonPretty-printed with 2-space indent.
tomlDatetimes decode as strings.
yamlTags decode transparently to scalars.
plistXML output; decode accepts XML or binary.

Script Writers

PageDescription
Script writersrb.scripts.bash / python / script