bite-bugzilla

Name

bite-bugzilla - Bugzilla service support

Synopsis

bite bugzilla [<options>] <command> [<args>]: Run a bugzilla subcommand.
bite bugzilla [-h|--help]: Output help information.

Description

Bugzilla service support.

Global Options

-v, --verbose

Increase logging verbosity.

Verbosity levels in increasing order are error, warning, info, debug, and trace. The default level is warning causing errors and warnings to be shown. Each -v/--verbose option specified increases the level up to the maximum so bite -vv … runs the given subcommand at the debug level.

Warning

Running at the trace level leaks authentication data as it outputs raw response structures including URLs which often include injected login parameters for authenticated sessions.

-q, --quiet

Decrease logging verbosity.

-h, --help

Print help output and exit.

Service Options

-c, --connection <name>: Define a service connection to use.

This can either be a pre-configured connection name or a service URL.
-C, --concurrent <value>: Maximum number of concurrent requests to a service.

Certain types of actions such as searching can automatically send concurrent requests to support faster result paging. By default, concurrent requests are disabled.
--certificate <path>: Add a custom root certificate.

This can be used to connect to a server that has a self-signed certificate without having to use --insecure. Note that this requires a PEM encoded certificate file.
--insecure: Ignore invalid service certificates when connecting.
-t, --timeout <seconds>: Set the request timeout in seconds, defaults to 30.

Authentication

-k, --key: Set the API key for service access.
-u, --user: Set the username for service access.
-p, --password: Set the password for service access.

Environment variables

BUGBITE_KEY: Set the API key for service access.
BUGBITE_USER: Set the username for service access.
BUGBITE_PASS: Set the password for service access.

Subcommands

bite-bugzilla-attachment(1): attachment commands
bite-bugzilla-comment(1): get bug comments
bite-bugzilla-create(1): create bug
bite-bugzilla-get(1): get bugs
bite-bugzilla-history(1): get bug changes
bite-bugzilla-search(1): search bugs
bite-bugzilla-update(1): update bugs
bite-bugzilla-version(1): get bugzilla version

Configuration

See the example below for a valid config including authentication information with descriptions of the custom service fields in comments:

Config example

type = "bugzilla"
name = "gentoo"
base = "https://bugs.gentoo.org/"

# username for authentication
user = "bugbite@bugbite.test"

# password for authentication
password = "bugbite"

# API key for authentication
key = "a-random-api-key"

# maximum number of results allowed per search request
max_search_results = 1000