fedrq - Man Page

defs <dict[str, list[str]]>

Keys are repo types to pass to -r/--repo. Each repo type takes a list of repo ids to query. All releases MUST have a base def.

   defs.base = ["rawhide", "rawhide-source"]
   # These are defined in rawhide-buildroot.repo which
   # is referenced in `releases.rawhide.defpaths`.
   defs.buildroot = ["fedrq-koji-rawhide", "fedrq-koji-rawhide-source"]

matcher <regex>

Python regex to match -b/--branch names against. Regexes must have one capture group to use as the branch's releasever.
(example: matcher = "^(rawhide)$" or matcher = "^f(\d{2})$")

defpaths <list of paths> (default: [])

List of .repo files to load. All repo(s) MUST have enabled=0. fedrq will enable the appropriate repos that are specified in defs for the user's requested repo type. Paths can be relative or absolute. Relative paths are searched for in the following directories:

• PYTHON_SITELIB/fedrq/data/repos/
• /etc/fedrq/repos/
• ~/.config/fedrq/repos/

copr_chroot_fmt <str> (e.g. fedora-{version} or epel-{version} or fedora-rawhide)

Name of the Copr chroot that corresponds to this release. {version} will be replaced with the releasever.

system_repos <bool> (default: true)

Whether to load the system repository configuration. If all of the repository definitions are specified in defpaths, then it's a good idea to turn this off to avoid conflicts (if e.g. the system configuration defines the same repository IDs) and save time.

Here are some example configuration snippets.

Configuring RPMFusion:

1. Install the applicable rpmfusion release packages.

  $ sudo dnf install 
  	rpmfusion-free-release rpmfusion-free-release-rawhide 
  	rpmfusion-nonfree-release rpmfusion-nonfree-release-rawhide

2. Create a configuration

  # ~/.config/fedrq/rpmfusion.toml

# `releases.rawhide` exists in the default configuration.
# fedrq will merge the extras keys in the `defs` table with the default config.
[releases.rawhide]
# Note that the corresponding -source repositories are enabled.
# All fedrq release defs must have these to ensure all functionality works
# properly (notably subpkgs and whatrequires-src).

# `fedrq CMD -b rawhide -r fusion-free` will enable the following two
# repositories and nothing more.
#
# Use `fedrq CMD -b rawhide -e fusion-free` to enable these repositories
# *in addition* to the default rawhide repositories.
defs.fusion-free = [
    "rpmfusion-free-rawhide", "rpmfusion-free-rawhide-source",
]
defs.fusion-nonfree-only = [
    "rpmfusion-nonfree-rawhide", "rpmfusion-nonfree-rawhide-source"
]
# Enable everything
defs.rpmfusion = [
    # Include all repositories in defs.rpmfusion-free above
    "@fusion-free",
    # Include all repositories in defs.rpmfusion-nonfree-only above.
    "@fusion-nonfree-only",
]
# Make sure that fedrq loads repositories from the system configuration.
# This is the default but better to explicitly specify.
system_repos = true

[releases.branched]
defs.fusion-free = [
    "rpmfusion-free", "rpmfusion-free-source",
    "rpmfusion-free-updates", "rpmfusion-free-updates-source"
]
defs.fusion-nonfree-only = [
    "rpmfusion-nonfree", "rpmfusion-nonfree-source",
    "rpmfusion-nonfree-updates", "rpmfusion-nonfree-updates-source"
]
defs.rpmfusion = [
    "@fusion-free",
    "@fusion-nonfree-only",
]

system_repos = true