Run an approved command
Build a one-program catalogue for your own tool, feed it stdin, read the result, and meet both ways Cuprum refuses a program.
Work order 002 · Examples
Worked examples
A job sheet for each job: the problem, complete code, the output it prints, and what happens when it fails.
Featured · Job sheet 001
Run an approved command
Build a one-program catalogue for your own tool, feed it stdin, read the result, and meet both ways Cuprum refuses a program.
BeginnerCataloguePolicy
WC = Program("wc")
CATALOGUE = ProgramCatalogue.from_programs(WC, name="word-count")
count_words = sh.make(WC, catalogue=CATALOGUE)
def word_count(text: str) -> int:
cmd = count_words("-w")
with scoped(catalogue=CATALOGUE):
result = cmd.run_sync(stdin=StdinInput(text=text))
if not result.ok:
msg = f"wc failed with exit code {result.exit_code}: {result.stderr}"
raise RuntimeError(msg)
return int((result.stdout or "").strip())
Verified 2026-10-19 · Cuprum 0.2.0b2 · Python 3.12 · Linux
The cabinet
Every job sheet
A sheet is published once its code and expected output have been run against the pinned release.
Published 5
-
Job sheet 001 -
Job sheet 002 Pipeline, tee, and stage failure
Compose two stages with |, tee the output to the terminal while capturing it, and read which stage failed when fail-fast stops the rest.
-
Job sheet 003 A deployment helper with scoped policy
Working directory, environment overlays, a timeout, and cleanup, all under one narrowed scope.
-
Job sheet 004 Observe CI commands
Hooks, structured events, and the opt-in GitHub Actions sink that folds each run into a log group.
-
Job sheet 005 Run jobs concurrently
Bounded concurrency with run_concurrent, fail-fast or collect-all, and inspecting every result.