Version 0.17.0
* Support for preserving existing package configuration on up/downgrade
and reconfiguration.
* Support for the enable clause in the `tests` package manifest value.
* New per package configuration *-build-*email manifest values.
* New build-bot package manifest value allows specifying package-custom
build bots.
* Support for specifying package archives and directories as dependencies
for pkg-build.
* New `none` value for the --recursive option in pkg-bindist.
* Empty --archive-lang* option values in pkg-bindist are now treated as a
request to clear previous entries.
Version 0.16.0
* System package manager query/installation support for Debian and Fedora
(and alike).
The pkg-build command will now query (unless --sys-no-query is specified)
the system package manager on Debian (and alike, such as Ubuntu) and
Fedora (and alike, such as RHEL) for versions of packages that are
specified as coming from the system (the sys: scheme). For example, if
running the following command on one of these distributions:
bpkg build hello ?sys:libsqlite3
Then pkg-build will query the system package manager for the installed
version of libsqlite3 and fail if none is present.
Additionally, if --sys-install is specified, pkg-build will attempt to
install such packages if not present but available from the system package
repository.
Other relevant options include --sys-yes, --sys-no-fetch, --sys-no-stub,
and --sys-sudo. See bpkg-pkg-build(1) for details.
See also the `*-{name, version, to-downstream-version}` package manifest
values in the manual for details on the bpkg to distribution package name
and version mapping.
* Binary distribution package generation support for Debian and Fedora (and
alike).
The new pkg-bindist command can be used to automatically generate binary
distribution packages from bpkg packages for Debian (and alike, such as
Ubuntu), Fedora (and alike, such as RHEL), and for other operating systems
as installation archives. For Debian and Fedora, dependencies can be
satisfied with system packages, bpkg packages, or bundled. See
bpkg-pkg-bindist(1) for details.
* Package build configuration support (*-build-config manifest values).
A package can now customize in its manifest the build configuration used
by automated build bots. This includes specifying configuration variable
values, forcing specific versions of dependencies, satisfying dependencies
with system packages, and enabling/disabling build bot steps. For example:
# Test with extras enabled.
#
extras-build-config: config.libfoo.extra=true
# Test with system-installed libsqlite3.
#
system-builds: sys
system-build-config: ?sys:libsqlite3
# Enable Debian binary distribution generation and upload.
#
bindist-debian-builds: bindist
bindist-debian-build-include: linux_debian*-**
bindist-debian-build-include: linux_ubuntu*-**
bindist-debian-build-exclude: **
bindist-debian-build-config:
\
+bpkg.bindist.debian:
+bbot.bindist.upload:
\
See the `*-build-config` package manifest values in the manual for
details.
* New package-description and package-description-{file,type} package
manifest values.
Compared to the description* values, these can be used to provide a bpkg
package-specific description, such as the recommended usage, configuration
variables, etc. See the `description`, `package-description` package
manifest values in the manual for details.
* New changes-type package manifest value and type auto-detection, similar
to description.
See the `changes` package manifest value in the manual for details.
* New --deorphan pkg-build option.
This option can be used to replace orphaned packages (packages that no
longer have the corresponding package available in the repository it came
from) with the closest available package versions that satisfy all the
constraints.
* New --mask-repository* pkg-build options.
These options allow pretending for the duration of the pkg-build command
execution that the specified repository was removed as if by performing
the rep-remove command.
* New --dependent-exit pkg-drop option.
This option causes the pkg-drop command to silently exit with the
specified error code if attempting to drop dependent packages.
* New --git-capabilities common option to override auto-detected git
capabilities.
We now also assume the git repository protocol is smart if the HTTP
response code is 401 (requires authentication).
* curl is now used instead of wget as the default fetch program.
We used to prefer wget 1.16 because it has --show-progress which results
in nicer progress. But experience shows that wget is quite unreliable plus
with bdep always using curl, it would be strange to use both curl and wget
(and expecting the user to setup proxy, authentication, etc., for both).
Version 0.15.0
* New dependency declaration features:
- Dependency groups, for example:
depends: { libboost-any libboost-log libboost-uuid } ~1.77.0
- Conditional dependencies, for example:
depends: libposix-getopt ^1.0.0 ? ($cxx.target.class == 'windows')
- Dependency alternatives, for example:
depends: libmysqlclient >= 5.0.3 | libmariadb ^10.2.2
- Reflected configuration variables, for example:
depends: libposix-getopt ^1.0.0 \
? ($cxx.target.class == 'windows') \
config.hello.external_regex=true
Or:
depends: libmysqlclient >= 5.0.3 config.hello.db='mysql' | \
libmariadb ^10.2.2 config.hello.db='mariadb'
- Dependency configuration, for example:
depends:
\
libmariadb ^10.2.2
{
require
{
config.libmariadb.cache = true
if ($cxx.target.class != 'windows')
config.libmariadb.tls = true
}
}
\
Or:
depends:
\
libmariadb ^10.2.2
{
prefer
{
config.libmariadb.cache = true
config.libmariadb.buffer = ($config.libmariadb.buffer < 4096 \
? 4096 \
: $config.libmariadb.buffer)
}
accept ($config.libmariadb.buffer >= 4096)
}
\
See the `depends` package manifest value in the manual for details.
The implementation of these features led to bpkg becoming a special build
system driver with repository metadata now containing the minimal subset
of build system files for each package (called the package build system
skeleton). See "Package Build System Skeleton" in the manual for details.
* Support for JSON output in the bpkg-pkg-status command.
See the --stdout-format option in bpkg-pkg-status(1) for details.
* New --all, --all-pattern bpkg-pkg-drop options.
These options can be used to drop all the held packages (in case of
--all-pattern, limited to those that match a wildcard pattern).
* New --keep-tmp common option.
This option instructs bpkg not to remove its temporary directory at the
end of the command execution and print its path if the verbosity level is
2 or higher. This option is primarily useful for troubleshooting.
Version 0.14.0
* Support for configuration types, configuration linking, and build-time
dependencies.
Configurations can now be linked with each other to allow a package to be
built in one configuration while its dependencies -- in one or more linked
configurations. This can be used to create a "base" configuration with
common dependencies that are shared between multiple configurations.
Configurations now also have types with the three predefined types being
`target` (the default) `host` (used for build-time dependencies), and
`build2` (used for build system modules). This mechanism together with
configuration linking is used to provide separate configurations for
build-time dependencies, for example, tools that need to be executed or
build system modules that need to be loaded during the build.
If during dependency resolution a build-time dependency is encountered and
there is no build configuration of a suitable type linked with the target
configuration, then a private configuration of the needed type is
automatically created and linked.
New relevant commands: bpkg-cfg-{link,unlink,info}.
Command with relevant changes (new options, etc): bpkg-cfg-create,
bpkg-pkg-{build,status}.
See bpkg-cfg-create(1) for details on this functionality.
* Tests, examples, and benchmark packages can now also be run-time or build-
time.
See the `tests`, `examples`, and `benchmarks` package manifest values for
details.
* Two new pre-defined automated build bot requirements: `bootstrap` (package
is a build system module that requires bootstrapping) and `host` (package
is normally used as build-time dependency and should be built in a host
configuration).
See the `requires` package manifest value for details.
* Configuration of an external package is now preserved between upgrades and
downgrades.
The same behavior for normal packages is still a TODO. The old behavior
can be achieved with the new --disfigure bpkg-pkg-build option that forces
a from-scratch reconfiguration.
* New `min-bpkg-version` repositories manifest value that allows specifying
the minimum supported bpkg version.
See also the new --min-bpkg-version bpkg-rep-create option.
* Change of the `build-email` package manifest value semantics.
Now build result notifications are only sent if this value is explicitly
specified (before we used to fallback to `email`).
* New --immediate|-i and --recursive|-r bpkg-pkg-{update,clean} options.
These options can be used to additionally update or clean immediate or all
dependencies of a package, respectively.
* New --all-pattern bpkg-pkg-{update,clean,test,install,uninstall} option.
This option can be used to perform the command on all the held packages
that match a wildcard pattern.
* New --rebuild-checksum bpkg-pkg-build option.
This option can be used to avoid rebuilds if the result of a dependency
resolution for a package has not changed.
* New --noop-exit bpkg-pkg-build option.
This option can be used to request a distinct exit code if the build is
a noop (performs no new package builds, upgrades, etc).
* New --output-{root,purge} bpkg-pkg-checkout and --checkout-{root,purge}
bpkg-pkg-build options.
* New --keep-config bpkg-pkg-disfigure option.
* New BPKG_DEF_OPT environment variable that can be used to suppress loading
of default options files.
Version 0.13.0
* The SPDX License Expression is now the default scheme for the 'license'
package manifest value.
See the "license" section in the manual for details.
* New --pkg-proxy common option.
This option specifies the proxy server to use when fetching package
manifests and archives from remote pkg repositories. See the option
documentation in bpkg-common-options(1) for details.
* External test packages can now have their own build constraints.
Version 0.12.0
* Ability to specify the full package version constraint in the pkg-build
command.
For example:
$ bpkg build "bar < 2.0.0"
See bpkg-pkg-build(1) for details.
* Support for default options files (aka tool config files).
See the bpkg-default-options-files(1) help topic for background and the
DEFAULT OPTIONS FILES section in each command's man pages for specifics.
* Support for tests, examples, and benchmarks as separate packages.
See the "tests, examples, benchmarks" section in the manual for details.
Version 0.11.0
* The 'tags' package manifest value has been deprecated and replaced with
'keywords' (list of space-separated words) and 'topics' (list of comma-
separated, potentially multi-word concepts). For example:
topics: xml parser, xml serializer
keywords: sax dom
* New 'description-type' package manifest value allows specifying the
content type of the 'description' or 'description-file' value. Currently
recognized values are:
text/plain
text/markdown
text/markdown;variant=GFM
text/markdown;variant=CommonMark
* New 'upstream-version' package manifest value allows preserving the
original version for information.
* The pkg-build command can now "build" a system package that doesn't have a
stub provided its version is specified explicitly. For example:
$ bpkg build ... ?sys:libsqlite3/* ?sys:libcurl/7.47.0
* New cfg-create --existing|-e option allows initializing a bpkg
configuration based on an existing build system configuration instead of
creating a new one from scratch. For example:
$ b create: build-clang/,cc config.cxx=clang++
$ bpkg create -d build-clang --existing
* New rep-info --deep option triggers the replacement of '*-file' package
manifest values with the contents of the referenced files.
Version 0.10.0
* Only minor improvements and bug fixes.
Version 0.9.0
* Support for the ssh:// protocol in the git repository URLs.
* The repository type can now be specified in the repository URL's scheme
component. For example:
$ bpkg build git+https://example.org/project
* New 'builds' package manifest value for specifying the build configuration
classes the package should or should not be built for. For example:
builds: -windows
Note also that the 'build-include' and 'build-exclude' pattern matching
semantics has been adjusted to distinguish between single-component ('*')
and multi-component ('**') matches. See the manual for details.
* Support for the '$' dependent package's version special value in the
package manifest dependency constraints.
This mechanism is primarily useful when developing related packages that
should track each other's versions exactly or closely. For example:
name: sqlite3
version: 3.18.2
depends: libsqlite3 == $
See the 'depends' package manifest value in the manual for details.
* Support for passing configuration variables in the bpkg-pkg-build command.
* New 'build-warning-email' and 'build-error-email' package manifest values
for specifying alternative emails for different diagnostics levels. See
the manual for details.
* New --jobs|-j option for specifying the number of jobs to perform in
parallel.
* New --no-progress option for suppressing progress indicators.
* New --deep option for the bpkg-pkg-verify command. See the command's man
pages for details.
* Values to the --openssl* options can now be qualified with the command
they should apply to.
Version 0.8.0
* New optional 'project' manifest value that specifies the project the
package belongs to. See the manual for details.
* Make package manifest 'url' and 'email' values optional.
* Make default versioning epoch 1 instead of 0 (0 is now reserved for
"foreign" packages).
* New --manifest option for the pkg-verify command that allows extracting
package's manifest file.
* New --{repositories|packages}-file options for the rep-info command.
This allows saving both manifests with a single invocation (which is the
only way to guarantee they are consistent).
Version 0.7.0
* Support for using git repositories as package repositories. See the
bpkg-repository-types(1) help topic for details (structure, URL format).
* Support for ~ and ^ version constraint operators. See the 'depends'
package manifest value documentation in the manual for details.
* The pkg-build command has been significantly reworked. In particular, it
allows "building" repositories in addition to packages (primarily useful
with version control-based repositories) and upgrading (--upgrade|-u) or
patching (--patch|-p) immediate (--immediate|-i) or all (--recursive|-r)
dependencies of a package. See bpkg-pkg-build(1) for details.
* The pkg-status has been significantly reworked. In particular, it allows
querying the status of immediate (--immediate|-i) or all (--recursive|-r)
dependencies of a package. See bpkg-pkg-status(1) for details.
* New commands: rep-list, rep-remove, and pkg-checkout. See their respective
man pages for details.
* The pkg-{test,install,uninstall} commands now also support --immediate|-i
and --recursive|-r options (testing/installation of dependencies).
* The pkg-{update,clean,test,install,uninstall} commands now support the
--all|-a option.
* The rep-fetch command now supports shallow fetching and fetching only a
specific repository. See bpkg-rep-fetch(1) for details.
* New --for|-f <operation> option to the pkg-update and pkg-build commands.
This allows executing build2 *-for-X operations (e.g., update-for-install
or update-for-test) in order to minimize the amount of stuff to be
updated.
* New --fetch-timeout common option.
* The repositories, packages, and signature files now use the .manifest
extension.
Version 0.6.0
* Add doc-url and src-url manifest values.
* Support for repository certificate wildcards.
A wildcard in the *.example.com form matches any single-level subdomain
while **.example.com -- any subdomains. See the bpkg-repository-signing(1)
help topic for details.
Version 0.5.0
* Multiple usability fixes and improvements.
* The test suite has been rewritten in Testscript and can now be used on all
supported platforms.
Version 0.4.0
* Support for repository signing and authentication.
The rep-create command can now sign the repository with rep-fetch(fetch)
and rep-info authenticating it. See the bpkg-repository-signing(1) help
topic for details.
* Support for system packages.
Now a package can be "built" as available from the system rather than
compiling it from source. To specify a system package the new sys: package
scheme is used, for example:
bpkg build sys:libsqlite3
Currently, if no version is specified for a system package, then it is
considered to be unknown but satisfying any dependency constraint (such a
wildcard version is displayed as '*'). In the future bpkg will support
querying system package managers (rpm, dpkg, pkg-config) for the installed
version.
See the pkg-build(build) man page for details.
* Support for stub packages.
A stub is a package without source code. It has the special upstream
version 0 (with a possible revision, for example 0+1) and can only be
built as a system package.
* Support for build-time dependencies.
Now a depends: value in the package manifest that starts with '*' is
recognized as a built-time dependency. Currently, build-time dependencies
are treated in the same way as normal (run-time) ones except that the
'build2' and 'bpkg' names are recognized as special. They can be used to
specify a constraint (usually the required minimum version) on the build2
build system and package manager, respectively. In the future, the
semantics for build-time dependencies will be extended, for example, to
verify that they can be executed on the build machine and/or to build them
in a separate configuration in case of cross-compilation.
* The pkg-build(build) command now offers to automatically update dependent
packages that were reconfigured.
It also supports the following new options:
--drop-prerequisite|-D
--update-dependent|-U
--leave-dependent|-L
As well as the -K alias for --keep-prerequisite. See the command's man
page for details.
* The pkg-drop(drop) command now supports the following new options:
--keep-dependent|-K,
--drop-prerequisite|-D
--keep-prerequisite
See the command's man page for details.
* The cfg-add command was renamed to rep-add (the add alias stays the same)
and cfg-fetch to rep-fetch (the fetch alias stays the same).
* The new -V option is an alias for --verbose 3 (show all commands).
Version 0.3.0
* Command line options and arguments can now be specified in any order. This
is especially useful if you want to re-run the previous command with -v:
bpkg update libfoo -v
* The pkg-build command now offers to drop prerequisite packages that are no
longer necessary. This can happen if a package that is being upgraded or
downgraded changes its prerequisite set. You can use the
--keep-prerequisite option to suppress this behavior.
* The pkg-build command now updates all packages at once (that is, with a
single build system invocation) instead of sequentially one at a time.
This should improve performance, especially once parallelism is supported.
* The rep-create command now loads the description-file and changes-file
files from the package archives and includes their contents inline into
the 'packages' manifest file.
Version 0.2.1
* The pkg-build command no longer considers an argument as a potential
package directory unless it ends with a directory separator.
Version 0.2.0
* First public release.