# 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>.