Skip to content
Tools to helper review packages for inclusion in Fedora
Python Perl Shell
Latest commit bb9bf27 Dec 13, 2013 Stanislav Ochotnicky Merge branch 'release-0.5.1'
Conflicts:
	dist-check/download-dir
	dist-check/run-dir
Failed to load latest commit information.
git-hooks Fix git post-commit hook Jul 8, 2013
json-plugins Fix plugin load paths (part of #148) Sep 24, 2012
plugins [generic] Catch Fedora server errors when checking existing packages Dec 12, 2013
scripts scripts: use consistent naming. Sep 5, 2013
src Prepare for 0.5.1 release Dec 13, 2013
test Prepare for 0.5.1 release Dec 13, 2013
.gitignore Fix more version info Jun 26, 2012
AUTHORS Updating developer info Jan 28, 2013
CONTRIBUTE pep8: bugfix: fix use of configuration file Feb 15, 2013
COPYING COPYING added Jun 2, 2011
NEWS NEWS: update.wq Dec 12, 2013
README doc update Dec 13, 2012
fedora-create-review.1 Add man page for fedora-create-review and fix setup.py accordingly Jan 13, 2012
fedora-review.1 manpage: add report.xml info Sep 2, 2013
fedora-review.spec Prepare for 0.5.1 release Dec 13, 2013
jenkins-poll Updating build scripts Feb 4, 2013
koji-download-scratch [download-scratch] Really use commandline argument for base url Nov 25, 2013
make_release spec: fix build nr in post-release Sep 5, 2013
pep8.conf Ignore E122 (indentation problems) Aug 30, 2013
pylint.conf [qa] pylint config add 2 more ignores Dec 12, 2013
review_template.txt Added the review template file, found in review_template.txt Oct 4, 2011
run-pylint Pylint: fix different messages in pre-1.0/1.0 Nov 20, 2013
setup.py setup.py: using MANIFEST instead of setup.py hack, pep8/pylint fixes. Oct 28, 2012
try-fedora-review try-fedora-review: exit with proper exitcode. Aug 22, 2013
update-version Fix more version info Jun 26, 2012

README

fedora-review: Tools to help review packages for inclusion in Fedora
---------------------------------------------------------------------

This tool automates much of the dirty work when reviewing a package
for the Fedora Package Collection.

Like:
- Downloading SRPM & SPEC from Bugzilla report
- Build and install package in mock
- Download upstream source
- Check md5sums
- Run rpmlint
- Generate review template with both manual & automated checks serving
  as a starting point for the review work.

fedora-review is still under heavy development.


Contacts
--------

* IRC: #fedora-review @ freenode
* Mailing list: fedorareview@lists.fedorahosted.org
* wiki: https://fedorahosted.org/FedoraReview/wiki/WikiStart


License
-------
fedora-review is licensed under GPLv2+, for more details check COPYING.



Download
--------
Clone the source using:

    $ git clone -b devel http://git.fedorahosted.org/git/FedoraReview.git

Alternative repository for users wishing to use github:
git://github.com/timlau/FedoraReview.git. You might consider cloning
another branch e. g., a release branch. However, 'master' branch is
probably not what you want.

Dependencies
------------

Install dependencies:

    # yum install mock
    # yum-builddep fedora-review.spec

The mock requirement is not hard, it's possible to use fedora-review
without mock when always using the --prebuilt/-p option. This means
that packages must be built using other tools e. g., koji. Generally,
installing without mock is not recommended.


Running from git
----------------

After downloading (above) use try-fedora-review:

    $ cd FedoraReview
    $ ./update-version
    $ ./try-fedora-review --help

To run from any directory, install try-fedora-review according to
instructions in that script. update-version only needs to run once.


Usage
-----

    $ nroff -man fedora-review.1 | more
    $ fedora-review --help

There's more in the wiki (above).


Extending
---------

As of 0.4, fedora-review has two plugin interfaces:

 * The native python interface used by modules in the src/checks
   directory. This is the most complete, and is required e. g., when
   defining a new group of tests for a new language. This is
   descibed in the project wiki, at
   https://fedorahosted.org/FedoraReview/wiki/NewPlugin

 * The script interface used by scripts in the scripts/ directory.
   This is a small interface designed to make it possible to write
   simple tests in plain bash. This is covered in the wiki, at
   https://fedorahosted.org/FedoraReview/wiki/ScriptsApi

The json-based interface which existed in earlier versions has been
retired.



Bugs and issues
---------------
Follow link in the wiki.
Something went wrong with that request. Please try again.