fbrnch: Build and create Fedora package repos and branches

[ distribution, gpl, library, program ] [ Propose Tags ]

fbrnch is a convenient packaging tool for Fedora Packagers, with integration for Bugzilla, Koji, and Bodhi.

Features include:

[Skip to Readme]
Versions [faq] 0.7.1, 0.7.2, 0.7.3, 0.8.0
Change log CHANGELOG.md
Dependencies aeson, async, base (>=4.9 && <5), bugzilla-redhat (>=0.3), bytestring, config-ini, directory (>=1.2.3), email-validate, extra, filepath, haxr (>=3000.11.4), http-conduit, http-directory (>=0.1.5), http-query, lens, lens-aeson, mtl, network-uri, optparse-applicative, pretty-terminal, process, rpmbuild-order (>=0.4.2), semigroups, simple-cmd (>=0.2.0), simple-cmd-args (>=0.1.6), text, time, typed-process (>=, unordered-containers, utf8-string, xdg-basedir [details]
License GPL-2.0-only
Copyright 2019-2021 Jens Petersen
Author Jens Petersen
Maintainer petersen@fedoraproject.org
Category Distribution
Home page https://github.com/juhp/fbrnch
Bug tracker https://github.com/juhp/fbrnch/issues
Source repo head: git clone https://github.com/juhp/fbrnch.git
Uploaded by JensPetersen at 2021-04-08T06:20:49Z
Distributions NixOS:0.8.0
Executables fbrnch
Downloads 172 total (107 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs available [build log]
Last success reported on 2021-04-08 [all 1 reports]


Maintainer's Corner

For package maintainers and hackage trustees

Readme for fbrnch-0.8.0

[back to package description]

fbrnch - "Fed Brunch"

GPL-2+ license GitHub CI Hackage

A tool to help Fedora Packagers build package branches and add new packages.

Fedora developers use a lot of time building packages across releases and workflow for adding new packages, etc. The motivation for fbrnch is to help to (semi-)automate common workflows to save time and effort.

fbrnch is distributed under the GPL license version 2 or later.


fbrnch is a Fedora Packager client which tries to automate some common tasks like:

  • merging and building a package across release branches
  • automated parallel builds of sets of packages in dependency order
  • creating, updating and listing package reviews
  • requesting new repos and branches
  • importing new packages
  • progressive copr builds
  • rename master branches to rawhide

and more.


Creating new packages/branches

Creating a new package

$ fbrnch create-review [my-new-package]

This will create (or update) an srpm, run rpmlint, then upload it to fedorapeople, perform a scratch build, and open a Review Request in Bugzilla (similar to fedora-create-review).

Update a package review

$ fbrnch update-review [my-new-package]

Similar to create-review: uploads to fedorapeople and posts updated package links to the open package review.

List open package reviews

$ fbrnch reviews

This lists one's open package reviews. Various options like --approved or --created allow filtering by status.

One can also search for reviews with:

$ fbrnch find-review package-name

Request repos

Once a review has been approved

$ fbrnch request-repos

will request repos for approved package(s).

Import a new package

With fbrnch this can be done in one step - no need to clone first.

$ fbrnch import [my-new-package]

will offer to import the srpm from the approved review (similar to fedpkg import). Without any arguments it will offer to import any approved package reviews one by one. The imported package is then built in Koji Rawhide, and the package review updated.

Request branches

Finally you can request branches with

$ fbrnch request-branches

which will confirm which branches you want, unless given.

Optionally a mock build can be done first.


Cloning and switching branch

$ fbrnch clone [package] ...

(one can also clone all one's packages or another user's packages).

$ fbrnch switch f33 [package] ...

You can also git pull:

$ fbrnch pull [package] ...

Package status

$ fbrnch status -B [package]

outputs information about the status of each branch. The status command can also be used with --reviews to check the build status of new packages.

List package bugs:

$ fbrnch bugs [package]

Commit, Merging and Building in Koji

You can commit to the current branch:

$ fbrnch commit

uses any rpm changelog, or you can pass -m "..." or amend with -a.

You can merge branches with:

$ fbrnch merge f32 package

which will offer to merge f33 (or some of it) into f32.

Merging can also be done together with building:

$ fbrnch build f33 package

will offer to merge newer commits from the newer branch. If the branch NVR is also ready pushed and built it will be skipped. Branch builds are pushed to Bodhi.

You can also build all branches:

$ fbrnch build -B package

Scratch builds can also be done:

$ fbrnch scratch rawhide

optionally a different koji target can be given.

You can sort packages by build dependency order:

$ fbrnch sort rawhide package1 package2 package3 package4 ...

Local commands

$ fbrnch prep rawhide package

Build locally:

$ fbrnch local

this works in the current package dir like other commands and one can also specify package.

Locally build and install:

$ fbrnch install package1 package2 package3 ...

Parallel building

fbrnch can sort packages automatically and build them in parallel in Koji in dependency layers (using low-priority background builds to avoid grabbing too many Koji resources).

$ fbrnch parallel --sidetag rawhide pkg-x pkg-y pkg-z pkg-xy pkg-xyz

builds a list of packages in parallel ordered by build dependencies.

Note it requires a sidetag in general, so you need to manage and select them if using more than one per branch with --target.

Other commands

There are more commands like nvr, install-deps, copr.

See fbrnch --help for details and the full list.

Known issues

  • parallel builds will push local package commits without asking
  • currently only checks if already built by NVR not githash
  • authentication is not implemented yet natively for Koji, Bodhi, Pagure (and source upload)
    • so python clients are used for "writing" (specifically koji, bodhi-client, fedpkg), but all queries are done directly by Web RPC for speed and control.

Motivation, history, talks

This project started off (as "fedbrnch") basically as a simple tool to build a package across branches (ie for current releases). Then bugzilla and Bodhi integration was added, and gradually more features, including some generic commands across packages which had already been done before in fedora-haskell-tools.

I have given a couple of short talks about fbranch:

Required runtime tools

fbrnch currently uses these fedora cli tools:

  • fedpkg
  • bodhi
  • koji
  • copr-cli for pushing packages.

It also makes use of:

  • curl
  • rpmbuild & rpmspec
  • klist
  • git
  • ssh & scp (for uploading package reviews)


fbrnch is packaged in Fedora: sudo dnf install fbrnch.

Build from source

  1. Install openssl-devel

  2. Clone the git repo and in the source dir, setup the git submodules:

git submodule update --init

  1. Then either:

a) using stack >= 2.1: stack install


b) with cabal-install (probably 2.4 or later) and cabal-rpm:

$ cabal-rpm builddep
$ cabal new-install --installdir=~/bin


Bug reports, feedback, and fixes are welcome.

See the TODO list and also the many FIXME comments scattered across the source. It is better to ask before embarking on large changes.

Usual disclaimer

This is still in active development. While it is generally works well for me, if it should breaks things for you, you get to keep the pieces. :) But please do report unsupported or unintuitive workflows.