# DataBuild

## API

A sort of requirements doc for the semantics of DataBuild, enumerating the nouns and verbs they can do.

### Graph

- `analyze` - Produce the job graph required to build the requested set of partitions.
- `build` - Analyze and then execute the produced job graph to build the requested partitions.
- `builds`
  - `list` - List past builds.
  - `show` - Shows current status of specified build and list events. Can tail build events for a build with `--follow/-f`
  - `cancel` - Cancel specified build.
- `partitions`
  - `list` - Lists partitions.
  - `show` - Shows current status of the specified partition.
  - `invalidate` - Marks a partition as invalid (will be rebuilt, won't be read).
- `jobs`
  - `list` - List jobs in the graph.
  - `show` - Shows task statistics (success %, runtime, etc) and recent task results.
- `tasks` (job runs)
  - `list` - Lists past tasks.
  - `show` - Describes current task status and lists events.
  - `cancel` - Cancels a specific task.