pagure-cli: Pagure client

[ gpl, program, utility ] [ Propose Tags ]

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

[Skip to Readme]

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

Candidates

0.1, 0.2, 0.2.1

Versions [RSS]	0.1, 0.2, 0.2.1
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:55:05Z
Distributions	Fedora:0.2.1, LTSHaskell:0.2.1, NixOS:0.2.1, Stackage:0.2.1
Executables	pagure
Downloads	853 total (19 in the last 30 days)
Rating	(no votes yet) [estimated by Bayesian average]
Your Rating	λ λ λ
Status	Docs not available [build log] Last success reported on 2022-02-17 [all 1 reports]

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.