Skip to content
Get Started

Worked Examples

Each example builds a small project, changes it step by step, and shows barca’s real output after every change, so you can see what reruns and what is served from cache. Each page names the barca version it was run with. For short “how do I…” answers, see Recipes.

  • One Asset, No Inputs

    One asset with no inputs, rechecked with barca 0.42.0. What is written to disk, when it is served from cache, and how to look at the result.

  • One Asset, One Input

    One asset that reads another, rechecked with barca 0.42.0. What runs after each kind of change, and what --refresh and --no-cascade do.

  • Partitions, Step by Step

    One asset definition run once per key, each key cached on its own. What runs when keys, code or a sensor change, how to look at the results, and the limits on 0.30.2.

  • Renaming and Moving an Asset

    What happens to an asset's cache and history when its function is renamed or its file is moved, with and without an explicit name=, rechecked on barca 0.42.0.

  • Freshness and Schedules

    What the freshness argument does. Schedule fires a node under barca serve, Always nodes below it follow its ticks, and a Manual node is refreshed by hand only.

  • Sensors and Outside Data

    A sensor reports the version of data that lives outside the graph, so the assets that read that data re-run when it changes.

  • Timeouts and Cancelling

    Timeouts, retries and cancellation as they work in barca 0.42.0. Ad hoc runtime parameters are not implemented.

  • Tasks, Step by Step

    A task does something (deploy, notify, migrate), always runs, and is run with barca run. A worked example with real output.