copr-cli - Man Page

usage: copr-cli create [-h] --chroot CHROOTS [--repo REPOS] [--initial-pkgs PKGS] [--description Description] [--instructions INSTRUCTIONS] [--disable_createrepo DISABLE_CREATEREPO] [--enable-net {on,off}] [--unlisted-on-hp {on,off}] [--persistent] [--auto-prune {on,off}] [--isolation {default, nspawn, simple}] name

--chroot

Chroot to use for this project​. Can be specified multiple times, but at least one must be present​.

--repo

Repository to add to this project​. Can be specified multiple times​.

--initial-pkgs

List of packages to build in this new project​. Can be specified multiple times​.

--description

Description of the project​.

--instructions

Instructions for the project​.

--disable_createrepo

Disables automatic repository metadata generation​. Accepted values for DISABLE_CREATEREPO: true/false​.

--enable-net

If net should be enabled for builds in this project​.

--unlisted-on-hp

This project will not be listed on COPR home page​.

--persistent

Project and its builds will be undeletable​. This option can only be specified by a COPR admin​.

--auto-prune

If backend auto-prunning script should be run for this project​. This option can only be specified by a COPR admin​.

--isolation ISOLATION

Choose the isolation method for running commands in buildroot

name

Can be just name of the project or in form username/projectname or @groupname/projectname​.

usage: copr-cli modify [-h] [--repo REPOS] [--chroot CHROOTS] [--description Description] [--instructions INSTRUCTIONS] [--disable_createrepo DISABLE_CREATEREPO] [--enable-net {on,off}] [--unlisted-on-hp {on,off}] [--auto-prune {on,off}] [--isolation {default, nspawn, simple}] name

Alters only specified project property​.

--repo

Repository to add to this project​. Can be specified multiple times​.

--chroot

Chroot to use for this project​. Can be specified multiple times​. When this option is not used, chroots in the project remain unchanged​. Once you specify a chroot, it is going to be enabled in the project, but current chroots will not be preserved if they are not specified​.

--description

Description of the project​.

--instructions

Instructions for the project​.

--disable_createrepo

Disables automatic repository metadata generation​. Accepted values for DISABLE_CREATEREPO: true/false​.

--enable-net

If networking should be enabled for builds in this project​.

--unlisted-on-hp

This project will not be listed on COPR home page​.

--auto-prune

If backend auto-prunning script should be run for this project​. This option can only be specified by a COPR admin​.

--isolation ISOLATION

Choose the isolation method for running commands in buildroot

name

Can be just name of the project or in form username/projectname or @groupname/projectname​.

usage: copr-cli regenerate-repos [-h] copr

copr

Can be just name of the project or in form username/projectname or @groupname/projectname​.

usage: copr-cli build [-h] [-r, --chroot CHROOTS] [--memory MEMORY] [--timeout TIMEOUT] [--nowait] [--background] [--isolation {default, nspawn, simple}] [--enable-net {on,off}] copr_repo PKG [PKG ​...]

-r, --chroot

If you don’t need this build for all the project’s chroots​. You can use it several times for each chroot you need​. Supports glob patterns​.

--exclude-chroot

If you don’t need this build for all the project’s chroots​. You can use it several times for each chroot you don’t need​. Supports glob patterns​.

--memory

Override memory for this build​. This is actually not used and it have no effect​.

--timeout

Specify build timeout (seconds), if the build takes longer than that, it is terminated and fails​. The default is usually set to 5 hours on Copr Frontend​.

--nowait

Don’t wait for build completion​.

--background

Run the build at a lower priority​.

--isolation ISOLATION

Choose the isolation method for running commands in buildroot​.

--enable-net

If networking should be enabled for this build​.

copr_repo

The copr repository to build the package in​. This can be a simple name of some of your projects or it can be specified fully as username/project or @groupname/project​. This way you can build into the project of another user or group, provided you have permissions to do so​. Finally, instead of just project name, you can also pass project:tag​. In that case, the build will land into the project side repository instead of the main repository​. The side repository of the name project:tag will be automatically created if it doesn’t exist yet​. You can e​.g​. use this feature to launch test builds while the main user-facing repository stays intact​. You can specify any tag that is appropriate for the given build(s)​.

PKG

