fedown

Small script written in Python that prints Fedora user access information parsed from the Fedora Pagure API. Licensed under GPLv3.

Contents

• Installation
  • Copr
  • Manual
• Usage
  • Repository query
    • Basic
    • Types
    • Namespaces
    • Examples
  • User query
    • Namespaces
    • Parameters
    • Examples
  • Output format
    • Human readable
    • Colors
  • Flow control
    • Skip on failure
• Recommended aliases

Installation

There is only Copr and manual installation process available at the moment.

---

Copr

• For Fedora you can use Copr builds.

# dnf copr enable panovotn/fedown
# dnf install fedown

• See the Copr repository for more information.

Manual

• The ~/.local/bin directory needs to be included in your PATH environment variable or replaced with one that is.

$ git clone https://github.com/UncleAlbie/fedown.git
$ cd fedown
$ cp fedown/fedown.py ~/.local/bin/fedown
$ chmod +x ~/.local/bin/fedown

---

Usage

To show the usage screen use parameter -h or --help.

$ fedown -h

---

Repository query

Use fedown to query information for given repositories.

---

Basic

• With no extra parameters, fedown prints owner for each given repository. The default namespace is rpms.

$ fedown REPOSITORY [REPOSITORY..]

---

Types

• For different Pagure access types use parameter -t or --type to specify the type.

• Available types:

  • owner query for owner access type
  • admin query for admin access type
  • commit query for commit access type
  • all query for all access types above

$ fedown -t TYPE REPOSITORY [REPOSITORY..]

---

Namespaces

• To query different namespace use parameter -n or --namespace to specify the namespace.

• Available namespaces:

  • rpms query for rpms namespace
  • modules query for modules namespace
  • containers query for containers namespace
  • tests query for tests namespace

• There is one special namespace users which behaves differently from the namespaces above. See user query for more information.

$ fedown -n NAMESPACE REPOSITORY [REPOSITORY..]

---

Examples:

• Replace fakerepo with existing repository name.

$ fedown fakerepo
fakeowner

$ fedown -n tests -t admin fakerepo
fakeadmin01
fakeadmin02
fakeadmin03

---

User query

Use fedown to query information for given users.

---

Namespaces

• To query access information for given users use parameter -n or --namespace to specify the users namespace.

$ fedown -n users USERNAME [USERNAME..]

---

Parameters

• For other access type control use the -t or --type parameter the same way as with repo queries.

$ fedown -n users -t admin USERNAME [USERNAME..]

• Option parameter -F or --include-forks can be used to include forks in the listing.

• Option parameter -N or --names-only can be used to exclude repository namespace prefix from listing.

---

Examples:

• Replace fakeuser with existing username.

$ fedown -n users fakeuser
rpms/fakerepo02

$ fedown -n users -F fakeuser
rpms/fakerepo02
forks/fakeuser/fakerepo01
forks/fakeuser/fakerepo03

$ fedown -n users -F -N fakeuser
fakerepo02
fakerepo01
fakerepo03

$ fedown -n users -t admin fakeuser
rpms/fakerepo03
rpms/fakerepo04
tests/fakerepo01
modules/fakerepo01

---

Output format

Some options to control the fedown output format are available.

---

Human readable

• Option parameter -H or --human-readable can be used to enable human readable ouput format.

$ fedown -H REPOSITORY [REPOSITORY..]

---

Colors

• Option parameter -C or --colors can be used to enable colors (only works with -H or --human-readable).

$ fedown -H -C REPOSITORY [REPOSITORY..]

---

Flow control

Some options to control the fedown behaviour are available.

---

Skip on failure

• By default fedown quits on Pagure API request failure and prints error message to stderr.
• Option parameter -S or --skip-on-failure can be used to prevent quitting on Pagure API request failure.

$ fedown -S REPOSITORY [REPOSITORY..]

---

Recommended aliases

Recommended Bash aliases.

---

• Basic repository queries.

alias fo='fedown -S'
alias fousers='fedown -Sn users'

---

• Basic repository queries (colored human readable).

alias foh='fedown -SHC'
alias fohusers='fedown -SHCFn users'

---

• Query all information in human readable format.

alias foall='fedown -SHCt all'
alias foallusers='fedown -SHCFt all -n users'

---

• Repository owner query for requires based on $PWD.

  • Requires current working directory name to be a rpms repository name
    (eg. ~/sources/pagure/fedora/rpms/fakerepo for fakerepo query).
  • Works with the rpms namespace.
  • Output format: repository: owner
  • For requires in rawhide add --repo=rawhide option argument to the dnf command bellow.

alias forequires='for dep in $(dnf -q repoquery --whatrequires ${PWD##*/} --qf "%{source_name}" | uniq); do echo "${dep}: $(fedown ${dep})"; done'