comparison vendor/symfony/console/Input/InputArgument.php @ 0:4c8ae668cc8c

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