CLI for Gentoo Build Publisher
Introduction
This is a command-line interface for Gentoo Build Publisher, a system that combines Gentoo Linux and CI/CD so that updating a Gentoo predictable and consistent.
This is a pip-installable Python package:
$ pip install gbpcli
Usage
The full command set supported:
The URL for the Gentoo Build Publisher may be provided via the command line or
by using the BUILD_PUBLISHER_URL environment variable.
Additional commands may be provided by plugins.
To list the machines which have builds use gbp machines:
The "Latest" column shows the latest build ID for the given machine. If the ID is in bold it that denotes that the latest build is published (available for emerges).
To list the available builds for a given machine us gbp list <machine>:
In the above example, the P output for build 52 signifies that this build
is currently published. The * flag means that the respective build has new
binary packages. The K for build 1 means that the build is marked for
keeping and will not be removed during the purge process. Build 52 has also
been given "hello" and "world" tags. The N flag for builds means that the
builds have notes attached.
Edit/delete build notes using the gbp notes command.
The status subcommand displays metadata about a given build. If the build
number is not given, it defaults to the latest build for that machine.
The diff subcommand display differences between two builds.
If the second build number is not given, it defaults to the latest build for that machine. If the first build number is not given, it defaults to the published build for that machine.
The publish subcommand makes the given build available for syncing and
updating/downgrading.
$ gbp publish arm64-base 151
If the build number is not given, it defaults to the latest build for that machine.
The build subcommand can schedule a build in CI/CD for the given machine,
e.g.:
$ gbp build babette
Configuration
In addition to the command-line flags, gbpcli can also be configured using a
configuration file. If a the file ~/.config/gbpcli.toml exists it will be
read and used to configure gbpcli. This file should be
toml formatted. For example:
[gbpcli]
url = "http://gbpbox/"
my_machines = ["babette", "lighthouse", "polaris"]
auth = { user = "marduk", api_key = "myapikey" }
The url setting can be used in place of the --url command-line option or
the BUILD_PUBLISHER_URL environment variable. The my_machines settings
can be used in place of the --my-machines command-line option or the
GBPCLI_MYMACHINES environment variable. The auth setting can only be
supplied through the configuration file.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file gbpcli-3.5.0.tar.gz.
File metadata
- Download URL: gbpcli-3.5.0.tar.gz
- Upload date:
- Size: 42.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
64573bee9116004074018ddf0dba43b53b8b8430aa3276e257631d6a5d6128d3
|
|
| MD5 |
55ae16176ea23f61930452012e4a6dea
|
|
| BLAKE2b-256 |
a1fd4bc61679f4310c5f06c238fc69c826ffbe8cf9f777f00a4105234ee433b3
|
File details
Details for the file gbpcli-3.5.0-py3-none-any.whl.
File metadata
- Download URL: gbpcli-3.5.0-py3-none-any.whl
- Upload date:
- Size: 38.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7604c812506537bd3f0d978fc1dda9541357e47d1f992f202f44462afe7668d5
|
|
| MD5 |
0da1f0c7cc30add673e72e064ed09a79
|
|
| BLAKE2b-256 |
80fffbb60a33d0154acb16e78f8e4ee26e4f351e13dedef7b3fcb8b610285721
|
