pagure-cli: Pagure client

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

A command-line Pagure client for querying projects and users.

[Skip to Readme]

Properties

Versions	0.1, 0.2, 0.2.1, 0.2.1, 0.2.2
Change log	CHANGELOG.md
Dependencies	aeson, aeson-pretty, base (<5), bytestring, filepath, optparse-applicative, pagure (>=0.1.1), semigroups, simple-cmd-args (>=0.1.6), text, unordered-containers, yaml [details]
License	GPL-2.0-only
Copyright	2019-2020,2022 Jens Petersen
Author	Jens Petersen <juhpetersen@gmail.com>
Maintainer	Jens Petersen <juhpetersen@gmail.com>
Category	Utility
Home page	https://github.com/juhp/pagure-cli
Bug tracker	https://github.com/juhp/pagure-cli/issues
Source repo	head: git clone https://github.com/juhp/pagure-cli.git
Uploaded	by JensPetersen at 2022-02-17T19:25:16Z

Downloads

pagure-cli-0.2.1.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

Package maintainers

JensPetersen

For package maintainers and hackage trustees

edit package information

Readme for pagure-cli-0.2.1

[back to package description]

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.