[Summary view]

   1  <?php
   2  
   3  /**
   4   * SCSSPHP
   5   *
   6   * @copyright 2012-2020 Leaf Corcoran
   7   *
   8   * @license http://opensource.org/licenses/MIT MIT
   9   *
  10   * @link http://scssphp.github.io/scssphp
  11   */
  12  
  13  namespace ScssPhp\ScssPhp\Logger;
  14  
  15  /**
  16   * Interface implemented by loggers for warnings and debug messages.
  17   *
  18   * The official Sass implementation recommends that loggers report the
  19   * messages immediately rather than waiting for the end of the
  20   * compilation, to provide a better debugging experience when the
  21   * compilation does not end (error or infinite loop after the warning
  22   * for instance).
  23   */
  24  interface LoggerInterface
  25  {
  26      /**
  27       * Emits a warning with the given message.
  28       *
  29       * If $deprecation is true, it indicates that this is a deprecation
  30       * warning. Implementations should surface all this information to
  31       * the end user.
  32       *
  33       * @param string $message
  34       * @param bool  $deprecation
  35       *
  36       * @return void
  37       */
  38      public function warn($message, $deprecation = false);
  39  
  40      /**
  41       * Emits a debugging message.
  42       *
  43       * @param string $message
  44       *
  45       * @return void
  46       */
  47      public function debug($message);
  48  }