.. _messaging:

Progress notification
=====================

*Pungi* has the ability to emit notification messages about progress and
general status of the compose. These can be used to e.g. send messages to
*fedmsg*. This is implemented by actually calling a separate script.

The script will be called with one argument describing action that just
happened. A JSON-encoded object will be passed to standard input to provide
more information about the event. At the very least, the object will contain a
``compose_id`` key.

Currently these messages are sent:

 * ``status-change`` -- when composing starts, finishes or fails; a ``status``
   key is provided to indicate details
 * ``phase-start`` -- on start of a phase
 * ``phase-stop`` -- when phase is finished
 * ``createiso-targets`` -- with a list of images to be created
 * ``createiso-imagedone`` -- when any single image is finished
 * ``createiso-imagefail`` -- when any single image fails to create

For phase related messages ``phase_name`` key is provided as well.

The script is invoked in compose directory and can read other information
there.

A ``pungi-fedmsg-notification`` script is provided and understands this
interface.

Setting it up
-------------

The script should be provided as a command line argument
``--notification-script``. ::

    --notification_script=pungi-fedmsg-notification