Runtime: Add --quiet switch

Author: yannoff

README.md

@@ -51,6 +51,7 @@ Name /  Shorthand   |  Type | Description
 `--dir`,  `-d`      | multi | Adds a sources directory to the archive<br/>_Possible dir spec formats:<br/>- `$dir` => include all files in directory<br/>- `$dir:$extension` => filter files on a specific extension_ |n
 `--meta`, `-m`      | multi | Adds a metadata to the archive<br/>_Metadata must be specified in the `$key:$value` format_                                                                                             |n
 `--shebang-less`    | flag  | Produce a stub deprived of the shebang directive<br/>_Useful when the phar is meant to be included instead of being executed directly_                                                  |n
+`--quiet`, `-q`     | flag  | Reduce output messages amount: set verbosity level to `INFO` instead of default `DEBUG`                                                                                                 |n
 
 
 ### Examples

src/Command/Compile.php

@@ -18,6 +18,7 @@
 use Yannoff\Component\Console\Command;
 use Yannoff\Component\Console\Definition\Option;
 use Yannoff\Component\Console\Exception\RuntimeException;
+use Yannoff\Component\Console\IO\Output\Verbosity;
 use Yannoff\PhpCodeCompiler\Contents;
 use Yannoff\PhpCodeCompiler\Directory;
 use Yannoff\PhpCodeCompiler\PharBuilder;
@@ -37,13 +38,16 @@ public function configure()
     {
         $this
             ->setHelp('PHP Code compiler - Phar executable compiling utility')
+            // Compiling options
             ->addOption('main', 'e', Option::VALUE, 'Set the PHAR stub\'s main entrypoint script')
             ->addOption('dir', 'd', Option::MULTI, 'Add directory contents ("-d $dir") optionally filtered on a specific file extension ("$dir:$extension")')
             ->addOption('file', 'f', Option::MULTI, 'Add a single file to the archive')
             ->addOption('meta', 'm', Option::MULTI, 'Add a metadata property (eg: "-m $key:$value")')
             ->addOption('output', 'o', Option::VALUE, 'Set the compiled archive output name')
             ->addOption('banner', 'b', Option::VALUE, 'Load legal notice from the given banner file')
             ->addOption('shebang-less', '', Option::FLAG, 'Produce a stub deprived of the shebang directive')
+            // Global options
+            ->addOption('quiet', 'q', Option::FLAG, 'Set output verbosity level to INFO instead of DEBUG')
         ;
     }
 
@@ -63,6 +67,9 @@ public function execute()
 
         $shebang = (!$this->getOption('shebang-less'));
 
+        $quiet = $this->getOption('quiet');
+        $this->setVerbosity($quiet ? Verbosity::INFO : Verbosity::DEBUG);
+
         $this
             ->initBuilder($main)
             ->addFiles($files)
@@ -119,7 +126,7 @@ protected function addFile(string $file)
     {
         $fullpath = $this->fullpath($file);
 
-        $this->info('+ ' . $file, 'grey');
+        $this->debug('+ ' . $file, 'grey');
 
         // Only minify pure PHP source files, other files such as
         // code templates for instance, should be left as-is
@@ -180,7 +187,7 @@ protected function addMetadata(array $definitions): self
         foreach ($definitions as $definition) {
             list($name, $value) = explode(':', $definition);
             $this->info("Adding <strong>$name</strong> metadata property");
-            $this->info("-> $name: $value", 'grey');
+            $this->debug("-> $name: $value", 'grey');
             $this->builder->addMetadata($name, $value);
         }
 
@@ -200,7 +207,7 @@ protected function setNotice(string $banner = null): self
             $this->info("Loading banner contents from <strong>$banner</strong> file...");
             $header = $this->commentOut($banner);
 
-            $this->info(implode("\n", $header), 'grey');
+            $this->debug(implode("\n", $header), 'grey');
             $this->builder->setBanner($header);
         }
 
@@ -282,17 +289,44 @@ protected function commentOut(string $banner): array
     /**
      * Print a message to STDERR, optionally encapsulated by styling tags
      *
-     * @param string $message
-     * @param string $tag
+     * @param string $message Console-flavour pre-formatted message
+     * @param int    $level   Verbosity level (defaults to ERROR)
+     * @param string $tag     Optional encapsulating style tags name
      *
      * @return self
      */
-    protected function info(string $message, string $tag = ''): self
+    protected function print(string $message, int $level = Verbosity::ERROR, string $tag = ''): self
     {
         $otag = $tag ? "<$tag>" : '';
         $ctag = $tag ? "</$tag>" : '';
-        $this->error(sprintf('%s%s%s', $otag, $message, $ctag));
+        $this->dmesg(sprintf('%s%s%s', $otag, $message, $ctag), $level);
 
         return $this;
     }
+
+    /**
+     * Print an INFO message to standard error
+     *
+     * @param string $message Pre-formatted info message
+     * @param string $tag     Optional styling tag name
+     *
+     * @return self
+     */
+    protected function info(string $message, string $tag = ''): self
+    {
+        return $this->print($message, Verbosity::INFO, $tag);
+    }
+
+    /**
+     * Print a DEBUG message to standard error
+     *
+     * @param string $message Pre-formatted debug message
+     * @param string $tag     Optional styling tag name
+     *
+     * @return self
+     */
+    protected function debug(string $message, string $tag = ''): self
+    {
+        return $this->print($message, Verbosity::DEBUG, $tag);
+    }
 }