Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Tools to helper review packages for inclusion in Fedora

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
git-hooks Fix git post-commit hook
json-plugins Fix plugin load paths (part of #148)
plugins [generic] Catch Fedora server errors when checking existing packages
scripts scripts: use consistent naming.
src Prepare for 0.5.1 release
test Prepare for 0.5.1 release
.gitignore Fix more version info
AUTHORS Updating developer info
CONTRIBUTE pep8: bugfix: fix use of configuration file
COPYING COPYING added
NEWS NEWS: update.wq
README doc update
fedora-create-review.1 Add man page for fedora-create-review and fix setup.py accordingly
fedora-review.1 manpage: add report.xml info
fedora-review.spec Prepare for 0.5.1 release
jenkins-poll Updating build scripts
koji-download-scratch [download-scratch] Really use commandline argument for base url
make_release spec: fix build nr in post-release
pep8.conf Ignore E122 (indentation problems)
pylint.conf [qa] pylint config add 2 more ignores
review_template.txt Added the review template file, found in review_template.txt
run-pylint Pylint: fix different messages in pre-1.0/1.0
setup.py setup.py: using MANIFEST instead of setup.py hack, pep8/pylint fixes.
try-fedora-review try-fedora-review: exit with proper exitcode.
update-version Fix more version info

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.