bob

Name

bob - Functional package build system

Synopsis

bob [-h] [-C DIRECTORY] [--version] [--debug DEBUG] [-i]
    [--color {never,always,auto}] [--query {nullset,nullglob,nullfail}]
    [command] ...

Description

Bob is a functional package build system.

Use bob help <command> to get the help for individual commands. The latest documentation can be viewed at https://bob-build-tool.readthedocs.io.

Options

--color

Set color mode of console output. Defaults to auto which will use colors when the output is written to a terminal. Use never to always suppress color output or always to use colors even if the output is not written to a terminal.

-C DIRECTORY, --directory DIRECTORY

Change to directory DIRECTORY before parsing recipes or user configuration. Multiple -C options stack, i.e. -C foo -C bar is equivalent to -C foo/bar.

--debug DEBUG

Debug options. These are subject to change and are left undocumented intentionally.

-i

Ignore the command section in all user configuration files. This will make sure that all commands use their default settings.

--query

Set the behaviour of package queries when no package is matched. The path is evaluated from left to right and the policy is applied on the first occasion when an empty package set remained. See bobpaths(7) for an further information about package queries.

nullset: Empty sets of packages are considered a regular result and never treated as an error. This includes trivial path location steps where exact package names do not match.
nullglob: Return an empty set of packages if the query involves wildcard name matches and/or predicates. Otherwise, that is if only direct name matches are used, an error is raised if a package name in the path does not match. This is the default.
nullfail: An empty set of packages is always treated as an error.

--version

Show version and exit.

User commands

The user commands are intended for interactive usage. Unless otherwise noticed their output is subject to improvements in future versions and usually not intended to be parsed by scripts.

bob-archive: Manage binary artifact archives
bob-build: Build (sub-)packages in release mode
bob-clean: Delete unused src/build/dist paths of release builds
bob-dev: Build (sub-)packages in development mode
bob-graph: Make a interactive dependency graph
bob-help: Display help information about command
bob-init: Initialize build tree
bob-jenkins: Configure Jenkins server
bob-ls: List package hierarchy. The output is suitable to be used in non-interactive scripts.
bob-project: Create project files
bob-show: Show properties of a package
bob-status: Show SCM status

Script commands

The following commands are suitable to be used by non-interactive scripts. Their output and behaviour is kept backwards compatible.

bob-query-meta: Query Package meta information
bob-query-path: Query path information
bob-query-recipe: Query package sources
bob-query-scm: Query SCM information