Writing plugins
===============


Logging and progress output
---------------------------

Unleash supports different output levels, named after regular loglevels:
``debug``, ``verbose``, ``normal`` and ``quiet``. Plugins need not know about
these as the logger takes care of only displaying messages that are required.
The following guidelines for output should be kept in mind regardless:

* For every large step performed (that is, roughly once per plugin), output a
  single ``info``-level log message. These are displayed during normal
  operation and allow the user to follow what is happening.
* Warnings and errors should be output using the issue collector (they will
  trigger a log entry automatically) and, if possible, contain a suggested
  possible fix.
* You can output any number of helpful debug or trace messages on the ``debug``
  log level.