bpt compile-file

bpt compile-file can be used to compile individual source files in a project or dependency. It accepts the following options:

<filepath> ...

Specify any number of source files that are compiled as part of the project. bpt will compile these files. If any named files are not a part of the project, bpt will fail with an error.

--toolchain <file-or-id>, -t <file-or-id>

Specify the toolchain to use. Can be a filepath to a toolchain file or the name of a built-in toolchain. If not provided, bpt will try to load a default toolchain.

--project <project-path>, -p <project-path>

Specify the filepath to a directory containing a bpt project. If not specified, the project in the working directory will be used.

--no-warn

Disable compiler warnings when compiling the given source files.

--out <output-path>, -o <output-path>

Specify a filepath to the directory where bpt will write its build results and use as scratch space. By default, this will be the _build/ subdirectory of the working directory.

--tweaks-dir <dir>, -TD <dir>

Specify the filepath to a directory containing tweak-headers to be used for the build.

--use-repo <url-or-path>, -r <url-or-path>

Specify the URL or filepath to a package repository to use for package/dependency lookup. This option can be repeated for multiple repositories. The default repository will always be available unless --no-default-repo is specified.

Only packages in any expressly-enabled repositories will be available.

--no-default-repo, -NDR

Disable the default package repository for dependency/package lookup.

This can also be enforced by setting the BPT_NO_DEFAULT_REPO environment variable to a “truthy” value.

--repo-sync {always,cached-okay,never}

Mode for repository metadata synchronization. Default is always.

always

Always try to keep the repository metadata up-to-date. If there is a failure to validate/update the repo metadata, the build fails immediately.

cached-okay

Attempt to update the repository metadata. If a low-level network error prevents such an update and we have cached metadata for the repository, ignore the error and continue.

never

Do not try to update the repository metadata. This option requires that there be a local cache of the repository metadata before being used.

If any packages need to be pulled for the build and those packages are not already locally cached, bpt will still attempt to download those packages from the repository.

Regardless of this option, the HTTP Cache-Control headers for the repository data will be respected. If repository data is within the lifetime of the max-age of the resource, bpt will not try to update the repository data.