koji list-component-builds

usage: koji list-component-builds [-h] [-f NVR_FILE] [--tag TAG] [--inherit]
                                  [--latest] [--nvr-sort | --id-sort]
                                  [--lookaside LOOKASIDE]
                                  [--shallow-lookaside SHALLOW_LOOKASIDE]
                                  [--limit LIMIT]
                                  [--shallow-limit SHALLOW_LIMIT]
                                  [--type BUILD_TYPE] [--rpm] [--maven]
                                  [--image] [--win] [-c CG_NAME]
                                  [--imports | --no-imports]
                                  [--completed | --deleted]
                                  [--param KEY=VALUE] [--env-params]
                                  [--output FLAG:FILENAME] [--no-entry-points]
                                  [--filter FILTER | --filter-file FILTER_FILE]
                                  [NVR [NVR ...]]

List a build's component dependencies

positional arguments:
  NVR                   Build NVRs to list components of

optional arguments:
  -h, --help            show this help message and exit
  -f NVR_FILE, --file NVR_FILE
                        Read list of builds from file, one NVR per line.
                        Specify - to read from stdin.

Components of tagged builds:
  --tag TAG             Look for components of builds in this tag
  --inherit             Follow inheritance
  --latest              Limit to latest builds

Sorting of builds:
  --nvr-sort            Sort output by NVR in ascending order
  --id-sort             Sort output by Build ID in ascending order

Filtering by tag:
  --lookaside LOOKASIDE
                        Omit builds found in this tag or its parent tags
  --shallow-lookaside SHALLOW_LOOKASIDE
                        Omit builds found directly in this tag
  --limit LIMIT         Limit results to builds found in this tag or its
                        parent tags
  --shallow-limit SHALLOW_LIMIT
                        Limit results to builds found directly in this tag

Filtering by type:
  --type BUILD_TYPE     Limit to builds with this BType. May be specified
                        multiple times to allow for more than one type.
  --rpm                 Synonym for --type=rpm
  --maven               Synonym for --type=maven
  --image               Synonym for --type=image
  --win                 Synonym for --type=win

Filtering by origin:
  -c CG_NAME, --content-generator CG_NAME
                        show content generator imports by build system name.
                        Default: display no CG builds. Specify 'any' to see CG
                        imports from any system. May be specified more than
                        once.
  --imports             Limit to imported builds
  --no-imports          Invert the imports checking

Filtering by state:
  --completed           Limit to completed builds
  --deleted             Limit to deleted builds

Filtering with Sifty sieves:
  --param KEY=VALUE, -P KEY=VALUE
                        Provide compile-time values to the sifty filter
                        expressions
  --env-params          Use environment vars for params left unassigned
  --output FLAG:FILENAME, -o FLAG:FILENAME
                        Divert results marked with the given FLAG to FILENAME.
                        If FILENAME is '-', output to stdout. The 'default'
                        flag is output to stdout by default, and other flags
                        are discarded
  --no-entry-points, -n
                        Disable loading of additional sieves from entry_points
  --filter FILTER       Use the given sifty filter predicates
  --filter-file FILTER_FILE
                        Load sifty filter predictes from file

This command identifies the builds used to produce another build.

The set of NVRs to tag can be fed to this command in multiple ways. They can be specified as arguments, or they can be specified using the --file option to reference either a file containing a list of NVRs (one per line) or - to indicate stdin. If NVRs are specified on the command line and also via --file then the two lists will be concatenated in that order.

If no NVRs are given as arguments, and the --file option isn't specified, and stdin is detected to not be a TTY, then the list of NVRs will be read from stdin.

Filtering Builds with Sifty Dingo

This command supports filtering using the Sifty Dingo Filtering Language. Sieve predicates can be specified inline using the --filter option or loaded from a file using the --filter-file option.

It's important to note that sifty dingo filtering only happens after any conventional filtering has been applied, and thus only those builds which have passed the conventional filters will be fed into the sifter.

References