This can be either file on your local workstation or URL of the package to build​. When URL is used, then the package must be placed on a public web or ftp server​. Note that you cannot combine local file paths and URLs in one command line and local-file builds are limited to the first specified PKG​. This limitation comes from the COPR API​.

usage: copr-cli uploadrpm [-h] [-r, --chroot CHROOTS] [--memory MEMORY] [--timeout TIMEOUT] [--nowait] [--background] copr_repo RPM

Publish an already-built local RPM directly to a project, skipping the SRPM build phase entirely​.

For the arguments, see copr-cli build command above​.

RPM

Local path to the already-built ​.rpm file to publish​.

usage: copr buildpypi [-h] [-r, --chroot CHROOTS] [--memory MEMORY] [--timeout TIMEOUT] [--nowait] [--background] [--with-deps] [--pythonversions [VERSION [VERSION ​...]]] [--packageversion PYPIVERSION] --packagename PYPINAME project

--pythonversions [VERSION [VERSION ​...]]

For what Python versions to build (by default: 3 2)

--packageversion PYPIVERSION

Version of the PyPI package to be built (by default latest)

--packagename PYPINAME

Name of the PyPI package to be built, required​.

--with-deps

Build also the dependencies of the package​. The dependency tree is resolved by the coprtree library​. Requires the python3-coprtree package to be installed​. Please report bugs in the dependency resolution to https://github​.com/sundaram123krishnan/coprtree

For the rest of the arguments, see copr-cli build command above​.

usage: copr buildscm [-h] --clone-url CLONE_URL [--commit COMMITTISH] [--subdir SUBDIRECTORY] [--spec SPEC] [--type {git,svn}] [--method {rpkg,tito,tito_test,make_srpm}] [--memory MEMORY] [--timeout TIMEOUT] [--nowait] [-r CHROOTS] [--background] copr_repo

Build package from a Git/DistGit/SVN repository​.

--clone-url CLONE_URL

clone url to a project versioned by Git or SVN, required

--commit COMMITISH

branch name, tag name, or git hash to be built

--subdir SUBDIRECTORY

relative path from the repo root to the package content

--spec SPEC

relative path from the subdirectory to the ​.spec file

--type TYPE

Specify versioning tool​. Default is git​.

--method METHOD

Srpm build method​. Default is rpkg​.

For the rest of the arguments, see copr-cli build command above​.

usage: copr-cli download-build [-h] [-d, --dest DESTINATION] [-r, --chroot CHROOT] build_id

build_id

Download built packages for build identified by build_id​.

-d, --dest

Base directory to store packages

-r, --chroot

Fetch only selected chroots​. Can be specified multiple times​.

usage: copr delete-build [-h] build_id [build_id ​...]

build_id

ID of the build to be deleted​. Can be specified multiple times​. Note that specifying multiple build_id is much faster than calling copr delete-build multiple times, because in the first case createrepo is called only once​.

usage: copr edit-chroot [-h] [--upload-comps FILEPATH | --delete-comps] [--packages PACKAGES] [--repos REPOS] [--isolation {default, nspawn, simple}] coprchroot

Edit the specified coprchroot​.

coprchroot

Path to a project chroot as owner/project/chroot or project/chroot

--upload-comps FILEPATH

Filepath to the comps​.xml file to be uploaded

--delete-comps

Deletes already existing comps​.xml for the chroot

--packages PACKAGES

space separated string of package names to be added to buildroot (e​.g​. "gcc ghc")

--repos REPOS

space separated string of additional repo urls for chroot (e​.g​. "http://foo http://bar")

--isolation ISOLATION

Choose the isolation method for running commands in buildroot

usage: copr get-chroot [-h] coprchroot [--output-format {json, text, text-row}]

Print info of the given chroot​.

coprchroot

Path to a project chroot as owner/project/chroot or project/chroot

--output-format FORMAT

Set the formatting style​. We recommend using json, which prints the required data in json format​. The text format prints the required data in a column, one piece of information per line​. The text-row format prints all information separated by a space on a single line​.

usage: copr-cli edit-permissions [-h] [--admin USERNAME[=VALUE]] [--builder USERNAME[=VALUE]] PROJECT

Edit roles/permissions on a copr project​.

PROJECT

An existing copr project​.

--admin USERNAME[=VALUE]

