NAME

repocop-run - run unit tests against the repo or a given set of RPM packages

SYNOPSIS

repocop-run [-f|--fakeroot ] [--no-fakeroot ] [--collect ] [--no-collect ] [--posttest ] [--no-posttest ] [--skip-big-binary size] [--skip-big-source size] [--newer] filename [-h|--help] [-v|--verbose] [-q|--quiet] [--workdir workdir] [--pkgcollectors-dir comma separated list of local collectors' dirs] [--srccollectors-dir comma separated list of local collectors' dirs] [--pkgtests-dir comma separated list of local tests' dirs] [--srctests-dir comma separated list of local tests' dirs] [--exclude-test comma separated list of tests] [--include-test comma separated list of tests] [DIR...] [FILE...]

DESCRIPTION

repocop-run collects the data to repocop database and executes a set of tests against each RPM package given on the command line. Precise subset of tests can be selected using --include-test and --exclude-test options. Note that repocop tests are packaged separately. It is recommended to install repocop-unittests-local metapackage.

ARGUMENTS

Each FILE is treated as RPM package. Each DIR is listed with "*.rpm" pattern, and all RPM files found are processed.

OPTIONS

-f,--fakeroot

Always use fakeroot for unpacking rpms. (note: there are stability issues with some versions of fakeroot). It is slower and required only for tests that check ownership and so on.

--no-fakeroot

Do not use fakeroot for unpacking rpms (default).

-f,--collect

run package processing collectors and tests (default)

--no-collect

Skip package processing collectors and tests.

-f,--posttest

run post collectors and tests after package processing (default).

--no-posttest

Skip running post collectors and tests after package processing.

-f,--distrotest

run context dependent distro tests after package processing.

--no-distrotest

Skip running context dependent distro tests after package processing (default).

--tmpdir path

Set default temporary dir to be at path.

--big-tmpdir path

Set the temporary dir for big files to be at path.

--big-binary size

If the binary rpm's size is bigger than size, big-tmpdir is used instead of default temporary dir. kb, mb, gb, Kb,Mb, Gb, k, m, g suffixes are allowed.

--skip-big-binary size

Skip unpacking binary rpms bigger than size. kb, mb, gb, Kb,Mb, Gb, k, m, g suffixes are allowed.

--skip-big-source size

Skip unpacking source rpms bigger than size. kb, mb, gb, Kb,Mb, Gb, k, m, g suffixes are allowed.

--newer filename

Process packages newer then filename only.

--swift|--swift-collect

Swift collect mode. Repocop needs to re-test packages in case some of the collectors or collecting tests changed. --swift|--swift-collect tells repocop that the databases are properly initialized and collectors did not change so there is no need to re-check already tested packages.

By default, repocop autodetects normal or swift mode.

--workdir dir

Provides alternative location for the Repocop workdir. Repocop workdir is a place where test results and packages metadata information are stored. Default is ~/.repocop.

-h, --help

Display this help and exit.

-v, --verbose, -q, --quiet

Verbosity level. Multiple -v increase the verbosity level, -q sets it to 0.

[--pkgcollectors-dir comma separated list of local collectors' dirs]

[--srccollectors-dir comma separated list of local collectors' dirs]

[--pkgtests-dir comma separated list of local tests' dirs]

[--srctests-dir comma separated list of local tests' dirs]

Append user's local tests and collectors to repocop. Those options do not disable or override loading of default tests found in /usr/lib*/repocop and /usr/share/repocop.

[--exclude-test comma separated list of tests]

[--include-test comma separated list of tests]

Include/exclude tests for repocop-run. Those options accept all kinds of repocop tests, including unittests, collectors and distrotests.

AUTHOR

Written by Igor Vlasenko <viy@altlinux.org>.

ACKNOWLEGEMENTS

To Alexey Torbin <at@altlinux.org>, whose qa-robot package had a strong influence on repocop.

COPYING

Copyright (c) 2008-2022 Igor Vlasenko, ALT Linux Team.

This is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.