/lib/Cake/Console/ConsoleInputArgument.php - アノテート - pictcode - Redmine

pictcode / lib / Cake / Console / ConsoleInputArgument.php @ 0b1b8047

-eef61
+<?php
 /**
  * ConsoleArgumentOption file
+ *
  * CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
  * Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
+ *
  * Licensed under The MIT License
  * For full copyright and license information, please see the LICENSE.txt
  * Redistributions of files must retain the above copyright notice.
+ *
  * @copyright     Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
  * @link          http://cakephp.org CakePHP(tm) Project
  * @since         CakePHP(tm) v 2.0
  * @license       http://www.opensource.org/licenses/mit-license.php MIT License
  */
 /**
  * An object to represent a single argument used in the command line.
  * ConsoleOptionParser creates these when you use addArgument()
+ *
  * @see ConsoleOptionParser::addArgument()
  * @package       Cake.Console
  */
 class ConsoleInputArgument {
 /**
  * Name of the argument.
+ *
  * @var string
  */
         protected $_name;
 /**
  * Help string
+ *
  * @var string
  */
         protected $_help;
 /**
  * Is this option required?
+ *
  * @var bool
  */
         protected $_required;
 /**
  * An array of valid choices for this argument.
+ *
  * @var array
  */
         protected $_choices;
 /**
  * Make a new Input Argument
+ *
  * @param string|array $name The long name of the option, or an array with all the properties.
  * @param string $help The help text for this option
  * @param bool $required Whether this argument is required. Missing required args will trigger exceptions
  * @param array $choices Valid choices for this option.
  */
         public function __construct($name, $help = '', $required = false, $choices = array()) {
                 if (is_array($name) && isset($name['name'])) {
                         foreach ($name as $key => $value) {
                                 $this->{'_' . $key} = $value;
+                        }
                 } else {
                         $this->_name = $name;
                         $this->_help = $help;
                         $this->_required = $required;
                         $this->_choices = $choices;
+                }
+        }
 /**
  * Get the value of the name attribute.
+ *
  * @return string Value of this->_name.
  */
         public function name() {
                 return $this->_name;
+        }
 /**
  * Generate the help for this argument.
+ *
  * @param int $width The width to make the name of the option.
  * @return string
  */
         public function help($width = 0) {
                 $name = $this->_name;
                 if (strlen($name) < $width) {
                         $name = str_pad($name, $width, ' ');
+                }
                 $optional = '';
                 if (!$this->isRequired()) {
                         $optional = __d('cake_console', ' <comment>(optional)</comment>');
+                }
                 if (!empty($this->_choices)) {
                         $optional .= __d('cake_console', ' <comment>(choices: %s)</comment>', implode('|', $this->_choices));
+                }
                 return sprintf('%s%s%s', $name, $this->_help, $optional);
+        }
 /**
  * Get the usage value for this argument
+ *
  * @return string
  */
         public function usage() {
                 $name = $this->_name;
                 if (!empty($this->_choices)) {
                         $name = implode('|', $this->_choices);
+                }
                 $name = '<' . $name . '>';
                 if (!$this->isRequired()) {
                         $name = '[' . $name . ']';
+                }
                 return $name;
+        }
 /**
  * Check if this argument is a required argument
+ *
  * @return bool
  */
         public function isRequired() {
                 return (bool)$this->_required;
+        }
 /**
  * Check that $value is a valid choice for this argument.
+ *
  * @param string $value The choice to validate.
  * @return bool
  * @throws ConsoleException
  */
         public function validChoice($value) {
                 if (empty($this->_choices)) {
                         return true;
+                }
                 if (!in_array($value, $this->_choices)) {
                         throw new ConsoleException(
                                 __d('cake_console', '"%s" is not a valid value for %s. Please use one of "%s"',
                                 $value, $this->_name, implode(', ', $this->_choices)
                         ));
+                }
                 return true;
+        }
 /**
  * Append this arguments XML representation to the passed in SimpleXml object.
+ *
  * @param SimpleXmlElement $parent The parent element.
  * @return SimpleXmlElement The parent with this argument appended.
  */
         public function xml(SimpleXmlElement $parent) {
                 $option = $parent->addChild('argument');
                 $option->addAttribute('name', $this->_name);
                 $option->addAttribute('help', $this->_help);
                 $option->addAttribute('required', $this->isRequired());
                 $choices = $option->addChild('choices');
                 foreach ($this->_choices as $valid) {
                         $choices->addChild('choice', $valid);
+                }
                 return $parent;
+        }
+}