.. _createrepo_directive:


createrepo_directive - create a YUM repository from RPM packages using createrepo
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

.. versionadded:: 0.4

Take a directory containing RPM packages and run ``createrepo`` command on it,
which creates YUM repository metadata inside of it.


Parameters
----------

.. raw:: html

    <table class="rawhtml" border=1 cellpadding=4>
    <tr>
    <th class="head">parameter</th>
    <th class="head">required</th>
    <th class="head">description</th>
    <th class="head">type</th>
    <th class="head">default</th>
    <th class="head">choices</th>
    </tr>
            <tr>
    <td class="bold"><p>repodir</p></td>
    <td>yes</td>
    <td><p>absolute or relative path to the directory containing RPM files (the task directory is considered the current working directory)</p></td>
    <td><p>str</p></td>
    <td></td>
    <td><ul></ul></td>
    </tr>
        </table>

Return Values
-------------

Standard output (``string``) of the ``createrepo`` process.


Exceptions
----------

* :class:`.TaskotronDirectiveError`: if there's any output on standard error
  stream of the ``createrepo`` process



Examples
--------


First, download all required RPMs, then create a YUM repository in that
directory::

  - name: download koji tag
    koji:
        action: download_tag
        koji_tag: ${koji_tag}
        arch: ${arch}
        target_dir: ${workdir}/downloaded_tag/

  - name: create YUM repository metadata
    createrepo:
        repodir: ${workdir}/downloaded_tag/