pagure-cli: A Pagure gitforge query tool

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]

Warnings:

These packages miss upper bounds: - aeson - aeson-pretty - bytestring - filepath - http-query - optparse-applicative - pagure - semigroups - simple-cmd - simple-cmd-args - text - unordered-containers - yaml Please add them, using `cabal gen-bounds` for suggestions. For more information see: https://pvp.haskell.org/

A command-line Pagure (gitforge) client for querying and listing projects, users, groups, and issues.

[Skip to Readme]

Properties

Versions	0.1, 0.2, 0.2.1, 0.2.2, 0.2.2
Change log	CHANGELOG.md
Dependencies	aeson, aeson-pretty, base (<5), bytestring, filepath, http-query, optparse-applicative, pagure (>=0.2), semigroups, simple-cmd, simple-cmd-args (>=0.1.6), text, unordered-containers, yaml [details]
License	GPL-2.0-only
Copyright	2019-2020,2022,2024 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 2024-05-06T13:39:16Z

Downloads

pagure-cli-0.2.2.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.2

[back to package description]

pagure-cli

A pagure gitforge client for querying and listing projects (repos), users, groups, and issues.

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 rac\*

rpms/raceintospace
rpms/racket

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 --server pagure.io --count mattdm

List groups:

$ pagure groups
:

List group packages

$ pagure group budgie-sig

rpms/libxfce4windowing
rpms/sassc
rpms/wlrctl

$ pagure group -c rust-sig

Help

$ pagure --version

0.2.2

$ pagure --help

Pagure client

Usage: pagure [--version] COMMAND

  Simple pagure CLI

Available options:
  -h,--help                Show this help text
  --version                Show version

Available commands:
  list                     list projects
  user                     list user repos
  group                    list group repos
  project                  show project details
  branches                 list project branches
  git-url                  show project repo's git urls
  issues                   list project issues
  issue                    show project issue
  users                    list users
  username                 fullname of user
  userinfo                 show user details
  groups                   list groups
  groupinfo                show group details

Use --help to get help on individual commands:

Installation

pagure-cli is packaged in Fedora and EPEL 9: https://src.fedoraproject.org/rpms/pagure-cli

Build from source

To build the latest release you will need cabal-install and ghc, or stack:

stack install pagure-cli or cabal install pagure-cli.

Or to build from the git source, run the commands without the package name.

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 at https://github.com/juhp/pagure-cli.

Also part of this client uses the simple pagure-hs bindings.

Other pagure clients

After writing the initial version I discovered that Ricky Elrod (relrod) had made https://github.com/fedora-infra/pagure-cli.

There is a library client in Rust https://pagure.io/ironthree/pagure-rs by decathorpe.