Tools to helper review packages for inclusion in Fedora
Python Perl M4 Shell Groff
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
git-hooks
json-plugins Fix plugin load paths (part of #148) Sep 24, 2012
plugins
scripts
src
test
.gitignore
AUTHORS Updating developer info Jan 28, 2013
CONTRIBUTE pep8: bugfix: fix use of configuration file Feb 15, 2013
COPYING
Makefile
NEWS NEWS: update. May 2, 2016
README
fedora-create-review.1 Add man page for fedora-create-review and fix setup.py accordingly Jan 13, 2012
fedora-review.1
fedora-review.spec
jenkins-poll
koji-download-scratch Clean up koji-download-scratch and create-review (#260). Nov 26, 2015
make_release Update upstream spec changelog. May 12, 2015
pep8.conf
pylint.conf
review_template.txt
run-pylint
setup.py
try-fedora-review
update-version

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.