crowbar(1)

SYNOPSIS

crowbar [--working-dir <dir>] <command> [<options>] [<arguments>]

DESCRIPTION

crowbar is a CLI tool for building packages defined by crowbar.txtpb files. It is built on top of LUCI’s cipkg to leverage its reproducibility and caching mechanisms.

By default, crowbar operates within the Git repository containing the current working directory.

GLOBAL OPTIONS

--working-dir <dir>: Overrides current working directory to <dir>.

COMMANDS

build

crowbar build [--overwrite] <package>…

Builds the specified packages.

The package Argument

Paths starting with . are resolved from the working directory.
Paths not starting with . are resolved from Git repository’s root.
Each path must point to a directory that contains a crowbar.txtpb file.

Options

--overwrite: Write the build result to the local Git checkout.

fmt

crowbar fmt

Formats all crowbar.txtpb files found under the current working directory.

CROWBAR.TXTPB CONFIGURATION

Each package typically contains:

"upstream" description, which typically are HTTP URLs (e.g. zip files or tarballs) or Git commit references.
"Input" describing steps to transform upstream into code or build artifacts. Typical actions include "unpack" and "patch".
"Output" describing where the result should be stored (e.g. inside the Git checkout for vendoring code, or to be published to CIPD).

Example of a typical third-party dependency distributed as a ZIP archive that does not require local patches:

upstream {
  artifacts {
    name: "foo-1.0.zip"
    http: {
      url: "https://example.com/foo-1.0.zip"
      digest: "sha256:abcdef..."
    }
  }
}
stages {
  input {
    unpack { default {} }
  }
  output {
    update { git {} }
  }
}

COMMON USAGE

To build a package in a local directory and update the checkout with the result:

crowbar build ./path/to/package --overwrite

CHROMIUM DEPOT_TOOLS

Part of the chromium depot_tools(7) suite. These tools are meant to assist with the development of chromium and related projects. Download the tools by checking out the git repository.

crowbar(1) Manual Page

NAME