Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

file 114 lines (96 sloc) 2.881 kb
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114
.TH "fedora-review" 1
.SH NAME
fedora-review \- Automatically review RPM packages for Fedora.

.SH SYNOPSIS
.B fedora-review
-b <bug number>
.br
.B fedora-review
-n <package name>

.SH DESCRIPTION

This tool makes reviews of rpm packages for Fedora easier. It tries to automate most of the process.
Through a json API the checks can be extended in any programming language and for any programming language.
We have at the moment checks for C/C++, R, Java and Perl packages.

.SH USAGE
This program runs a number of checks for packages in Fedora.
.HP
fedora-review -b <bug number>

It will download the SPEC & SRPM files from the Bugzilla report and
build them in mock and run a number of test and generate a report
there will be opened in editor along with the spec file, so the things
not automated can be reviewed manually.

.HP
fedora-review -n <package name>

This alternative usage expects <package name>.spec and source rpm in current
directory.

.PP
You will need to have mock installed and be member of the mock group
for the build to work. Run as root:
.HP
 usermod -a -G mock [your user name] && newgrp mock

.PP
To assign bugs in bugzilla automatically you will first have to login
into bugzilla (--login). This will create a bugzilla cookie so you
don't have to login every time.

.SH OPTIONS
.B -b / --bug
    Identifier of the ticket on the bugzilla where is the package to review.
.sp
.B -n / --name
    Runs the checks against the named spec and source rpm located in the current working directory.
.sp
.B -w / --workdir
    Specify in which working directory to work.
.sp
.B --other-bz
    URL for another bugzilla.
.sp
.B --assign
    Assign the bugzilla ticket to yourself.
.sp
.B --cache
    Do not redownload the files from bugzilla, use the local one.
.sp
.B --nobuild
    Do not rebuild the source rpm, use the currently built one.
.sp
.B -l / --login
    Login into Fedora Bugzilla before starting.
.sp
.B -v / --verbose
   Provides a more detailed output of what's going on.
.sp
.B --no-report
   Do not generate the review report.
.sp
.B --mock-config
   Specify which mock config to use.
.sp
.B --mock-options
   Passes options onto mock for the build.

.SH FILES
.I $HOME/.config/fedora-review/settings
.RS
User configuration files for fedora-review
.RE

.I /usr/share/fedora-review/plugins
.RS
System-wide external plugins directory
.RE

.I $HOME/.config/fedora-review/plugins/
.RS
User supplied external plugins directory
.RE

.SH ENVIRONMENT
.TP
.B REVIEW_EXT_DIRS
    If REVIEW_EXT_DIRS is set, it specifies additional directories that will be searched for external plugins

.SH AUTHORS
  Original author: Tim Lauridsen <tim.lauridsen@gmail.com>

  Developers:
      Stanislav Ochotnicky <sochotnicky@redhat.com>
      Pierre-Yves Chibon <pingou@pingoured.fr>

  For a list of all contributors see AUTHORS file

.sp
.sp
No known bugs at this time
Something went wrong with that request. Please try again.