GPL-2.0-only licensed and maintained by Jens Petersen
This version can be pinned in stack with:rhbzquery-0.4.5@sha256:14bb64ec6748526d42ceb8a3b872b4ddc7e34961b58de1823dd881511730667b,2576

Module documentation for 0.4.5

There are no documented modules for this package.

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.

Changes

rhbzquery releases

0.4.5 (2025-01-20)

Fields: quote unknown field ParseArg parseField: error on empty parameter User: use simple-prompt promptNonEmpty Help: use ansi-wl-pprint for compatibility with recent optparse-applicative

0.4.4 (2021-09-06)

  • experimental ‘–reverse’ command: converts url to args
  • add ‘arch’/‘platform’ aliases
  • ‘–list-fields’ now prints field aliases too

0.4.3 (2021-02-15)

  • support status with ‘<STATE’ and ‘>STATE’
  • Bugzilla uses ‘notequals’ (not ‘notequal’)
  • fix missing EPEL version prefix

0.4.2 (2021-01-08)

  • add –query command
  • add –server option

0.4.1 (2020-12-17)

  • set no stdout buffering (reported by @clrkwllms)
  • change license from BSD3 to GPLv2+ and add SPDX tags

0.4 (2020-12-11)

  • add –list-operators
  • rename longer operators to be more memorable

0.3 (2020-12-10)

  • add –list-fields option
  • field validation: error for unknown fields
  • for ‘content’ field, map ‘~’/’!~’ to matches/notmatches
  • refactor operator handling to generate help

0.2 (2020-12-09)

  • support most search type operators (regexp, substr, isempty, and negatives)

0.1.1 (2020-12-04)

  • –file a bug
  • –help: do not format FIELDS
  • add testsuite and travis

0.1.0 (2020-12-02)

  • initial release: supports field parameters, status, flags
  • has –mine
  • opens urls with xdg-open