pagure-cli: Pagure client

[ gpl, program, utility ] [ Propose Tags ]

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


[Skip to Readme]

Downloads

Maintainer's Corner

For package maintainers and hackage trustees

Candidates

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 645 total (11 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

Hackage GPL-2 license Stackage Lts Stackage Nightly

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.