Skip to content

kraken run

usage: kraken run [-h] [-v] [-q] [-b PATH] [-p PATH] [--state-name NAME] [--state-dir PATH]
                  [--additional-state-dir PATH] [--no-load-project] [--resume] [--restart {all}] [--all] [--save]
                  [--no-save] [-x TASK] [-X TASK] [-s] [-0]
                  [task ...]

options:
  -h, --help                        show this help message and exit

logging options:
  -v                                increase the log level (can be specified multiple times)
  -q                                decrease the log level (can be specified multiple times)

build options:
  -b PATH, --build-dir PATH         the build directory to write to [default: build]
  -p PATH, --project-dir PATH       the root directory of the project. If this is specified, it should point to an
                                    existing directory that contains a build script and it must be the same or a parent
                                    of the current directory. When invoked with this option, task references are
                                    resolved relative to the Kraken project that is represented by the current working
                                    directory. (note: this option is automatically passed when using kraken-wrapper as
                                    it finds the respective project automatically).
  --state-name NAME                 deprecated since 0.45.0. specify a name for the generated state file; if not
                                    specified, a short random ID is used
  --state-dir PATH                  deprecated since 0.45.0. specify the main build state directory [default: ${--build-
                                    dir}/.kraken/buildenv]
  --additional-state-dir PATH       deprecated since 0.45.0. specify an additional state directory to load build state
                                    from. can be specified multiple times
  --no-load-project                 deprecated since 0.45.0. do not load the root project. this is only useful when
                                    loading an existing build state

graph options:
  --resume                          deprecated since v0.45.0.
  --restart {all}                   load previous build state, but discard existing results (requires --resume)
  --all                             include all tasks in the build graph
  task                              one or more tasks to include in the build graph and mark as selected. if not set,
                                    default tasks are included in the build graph but not selected.
  --save                            deprecated since v0.45.0. the default is to not save.
  --no-save                         deprecated since v0.45.0.

run options:
  -x TASK, --exclude TASK           exclude one or more tasks
  -X TASK, --exclude-subgraph TASK  exclude the entire subgraphs of one or more tasks
  -s, --skip-build                  just load the project, do not build
  -0, --allow-no-tasks              don't error if no tasks got selected