NAME

repocop-report-txt - a tool that creates txt reports on repocop unit tests results.

SYNOPSIS

repocop-report-txt [-h|--help] [-v|--verbose] [-q|--quiet] [--workdir workdir] [--repocop-acl-file file] [--repocop-acl-altlinux [--acl-branch sisyphus|p10|...] [--acl-expire time] ] [--report warn|fail|skip|experimental|ok] [--report-et|--report-exclude-test comma separated list of tests] [--report-it|--report-include-test comma separated list of tests] [--report-include-distrotests] [--except] [--given] [--last-run] [--by-src-name name ...] [dir|rpm file|repocop_id ...]

DESCRIPTION

repocop-report-txt processes results of repocop unit tests, created with repocop-run command, stored in repocop workdir and creates results in txt form.

ARGUMENTS

The arguments are the set of repocop ids. Repocop IDs can be extracted from rpm files, so you can use an argument like /path/to/rpm/files/*.rpm or just /path/to/rpm/files.

Note that repocop ids are used for internal representation of rpm packages. They differ from pkgids used in repocop reports.

Repocop report package ids are used in repocop reports to identify packages in a human readable way. The repocop report package ID is a string <NAME>-<VERSION>-<RELEASE>.ARCH for binary rpm packages and is a string <NAME>-<VERSION>-<RELEASE>.src for source rpm packages.

Internal Repocop ids are subject to change; current repocop ID is a string <NAME>-<VERSION>-<RELEASE>.ARCH@timestamp for binary rpm packages and is a string <NAME>-<VERSION>-<RELEASE>.src for source rpm packages.

OPTIONS

-r, --report skip|experimental|ok|warn|fail

The level of test results reported. Test results below this level are not reported. Default is warn.

--report-et, --report-exclude-test comma separated list of tests

Include all tests exept the given excluded set.

--report-it, --report-include-test comma separated list of tests

Include the given set of tests.

--report-include-distrotests

Include all distrotests.

--repocop-acl-file file

The file content is ACL db, which is used to sort result by ACL. The argument is generic acl file compatible with Sisyphus' list.src.classic.

Alternatively, you can provide --repocop-acl-altlinux.

--repocop-acl-altlinux

This option is ALTLinux-specific. if provided, repocop use ALTLinux::ACL (perl-ALTLinux-ACL is required). Also, the following options of ALTLinux::ACL become available:

--acl-branch sisyphus|p10|...

Name of branch. Default is sisyphus.

--acl-expire days

Cache expiration time, float, in days. Default is 1/5 day.

--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.

--except, --given

Control processing of rpm id arguments. --given (default) means processing only given rpm arguments. --except means processing all data except given rpm arguments.

-l, --last-run

Use the repocop ids of packages processed at last run as an input.

--by-src-name

Input arguments are expected to be src.rpm names, not repocop ids. Repocop ids are calculated from given src.rpm names.

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.

POD ERRORS

Hey! The above document had some coding errors, which are explained below:

Around line 191:

Unterminated B<...> sequence