Guides
Each guide here solves one job, with a complete example you can paste in and adapt. They build on How comb works, so read that first if sources, puts and templates are new. A value's life explains how a value is kept current.
Pick the guide for your value
| I want to show… | Guide |
|---|---|
| text shaped, coloured or worked out with comb's own functions | Template functions |
| the output of a command or script | From a command |
something from a file, like a version in package.json | From files |
| something from a web API | From an HTTP API |
| something another program knows, like a deploy status | Data you push |
| a fixed value, or one built from other values | Template namespaces |
| a built-in value, but checked more often, shown differently, or not at all | Change a built-in provider |
| something only native code can get cheaply | Shared-library plugins |
The cheapest way first
If more than one guide fits, pick the one that does the least work per update: reading a file costs least, then a web request, then running a command. A program that already knows the value and puts it costs nothing to keep fresh.