Set the admin role for USERNAME in PROJECT, VALUE can be one of approved|request|nothing (default=approved)​.

--builder USERNAME[=VALUE]

Set the builder role for USERNAME in PROJECT, VALUE can be one of approved|request|nothing (default=approved)​.

usage: copr-cli list-permissions [-h] PROJECT

Print the copr project roles/permissions​.

PROJECT

An existing copr project​.

usage: copr-cli request-permissions [-h] [--admin [VALUE]] [--builder [VALUE]] PROJECT

Request (or reject) your role in the copr project​.

PROJECT

An existing copr project​.

--admin [VALUE]

Request/cancel request/remove your admin permissions in PROJECT​. VALUE can be one of request|nothing (default=request)​.

--builder [VALUE]

Request/cancel request/remove your builder permissions in PROJECT​. VALUE can be one of request|nothing (default=request)​.

usage: copr add-package-pypi [-h] [--pythonversions [VERSION [VERSION ​...]]] [--packageversion PYPIVERSION] --packagename PYPINAME --name PKGNAME [--webhook-rebuild {on,off}] [--chroot-denylist CHROOT_DENYLIST] project

Add package of PyPI source type​.

--pythonversions [VERSION [VERSION ​...]]

For what Python versions to build (by default: 3 2)

--packageversion PYPIVERSION

Version of the PyPI package to be built (by default latest)

--packagename PYPINAME

Name of the PyPI package to be built, required

--name PKGNAME

Name of the package to be edited or created

--webhook-rebuild {on,off}

Enable auto-rebuilding

--chroot-denylist CHROOT_DENYLIST

Comma-separated list of wildcard patterns of chroots to exclude from builds, e​.g​. fedora-,epel--i386

usage: copr edit-package-pypi [-h] [--pythonversions [VERSION [VERSION ​...]]] [--packageversion PYPIVERSION] --packagename PYPINAME --name PKGNAME [--webhook-rebuild {on,off}] [--chroot-denylist CHROOT_DENYLIST] project

Edit source definition and type of an existing package​. Options are shared with add-package-pypi​.

copr-cli add-package-scm [options]

usage: copr add-package-scm [-h] --clone-url CLONE_URL [--commit COMMITTISH]
                            [--subdir SUBDIRECTORY] [--spec SPEC]
                            [--type {git,svn}]
                            [--method {rpkg,tito,tito_test,make_srpm}] --name
                            PKGNAME [--webhook-rebuild {on,off}]
                            [--chroot-denylist CHROOT_DENYLIST]
                            copr

Add package of SCM source type​.

--clone-url CLONE_URL::
clone url to a project versioned by Git or SVN, required

--commit COMMITISH::
branch name, tag name, or git hash to be built

--subdir SUBDIRECTORY::
relative path from the repo root to the package content

--spec SPEC::
relative path from the subdirectory to the ​.spec file

--type TYPE::
Specify versioning tool​. Default is 'git'​.

--method METHOD::
Srpm build method​. Default is 'rpkg'​.

--name PKGNAME::
Name of the package to be edited or created

--webhook-rebuild {on,off}::
Enable auto-rebuilding

--chroot-denylist CHROOT_DENYLIST::
Comma-separated list of wildcard patterns of chroots to exclude from
builds, e​.g​. 'fedora-*,epel-*-i386'


`copr-cli edit-package-scm [options]`

usage: copr edit-package-scm [-h] --clone-url CLONE_URL [--commit COMMITTISH] [--subdir SUBDIRECTORY] [--spec SPEC] [--type {git,svn}] [--method {rpkg,tito,tito_test,make_srpm}] --name PKGNAME [--webhook-rebuild {on,off}] [--chroot-denylist CHROOT_DENYLIST] copr

Edit package of SCM source type​.

usage: copr add-package-rubygems [-h] [--gem GEM] --name PKGNAME [--webhook-rebuild {on,off}] [--chroot-denylist CHROOT_DENYLIST] project

Add package of RubyGems source type​.

--gem GEM

Specify gem name

--name PKGNAME

Name of the package to be edited or created

--webhook-rebuild {on,off}

Enable auto-rebuilding

--chroot-denylist CHROOT_DENYLIST

Comma-separated list of wildcard patterns of chroots to exclude from builds, e​.g​. fedora-,epel--i386

