Chris@0: Chris@0: * Chris@0: * For the full copyright and license information, please view the LICENSE Chris@0: * file that was distributed with this source code. Chris@0: */ Chris@0: Chris@0: namespace Symfony\Component\Console\Descriptor; Chris@0: Chris@0: use Symfony\Component\Console\Application; Chris@0: use Symfony\Component\Console\Command\Command; Chris@17: use Symfony\Component\Console\Exception\InvalidArgumentException; Chris@0: use Symfony\Component\Console\Input\InputArgument; Chris@0: use Symfony\Component\Console\Input\InputDefinition; Chris@0: use Symfony\Component\Console\Input\InputOption; Chris@0: use Symfony\Component\Console\Output\OutputInterface; Chris@0: Chris@0: /** Chris@0: * @author Jean-François Simon Chris@0: * Chris@0: * @internal Chris@0: */ Chris@0: abstract class Descriptor implements DescriptorInterface Chris@0: { Chris@0: /** Chris@0: * @var OutputInterface Chris@0: */ Chris@0: protected $output; Chris@0: Chris@0: /** Chris@0: * {@inheritdoc} Chris@0: */ Chris@17: public function describe(OutputInterface $output, $object, array $options = []) Chris@0: { Chris@0: $this->output = $output; Chris@0: Chris@0: switch (true) { Chris@0: case $object instanceof InputArgument: Chris@0: $this->describeInputArgument($object, $options); Chris@0: break; Chris@0: case $object instanceof InputOption: Chris@0: $this->describeInputOption($object, $options); Chris@0: break; Chris@0: case $object instanceof InputDefinition: Chris@0: $this->describeInputDefinition($object, $options); Chris@0: break; Chris@0: case $object instanceof Command: Chris@0: $this->describeCommand($object, $options); Chris@0: break; Chris@0: case $object instanceof Application: Chris@0: $this->describeApplication($object, $options); Chris@0: break; Chris@0: default: Chris@17: throw new InvalidArgumentException(sprintf('Object of type "%s" is not describable.', \get_class($object))); Chris@0: } Chris@0: } Chris@0: Chris@0: /** Chris@0: * Writes content to output. Chris@0: * Chris@0: * @param string $content Chris@0: * @param bool $decorated Chris@0: */ Chris@0: protected function write($content, $decorated = false) Chris@0: { Chris@0: $this->output->write($content, false, $decorated ? OutputInterface::OUTPUT_NORMAL : OutputInterface::OUTPUT_RAW); Chris@0: } Chris@0: Chris@0: /** Chris@0: * Describes an InputArgument instance. Chris@0: * Chris@0: * @return string|mixed Chris@0: */ Chris@17: abstract protected function describeInputArgument(InputArgument $argument, array $options = []); Chris@0: Chris@0: /** Chris@0: * Describes an InputOption instance. Chris@0: * Chris@0: * @return string|mixed Chris@0: */ Chris@17: abstract protected function describeInputOption(InputOption $option, array $options = []); Chris@0: Chris@0: /** Chris@0: * Describes an InputDefinition instance. Chris@0: * Chris@0: * @return string|mixed Chris@0: */ Chris@17: abstract protected function describeInputDefinition(InputDefinition $definition, array $options = []); Chris@0: Chris@0: /** Chris@0: * Describes a Command instance. Chris@0: * Chris@0: * @return string|mixed Chris@0: */ Chris@17: abstract protected function describeCommand(Command $command, array $options = []); Chris@0: Chris@0: /** Chris@0: * Describes an Application instance. Chris@0: * Chris@0: * @return string|mixed Chris@0: */ Chris@17: abstract protected function describeApplication(Application $application, array $options = []); Chris@0: }