fbrnch - "Fed Brunch"
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
- 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
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
--created allow filtering by status.
One can also search for reviews with:
$ fbrnch find-review package-name
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
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.
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] ...
$ fbrnch status -B [package]
outputs information about the status of each branch.
The status command can also be used with
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
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 ...
$ fbrnch prep rawhide package
$ 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 ...
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
There are more commands like
fbrnch --help for details and the full list.
- 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:
- copr-cli for pushing packages.
It also makes use of:
- rpmbuild & rpmspec
- ssh & scp (for uploading package reviews)
fbrnch is packaged in Fedora:
sudo dnf install fbrnch.
Build from source
Clone the git repo and in the source dir, setup the git submodules:
git submodule update --init
- Then either:
a) using stack >= 2.1:
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.
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.