[Summary view] [Print] [Text view]

   1  <?php
   2  
   3  /*
   4   * This file is part of the Symfony package.
   5   *
   6   * (c) Fabien Potencier <[email protected]>
   7   *
   8   * For the full copyright and license information, please view the LICENSE
   9   * file that was distributed with this source code.
  10   */
  11  
  12  namespace Symfony\Component\Console\Descriptor;
  13  
  14  use Symfony\Component\Console\Application;
  15  use Symfony\Component\Console\Command\Command;
  16  use Symfony\Component\Console\Exception\InvalidArgumentException;
  17  use Symfony\Component\Console\Input\InputArgument;
  18  use Symfony\Component\Console\Input\InputDefinition;
  19  use Symfony\Component\Console\Input\InputOption;
  20  use Symfony\Component\Console\Output\OutputInterface;
  21  
  22  /**
  23   * @author Jean-François Simon <[email protected]>
  24   *
  25   * @internal
  26   */
  27  abstract class Descriptor implements DescriptorInterface
  28  {
  29      /**
  30       * @var OutputInterface
  31       */
  32      protected $output;
  33  
  34      /**
  35       * {@inheritdoc}
  36       */
  37      public function describe(OutputInterface $output, object $object, array $options = [])
  38      {
  39          $this->output = $output;
  40  
  41          switch (true) {
  42              case $object instanceof InputArgument:
  43                  $this->describeInputArgument($object, $options);
  44                  break;
  45              case $object instanceof InputOption:
  46                  $this->describeInputOption($object, $options);
  47                  break;
  48              case $object instanceof InputDefinition:
  49                  $this->describeInputDefinition($object, $options);
  50                  break;
  51              case $object instanceof Command:
  52                  $this->describeCommand($object, $options);
  53                  break;
  54              case $object instanceof Application:
  55                  $this->describeApplication($object, $options);
  56                  break;
  57              default:
  58                  throw new InvalidArgumentException(sprintf('Object of type "%s" is not describable.', get_debug_type($object)));
  59          }
  60      }
  61  
  62      /**
  63       * Writes content to output.
  64       */
  65      protected function write(string $content, bool $decorated = false)
  66      {
  67          $this->output->write($content, false, $decorated ? OutputInterface::OUTPUT_NORMAL : OutputInterface::OUTPUT_RAW);
  68      }
  69  
  70      /**
  71       * Describes an InputArgument instance.
  72       */
  73      abstract protected function describeInputArgument(InputArgument $argument, array $options = []);
  74  
  75      /**
  76       * Describes an InputOption instance.
  77       */
  78      abstract protected function describeInputOption(InputOption $option, array $options = []);
  79  
  80      /**
  81       * Describes an InputDefinition instance.
  82       */
  83      abstract protected function describeInputDefinition(InputDefinition $definition, array $options = []);
  84  
  85      /**
  86       * Describes a Command instance.
  87       */
  88      abstract protected function describeCommand(Command $command, array $options = []);
  89  
  90      /**
  91       * Describes an Application instance.
  92       */
  93      abstract protected function describeApplication(Application $application, array $options = []);
  94  }