mirror of
https://github.com/kamilwylegala/cakephp2-php8.git
synced 2024-11-16 11:58:25 +00:00
44c080d5ad
Adding package specific exceptions. Replacing generic exceptions in the codebase with CakeException + package exceptions.
144 lines
3.7 KiB
PHP
144 lines
3.7 KiB
PHP
<?php
|
|
/**
|
|
* ConsoleArgumentOption file
|
|
*
|
|
* PHP 5
|
|
*
|
|
* CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
|
|
* Copyright 2005-2010, Cake Software Foundation, Inc. (http://cakefoundation.org)
|
|
*
|
|
* Licensed under The MIT License
|
|
* Redistributions of files must retain the above copyright notice.
|
|
*
|
|
* @copyright Copyright 2005-2010, Cake Software Foundation, Inc. (http://cakefoundation.org)
|
|
* @link http://cakephp.org CakePHP(tm) Project
|
|
* @package cake
|
|
* @subpackage cake.cake.console
|
|
* @since CakePHP(tm) v 2.0
|
|
* @license MIT License (http://www.opensource.org/licenses/mit-license.php)
|
|
*/
|
|
/**
|
|
* 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 {
|
|
|
|
protected $_name, $_help, $_required, $_choices;
|
|
|
|
/**
|
|
* Make a new Input Argument
|
|
*
|
|
* @param mixed $name The long name of the option, or an array with all the properites.
|
|
* @param string $help The help text for this option
|
|
* @param boolean $required Whether this argument is required. Missing required args will trigger exceptions
|
|
* @param arraty $choices Valid choices for this option.
|
|
* @return void
|
|
*/
|
|
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 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 = __(' <comment>(optional)</comment>');
|
|
}
|
|
if (!empty($this->_choices)) {
|
|
$optional .= __(' <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 boolean
|
|
*/
|
|
public function isRequired() {
|
|
return (bool) $this->_required;
|
|
}
|
|
|
|
/**
|
|
* Check that $value is a valid choice for this argument.
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public function validChoice($value) {
|
|
if (empty($this->_choices)) {
|
|
return true;
|
|
}
|
|
if (!in_array($value, $this->_choices)) {
|
|
throw new ConsoleException(sprintf(
|
|
__('"%s" is not a valid value for %s. Please use one of "%s"'),
|
|
$value, $this->_name, implode(', ', $this->_choices)
|
|
));
|
|
}
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Append this argument to the passed in SimpleXml object.
|
|
*
|
|
* @param SimpleXmlElement 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;
|
|
}
|
|
}
|