121 lines
3.0 KiB
PHP
121 lines
3.0 KiB
PHP
<?php
|
|
/**
|
|
* ConsoleInputSubcommand file
|
|
*
|
|
* CakePHP(tm) : Rapid Development Framework (https://cakephp.org)
|
|
* Copyright (c) Cake Software Foundation, Inc. (https://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. (https://cakefoundation.org)
|
|
* @link https://cakephp.org CakePHP(tm) Project
|
|
* @since CakePHP(tm) v 2.0
|
|
* @license https://opensource.org/licenses/mit-license.php MIT License
|
|
*/
|
|
|
|
/**
|
|
* An object to represent a single subcommand used in the command line.
|
|
* Created when you call ConsoleOptionParser::addSubcommand()
|
|
*
|
|
* @see ConsoleOptionParser::addSubcommand()
|
|
* @package Cake.Console
|
|
*/
|
|
class ConsoleInputSubcommand {
|
|
|
|
/**
|
|
* Name of the subcommand
|
|
*
|
|
* @var string
|
|
*/
|
|
protected $_name;
|
|
|
|
/**
|
|
* Help string for the subcommand
|
|
*
|
|
* @var string
|
|
*/
|
|
protected $_help;
|
|
|
|
/**
|
|
* The ConsoleOptionParser for this subcommand.
|
|
*
|
|
* @var ConsoleOptionParser
|
|
*/
|
|
protected $_parser;
|
|
|
|
/**
|
|
* Make a new Subcommand
|
|
*
|
|
* @param string|array $name The long name of the subcommand, or an array with all the properties.
|
|
* @param string $help The help text for this option
|
|
* @param ConsoleOptionParser|array $parser A parser for this subcommand. Either a ConsoleOptionParser, or an array that can be
|
|
* used with ConsoleOptionParser::buildFromArray()
|
|
*/
|
|
public function __construct($name, $help = '', $parser = null) {
|
|
if (is_array($name) && isset($name['name'])) {
|
|
foreach ($name as $key => $value) {
|
|
$this->{'_' . $key} = $value;
|
|
}
|
|
} else {
|
|
$this->_name = $name;
|
|
$this->_help = $help;
|
|
$this->_parser = $parser;
|
|
}
|
|
if (is_array($this->_parser)) {
|
|
$this->_parser['command'] = $this->_name;
|
|
$this->_parser = ConsoleOptionParser::buildFromArray($this->_parser);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 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 subcommand.
|
|
*
|
|
* @param int $width The width to make the name of the subcommand.
|
|
* @return string
|
|
*/
|
|
public function help($width = 0) {
|
|
$name = $this->_name;
|
|
if (strlen($name) < $width) {
|
|
$name = str_pad($name, $width, ' ');
|
|
}
|
|
return $name . $this->_help;
|
|
}
|
|
|
|
/**
|
|
* Get the usage value for this option
|
|
*
|
|
* @return mixed Either false or a ConsoleOptionParser
|
|
*/
|
|
public function parser() {
|
|
if ($this->_parser instanceof ConsoleOptionParser) {
|
|
return $this->_parser;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Append this subcommand to the Parent element
|
|
*
|
|
* @param SimpleXmlElement $parent The parent element.
|
|
* @return SimpleXmlElement The parent with this subcommand appended.
|
|
*/
|
|
public function xml(SimpleXmlElement $parent) {
|
|
$command = $parent->addChild('command');
|
|
$command->addAttribute('name', $this->_name);
|
|
$command->addAttribute('help', $this->_help);
|
|
return $parent;
|
|
}
|
|
|
|
}
|