usage: copr edit-package-rubygems [-h] [--gem GEM] --name PKGNAME [--webhook-rebuild {on,off}] [--chroot-denylist CHROOT_DENYLIST] project

Edit source definition and type of an existing package​. Options are shared with add-package-rubygems​.

usage: copr add-package-custom [-h] --script SCRIPT [--script-chroot SCRIPT_CHROOT] [--script-builddeps SCRIPT_BUILDDEPS] [--script-resultdir SCRIPT_RESULTDIR] [--script-repos SCRIPT_REPOS] --name PKGNAME [--webhook-rebuild {on,off}] [--chroot-denylist CHROOT_DENYLIST] [--max-builds MAX_BUILDS] [--timeout TIMEOUT] project

Add package of Custom source type​.

--script SCRIPT

Text file (script) to be used to prepare the sources

--script-chroot SCRIPT_CHROOT

Mock chroot to build sources for the SRPM in

--script-builddeps SCRIPT_BUILDDEPS

Space separated list of packages needed to build the sources

--script-resultdir SCRIPT_RESULTDIR

Where SCRIPT generates the result, relatively to script’s $PWD (defaults to ​.)

--script-repos SCRIPT_REPOS

Space separated string of additional repo urls for script dependencies

--name PKGNAME

Name of the package to be edited or created

--webhook-rebuild {on,off}

Enable auto-rebuilding​.

--chroot-denylist CHROOT_DENYLIST

Comma-separated list of wildcard patterns of chroots to exclude from builds, e​.g​. fedora-,epel--i386

--max-builds MAX_BUILDS

Keep only the specified number of the newest-by-id builds (garbage collector is run daily), zero disables (default)

--timeout TIMEOUT

Number of seconds we allow the builds to run, default is 18000 (5h)

usage: copr edit-package-custom [-h] --script SCRIPT [--script-chroot SCRIPT_CHROOT] [--script-builddeps SCRIPT_BUILDDEPS] [--script-resultdir SCRIPT_RESULTDIR] [--script-repos SCRIPT_REPOS] --name PKGNAME [--webhook-rebuild {on,off}] [--chroot-denylist CHROOT_DENYLIST] [--max-builds MAX_BUILDS] [--timeout TIMEOUT] project

Edit source definition and type of an existing package​. Options are shared with add-package-custom​.

usage: copr list-packages [-h] [--with-latest-build] [--with-latest-succeeded-build] [--with-all-builds] [--output-format {json, text, text-row}] project

Lists all packages in the given project in json format​.

--with-latest-build

Also display data related to the latest build for each package​.

--with-latest-succeeded-build

Also display data related to the latest succeeded build for each package​.

--with-all-builds

Also display data related to the builds for each package​.

--output-format FORMAT

Set the formatting style​. We recommend using json, which prints the required data in json format​. The text format prints the required data in a column, one piece of information per line​. The text-row format prints all information separated by a space on a single line​.

usage: copr list-package-names [-h] project

Only list package names in the given project line by line​.

usage: copr get-package [-h] --name PKGNAME [--with-latest-build] [--with-latest-succeeded-build] [--with-all-builds] [--output-format {json, text, text-row}] project

Similar to list-packages but returns just a single package directly as json structure (not wrapped in a list)​.

--output-format FORMAT

Set the formatting style​. We recommend using json, which prints the required data in json format​. The text format prints the required data in a column, one piece of information per line​. The text-row format prints all information separated by a space on a single line​.

usage: copr delete-package [-h] --name PKGNAME project

Deletes package and all its builds from the given project​.

usage: copr reset-package [-h] --name PKGNAME project

Clears default source of a package and its source type (all the package settings are lost after invoking this!)​.

usage: copr build-package [-h] [--memory MEMORY] [--timeout TIMEOUT] [--nowait] [-r CHROOTS] --name PKGNAME project

Creates a new build of the given package from its source definition​.

--name PKGNAME

Name of a package to be built

For the rest of the arguments, see copr-cli build command above​.

usage: copr mock-config [-h] project chroot

Get the mock profile (similar to koji mock-config), print it to standard output​. The configuration can be slightly different from the real mock configuration used by Copr Builders, but should be similar enough for basic debugging (e​.g​. by mock --shell)​.