pagure-cli
A pagure client for querying
projects and users.
Usage
By default it uses the src.fedoraproject.org
Pagure server instance (aka Fedora dist-git), but this can be overriden
by the --server
option.
List/search for repos
$ pagure list emacs\*
emacs
:
Note by default ‘orphan’ owned packages are excluded.
One can also filter by owner or committer.
List user’s projects
Count projects of a user:
$ pagure user -s pagure.io --count mattdm
93
List groups:
$ pagure groups
:
More commands
-
branches
lists the git branches of a repo
-
issues
to query and list issues
-
users
to list usernames of users
-
username
shows the fullname of a user
-
git-url
shows the git urls for a repo
Help
Use --help
to get help on individual commands:
$ pagure list --help
Usage: pagure list [-s|--server SERVER] [-c|--count] [(-j|--json) | (-y|--yaml)]
[(-F|--only-forks) | (-f|--include-forks)]
[-n|--namespace NAMESPACE]
[(-o|--owner OWNER) | (-u|--username USERNAME)] [PATTERN]
list projects
Available options:
-s,--server SERVER Pagure server
-c,--count Show number only
-j,--json Output JSON
-y,--yaml YAML output
-F,--only-forks Only list forks
-f,--include-forks Include forks [default: ignore forks]
-n,--namespace NAMESPACE Specify project repo namespace
-o,--owner OWNER Projects with certain owner
-u,--username USERNAME Projects to which username can commit
-h,--help Show this help text
Installation
To build the latest release you will need cabal-install and ghc, or stack:
stack install pagure-cli
or cabal new-install pagure-cli
.
Or to build from the git source, run directly without the package name.
Binaries
pagure-cli is packaged in Fedora (since F34).
Contributions
Pagure rest API can be found on pagure servers: eg https://pagure.io/api/0.
There are still many unsupported commands and options.
Please open a ticket or PR to request adding more.
Other clients
After writing the initial version I discovered that
Ricky Elrod (relrod) had made https://github.com/fedora-infra/pagure-cli.
I discovered a client in Rust https://pagure.io/ironthree/bodhi-cli by decathorpe.