openSUSE-release-tools/docs/totest.asciidoc

ToTest Plugin Documentation
===========================
:author: openSUSE Team at SUSE
:toc:


Introduction
------------
[id="intro"]

In the current Factory model,
https://build.opensuse.org/project/show/openSUSE:Factory:ToTest[Factory:ToTest]
represents the project that stores several Factory Snapshots that are
candidates to be released if the measured quality (according to
openQA) is good enough.

This plugin encapsulates several conditions that are needed to decide
if a snapshot can be published or not:

* Check if the overall status of openQA is green.

* Check if all the repositories in openSUSE:Factory can be published.

If Factory meets both criteria, this plugin will publish a new version
of the project openSUSE:Factory:ToTest, if the version is different
from the current Factory.


Installation
------------
[id="install"]

Clone this repository:

-------------------------------------------------------------------------------
git clone https://github.com/openSUSE/osc-plugin-factory.git
-------------------------------------------------------------------------------

Link the plugin and the library in +~/.osc-plugins+ or +/var/lib/osc-plugins+.

-------------------------------------------------------------------------------
cd osc-plugin-factory
ln -sr ./osc-totest.py ./osclib ~/.osc-plugins
-------------------------------------------------------------------------------


Command line
------------
[id="cli"]

This plugin does not have any parameters, and needs to be executed with
the proper permissions in OBS.