annotate vendor/symfony/console/Input/InputArgument.php @ 19:fa3358dc1485 tip

Add ndrum files
author Chris Cannam
date Wed, 28 Aug 2019 13:14:47 +0100
parents 129ea1e6d783
children
rev   line source
Chris@0 1 <?php
Chris@0 2
Chris@0 3 /*
Chris@0 4 * This file is part of the Symfony package.
Chris@0 5 *
Chris@0 6 * (c) Fabien Potencier <fabien@symfony.com>
Chris@0 7 *
Chris@0 8 * For the full copyright and license information, please view the LICENSE
Chris@0 9 * file that was distributed with this source code.
Chris@0 10 */
Chris@0 11
Chris@0 12 namespace Symfony\Component\Console\Input;
Chris@0 13
Chris@0 14 use Symfony\Component\Console\Exception\InvalidArgumentException;
Chris@0 15 use Symfony\Component\Console\Exception\LogicException;
Chris@0 16
Chris@0 17 /**
Chris@0 18 * Represents a command line argument.
Chris@0 19 *
Chris@0 20 * @author Fabien Potencier <fabien@symfony.com>
Chris@0 21 */
Chris@0 22 class InputArgument
Chris@0 23 {
Chris@0 24 const REQUIRED = 1;
Chris@0 25 const OPTIONAL = 2;
Chris@0 26 const IS_ARRAY = 4;
Chris@0 27
Chris@0 28 private $name;
Chris@0 29 private $mode;
Chris@0 30 private $default;
Chris@0 31 private $description;
Chris@0 32
Chris@0 33 /**
Chris@17 34 * @param string $name The argument name
Chris@17 35 * @param int|null $mode The argument mode: self::REQUIRED or self::OPTIONAL
Chris@17 36 * @param string $description A description text
Chris@17 37 * @param string|string[]|null $default The default value (for self::OPTIONAL mode only)
Chris@0 38 *
Chris@0 39 * @throws InvalidArgumentException When argument mode is not valid
Chris@0 40 */
Chris@0 41 public function __construct($name, $mode = null, $description = '', $default = null)
Chris@0 42 {
Chris@0 43 if (null === $mode) {
Chris@0 44 $mode = self::OPTIONAL;
Chris@17 45 } elseif (!\is_int($mode) || $mode > 7 || $mode < 1) {
Chris@0 46 throw new InvalidArgumentException(sprintf('Argument mode "%s" is not valid.', $mode));
Chris@0 47 }
Chris@0 48
Chris@0 49 $this->name = $name;
Chris@0 50 $this->mode = $mode;
Chris@0 51 $this->description = $description;
Chris@0 52
Chris@0 53 $this->setDefault($default);
Chris@0 54 }
Chris@0 55
Chris@0 56 /**
Chris@0 57 * Returns the argument name.
Chris@0 58 *
Chris@0 59 * @return string The argument name
Chris@0 60 */
Chris@0 61 public function getName()
Chris@0 62 {
Chris@0 63 return $this->name;
Chris@0 64 }
Chris@0 65
Chris@0 66 /**
Chris@0 67 * Returns true if the argument is required.
Chris@0 68 *
Chris@0 69 * @return bool true if parameter mode is self::REQUIRED, false otherwise
Chris@0 70 */
Chris@0 71 public function isRequired()
Chris@0 72 {
Chris@0 73 return self::REQUIRED === (self::REQUIRED & $this->mode);
Chris@0 74 }
Chris@0 75
Chris@0 76 /**
Chris@0 77 * Returns true if the argument can take multiple values.
Chris@0 78 *
Chris@0 79 * @return bool true if mode is self::IS_ARRAY, false otherwise
Chris@0 80 */
Chris@0 81 public function isArray()
Chris@0 82 {
Chris@0 83 return self::IS_ARRAY === (self::IS_ARRAY & $this->mode);
Chris@0 84 }
Chris@0 85
Chris@0 86 /**
Chris@0 87 * Sets the default value.
Chris@0 88 *
Chris@17 89 * @param string|string[]|null $default The default value
Chris@0 90 *
Chris@0 91 * @throws LogicException When incorrect default value is given
Chris@0 92 */
Chris@0 93 public function setDefault($default = null)
Chris@0 94 {
Chris@0 95 if (self::REQUIRED === $this->mode && null !== $default) {
Chris@0 96 throw new LogicException('Cannot set a default value except for InputArgument::OPTIONAL mode.');
Chris@0 97 }
Chris@0 98
Chris@0 99 if ($this->isArray()) {
Chris@0 100 if (null === $default) {
Chris@17 101 $default = [];
Chris@17 102 } elseif (!\is_array($default)) {
Chris@0 103 throw new LogicException('A default value for an array argument must be an array.');
Chris@0 104 }
Chris@0 105 }
Chris@0 106
Chris@0 107 $this->default = $default;
Chris@0 108 }
Chris@0 109
Chris@0 110 /**
Chris@0 111 * Returns the default value.
Chris@0 112 *
Chris@17 113 * @return string|string[]|null The default value
Chris@0 114 */
Chris@0 115 public function getDefault()
Chris@0 116 {
Chris@0 117 return $this->default;
Chris@0 118 }
Chris@0 119
Chris@0 120 /**
Chris@0 121 * Returns the description text.
Chris@0 122 *
Chris@0 123 * @return string The description text
Chris@0 124 */
Chris@0 125 public function getDescription()
Chris@0 126 {
Chris@0 127 return $this->description;
Chris@0 128 }
Chris@0 129 }