kata-containers/tests/cmd/github-labels
Beraldo Leal c99ba42d62 deps: bumping yq to v4.40.7
Since yq frequently updates, let's upgrade to a version from February to
bypass potential issues with versions 4.41-4.43 for now. We can always
upgrade to the newest version if necessary.

Fixes #9354
Depends-on:github.com/kata-containers/tests#5818

Signed-off-by: Beraldo Leal <bleal@redhat.com>
2024-05-31 13:28:34 -04:00
..
archive tests: move github-labels to main repo 2023-11-28 11:13:55 -08:00
check.go tests: move github-labels to main repo 2023-11-28 11:13:55 -08:00
clean.go tests: move github-labels to main repo 2023-11-28 11:13:55 -08:00
display_markdown.go tests: move github-labels to main repo 2023-11-28 11:13:55 -08:00
display_text.go tests: move github-labels to main repo 2023-11-28 11:13:55 -08:00
display_tsv.go tests: move github-labels to main repo 2023-11-28 11:13:55 -08:00
display.go tests: move github-labels to main repo 2023-11-28 11:13:55 -08:00
github-labels.sh deps: bumping yq to v4.40.7 2024-05-31 13:28:34 -04:00
labels.yaml tests: move github-labels to main repo 2023-11-28 11:13:55 -08:00
labels.yaml.in tests: move github-labels to main repo 2023-11-28 11:13:55 -08:00
main.go tests: move github-labels to main repo 2023-11-28 11:13:55 -08:00
Makefile tests: move github-labels to main repo 2023-11-28 11:13:55 -08:00
README.md tests: move github-labels to main repo 2023-11-28 11:13:55 -08:00
record.go tests: move github-labels to main repo 2023-11-28 11:13:55 -08:00
types.go tests: move github-labels to main repo 2023-11-28 11:13:55 -08:00
utils.go tests: move github-labels to main repo 2023-11-28 11:13:55 -08:00
VERSION tests: move github-labels to main repo 2023-11-28 11:13:55 -08:00
yaml.go tests: move github-labels to main repo 2023-11-28 11:13:55 -08:00

Overview

The Kata Project uses a number of GitHub repositories. To allow issues and PRs to be handled consistently between repositories a standard set of issue labels are used. These labels are stored in YAML format in the master labels database template. This file is human-readable, machine-readable, and self-describing (see the file for the introductory description).

Each repository can contain a set of additional (repository-specific) labels, which are stored in a top-level YAML template file called labels.yaml.in.

Expanding the templates and merging the two databases describes the full set of labels a repository uses.

Generating the combined labels database

You can run the github_labels.sh script with the generate argument to create the combined labels database. The additional arguments specify the repository (in order to generate the combined labels database) and the name of a file to write the combined database:

$ ./github-labels.sh generate github.com/kata-containers/kata-containers /tmp/combined.yaml

This script validates the combined labels database by performing a number of checks, including running the kata-github-labels tool in checking mode. See the Checking and summarising the labels database section for more information.

Checking and summarising the labels database

The kata-github-labels tool checks and summarizes the labels database for each repository.

Show labels

Displays a summary of the labels:

$ kata-github-labels show labels labels.yaml

Show categories

Shows all information about categories:

$ kata-github-labels show categories --with-labels labels.yaml

Check only

Performs checks on a specified labels database:

$ kata-github-labels check labels.yaml

Full details

Lists all available options:

$ kata-github-labels -h

Archive of old GitHub labels

See the archive documentation.