Skip to content

juhp/rhbzquery

Repository files navigation

rhbzquery

A cli tool for querying bugzilla.redhat.com.

The tool outputs the bugzilla query url, and if xdg-open is available will try to open the url (unless --dryrun is given).

rhbzquery is distributed under the GPL license version 2 or later.

Usage examples

rhbzquery f41 xyz : Fedora 41 bugs for package xyz

rhbzquery closed rawhide xyz : closed rawhide bugs for package xyz

rhbzquery --mine : your open bugs (gets userid from ~/.bugzillarc)

rhbzquery rhel9.4 bash : RHEL 9.4 bash bugs

rhbzquery "Package Review" reporter_realname="Your Name" : open package reviews you reported

rhbzquery --mine all flag~fedora-review+ : all open and closed approved reviews you reviewed

rhbzquery component~bugzilla summary~bugzilla : open bugs with component and summary containing "bugzilla"

rhbzquery component~python summary~something : open bugs with component including "python" and summary containing "something"

rhbzquery --file f40 xyz : file a bug against the xyz package in F40

rhbzquery --query rhel8 ...: open an advanced bugzilla search for RHEL 8

rhbzquery xyz '<modified': xyz bugs not yet in MODIFIED or ON_QA, etc.

Help

Help describes the arguments: $ rhbzquery --help

Bugzilla query tool

Usage: rhbzquery [--version] [-n|--dryrun] [-m|--mine] [-s|--server SERVER]
                 [(-l|--list-fields) | (-o|--list-operators) | (-f|--file) |
                   (-q|--query) | (-r|--reverse) | (-w|--api)]
                 [[COMPONENT|STATUS|PRODUCTVERSION|FIELD=VALUE|FIELDopVALUE]...]


  Tool for generating bugzilla queries

  STATUS = {new,assigned,post,modified,on_qa,verified,release_pending,closed,
            all (open and closed),'<STATE','>STATE'}
  PRODUCTVERSION = {rawhide,fedora,fXY,epel,epelX,rhel8,rhel7,rhelX.Z}
  op = search operator (eg '~' for substring: "summary~akeyword")

  See https://github.com/juhp/rhbzquery#readme for examples

Available options:
  -h,--help                Show this help text
  --version                Show version
  -n,--dryrun              Do not open url
  -m,--mine                My bugs
  -s,--server SERVER       Bugzilla server [default: bugzilla.redhat.com]
  -l,--list-fields         List query FIELDs
  -o,--list-operators      List op search operator types
  -f,--file                File a bug
  -q,--query               Open advanced query page
  -r,--reverse             Convert url query to args
  -w,--api                 Web API query

rhbzquery --list-fields lists the many fields (not all well supported yet, eg timestamps)

$ rhbzquery --list-operators

         '=' : equals (is equal to)
        '!=' : notequals (is not equal to)
         '~' : substring (contains the string)
        '!~' : notsubstring (does not contain the string)
        '=~' : regexp (matches regular expression)
       '!=~' : notregexp (does not match regular expression)
    '~case~' : casesubstring (contains the string (exact case))
     '~any~' : anywordssubstr (contains any of the strings)
     '~all~' : allwordssubstr (contains all of the strings)
      '~no~' : nowordssubstr (contains none of the strings)
'~anyexact=' : anyexact (is equal to any of the strings)
'~anywords~' : anywords (contains any of the words)
'~allwords~' : allwords (contains all of the words)
 '~nowords~' : nowords (contains none of the words)
   '~empty~' : isempty (is empty)
'~notempty~' : isnotempty (is not empty)
    '~noop~' : noop (ignore (comment out query field))

content~ uses matches
content!~ uses notmatches

lists the search operator types

Installation

Run stack install or cabal install.

Binary packages for Fedora are available from https://copr.fedorainfracloud.org/coprs/petersen/rhbzquery/.

Requests and feedback

Feature requests, bug reports and contributions are welcome.

Please open an issue at https://github.com/juhp/rhbzquery.

About

Red Hat Bugzilla cli query url tool

Topics

Resources

License

Stars

Watchers

Forks