283 lines
7.5 KiB
PHP
283 lines
7.5 KiB
PHP
<?php
|
|
|
|
/*
|
|
* This file is part of Psy Shell.
|
|
*
|
|
* (c) 2012-2015 Justin Hileman
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
|
|
namespace Psy\Command;
|
|
|
|
use Psy\Shell;
|
|
use Symfony\Component\Console\Application;
|
|
use Symfony\Component\Console\Command\Command as BaseCommand;
|
|
use Symfony\Component\Console\Helper\Table;
|
|
use Symfony\Component\Console\Helper\TableHelper;
|
|
use Symfony\Component\Console\Helper\TableStyle;
|
|
use Symfony\Component\Console\Output\OutputInterface;
|
|
|
|
/**
|
|
* The Psy Shell base command.
|
|
*/
|
|
abstract class Command extends BaseCommand
|
|
{
|
|
/**
|
|
* Sets the application instance for this command.
|
|
*
|
|
* @param Application $application An Application instance
|
|
*
|
|
* @api
|
|
*/
|
|
public function setApplication(Application $application = null)
|
|
{
|
|
if ($application !== null && !$application instanceof Shell) {
|
|
throw new \InvalidArgumentException('PsySH Commands require an instance of Psy\Shell.');
|
|
}
|
|
|
|
return parent::setApplication($application);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function asText()
|
|
{
|
|
$messages = array(
|
|
'<comment>Usage:</comment>',
|
|
' ' . $this->getSynopsis(),
|
|
'',
|
|
);
|
|
|
|
if ($this->getAliases()) {
|
|
$messages[] = $this->aliasesAsText();
|
|
}
|
|
|
|
if ($this->getArguments()) {
|
|
$messages[] = $this->argumentsAsText();
|
|
}
|
|
|
|
if ($this->getOptions()) {
|
|
$messages[] = $this->optionsAsText();
|
|
}
|
|
|
|
if ($help = $this->getProcessedHelp()) {
|
|
$messages[] = '<comment>Help:</comment>';
|
|
$messages[] = ' ' . str_replace("\n", "\n ", $help) . "\n";
|
|
}
|
|
|
|
return implode("\n", $messages);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
private function getArguments()
|
|
{
|
|
$hidden = $this->getHiddenArguments();
|
|
|
|
return array_filter($this->getNativeDefinition()->getArguments(), function ($argument) use ($hidden) {
|
|
return !in_array($argument->getName(), $hidden);
|
|
});
|
|
}
|
|
|
|
/**
|
|
* These arguments will be excluded from help output.
|
|
*
|
|
* @return array
|
|
*/
|
|
protected function getHiddenArguments()
|
|
{
|
|
return array('command');
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
private function getOptions()
|
|
{
|
|
$hidden = $this->getHiddenOptions();
|
|
|
|
return array_filter($this->getNativeDefinition()->getOptions(), function ($option) use ($hidden) {
|
|
return !in_array($option->getName(), $hidden);
|
|
});
|
|
}
|
|
|
|
/**
|
|
* These options will be excluded from help output.
|
|
*
|
|
* @return array
|
|
*/
|
|
protected function getHiddenOptions()
|
|
{
|
|
return array('verbose');
|
|
}
|
|
|
|
/**
|
|
* Format command aliases as text..
|
|
*
|
|
* @return string
|
|
*/
|
|
private function aliasesAsText()
|
|
{
|
|
return '<comment>Aliases:</comment> <info>' . implode(', ', $this->getAliases()) . '</info>' . PHP_EOL;
|
|
}
|
|
|
|
/**
|
|
* Format command arguments as text.
|
|
*
|
|
* @return string
|
|
*/
|
|
private function argumentsAsText()
|
|
{
|
|
$max = $this->getMaxWidth();
|
|
$messages = array();
|
|
|
|
$arguments = $this->getArguments();
|
|
if (!empty($arguments)) {
|
|
$messages[] = '<comment>Arguments:</comment>';
|
|
foreach ($arguments as $argument) {
|
|
if (null !== $argument->getDefault() && (!is_array($argument->getDefault()) || count($argument->getDefault()))) {
|
|
$default = sprintf('<comment> (default: %s)</comment>', $this->formatDefaultValue($argument->getDefault()));
|
|
} else {
|
|
$default = '';
|
|
}
|
|
|
|
$description = str_replace("\n", "\n" . str_pad('', $max + 2, ' '), $argument->getDescription());
|
|
|
|
$messages[] = sprintf(" <info>%-${max}s</info> %s%s", $argument->getName(), $description, $default);
|
|
}
|
|
|
|
$messages[] = '';
|
|
}
|
|
|
|
return implode(PHP_EOL, $messages);
|
|
}
|
|
|
|
/**
|
|
* Format options as text.
|
|
*
|
|
* @return string
|
|
*/
|
|
private function optionsAsText()
|
|
{
|
|
$max = $this->getMaxWidth();
|
|
$messages = array();
|
|
|
|
$options = $this->getOptions();
|
|
if ($options) {
|
|
$messages[] = '<comment>Options:</comment>';
|
|
|
|
foreach ($options as $option) {
|
|
if ($option->acceptValue() && null !== $option->getDefault() && (!is_array($option->getDefault()) || count($option->getDefault()))) {
|
|
$default = sprintf('<comment> (default: %s)</comment>', $this->formatDefaultValue($option->getDefault()));
|
|
} else {
|
|
$default = '';
|
|
}
|
|
|
|
$multiple = $option->isArray() ? '<comment> (multiple values allowed)</comment>' : '';
|
|
$description = str_replace("\n", "\n" . str_pad('', $max + 2, ' '), $option->getDescription());
|
|
|
|
$optionMax = $max - strlen($option->getName()) - 2;
|
|
$messages[] = sprintf(
|
|
" <info>%s</info> %-${optionMax}s%s%s%s",
|
|
'--' . $option->getName(),
|
|
$option->getShortcut() ? sprintf('(-%s) ', $option->getShortcut()) : '',
|
|
$description,
|
|
$default,
|
|
$multiple
|
|
);
|
|
}
|
|
|
|
$messages[] = '';
|
|
}
|
|
|
|
return implode(PHP_EOL, $messages);
|
|
}
|
|
|
|
/**
|
|
* Calculate the maximum padding width for a set of lines.
|
|
*
|
|
* @return int
|
|
*/
|
|
private function getMaxWidth()
|
|
{
|
|
$max = 0;
|
|
|
|
foreach ($this->getOptions() as $option) {
|
|
$nameLength = strlen($option->getName()) + 2;
|
|
if ($option->getShortcut()) {
|
|
$nameLength += strlen($option->getShortcut()) + 3;
|
|
}
|
|
|
|
$max = max($max, $nameLength);
|
|
}
|
|
|
|
foreach ($this->getArguments() as $argument) {
|
|
$max = max($max, strlen($argument->getName()));
|
|
}
|
|
|
|
return ++$max;
|
|
}
|
|
|
|
/**
|
|
* Format an option default as text.
|
|
*
|
|
* @param mixed $default
|
|
*
|
|
* @return string
|
|
*/
|
|
private function formatDefaultValue($default)
|
|
{
|
|
if (is_array($default) && $default === array_values($default)) {
|
|
return sprintf("array('%s')", implode("', '", $default));
|
|
}
|
|
|
|
return str_replace("\n", '', var_export($default, true));
|
|
}
|
|
|
|
/**
|
|
* Get a Table instance.
|
|
*
|
|
* Falls back to legacy TableHelper.
|
|
*
|
|
* @return Table|TableHelper
|
|
*/
|
|
protected function getTable(OutputInterface $output)
|
|
{
|
|
if (!class_exists('Symfony\Component\Console\Helper\Table')) {
|
|
return $this->getTableHelper();
|
|
}
|
|
|
|
$style = new TableStyle();
|
|
$style
|
|
->setVerticalBorderChar(' ')
|
|
->setHorizontalBorderChar('')
|
|
->setCrossingChar('');
|
|
|
|
$table = new Table($output);
|
|
|
|
return $table
|
|
->setRows(array())
|
|
->setStyle($style);
|
|
}
|
|
|
|
/**
|
|
* Legacy fallback for getTable.
|
|
*
|
|
* @return TableHelper
|
|
*/
|
|
protected function getTableHelper()
|
|
{
|
|
$table = $this->getApplication()->getHelperSet()->get('table');
|
|
|
|
return $table
|
|
->setRows(array())
|
|
->setLayout(TableHelper::LAYOUT_BORDERLESS)
|
|
->setHorizontalBorderChar('')
|
|
->setCrossingChar('');
|
|
}
|
|
}
|