--- /dev/null
+<?php
+
+/**
+ * @file
+ * Contains \Drush\Psysh\DrushCommand.
+ */
+
+namespace Drush\Psysh;
+
+use Psy\Command\Command as BaseCommand;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Formatter\OutputFormatter;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Output\OutputInterface;
+
+/**
+ * Help command.
+ *
+ * Lists available commands, and gives command-specific help when asked nicely.
+ *
+ * This replaces the PsySH help command to list commands by category.
+ */
+class DrushHelpCommand extends BaseCommand {
+
+ /**
+ * Label for PsySH commands.
+ */
+ const PSYSH_CATEGORY = 'PsySH commands';
+
+ /**
+ * The currently set subcommand.
+ *
+ * @var \Symfony\Component\Console\Command\Command
+ */
+ protected $command;
+
+ /**
+ * {@inheritdoc}
+ */
+ protected function configure() {
+ $this
+ ->setName('help')
+ ->setAliases(['?'])
+ ->setDefinition([
+ new InputArgument('command_name', InputArgument::OPTIONAL, 'The command name', NULL),
+ ])
+ ->setDescription('Show a list of commands. Type `help [foo]` for information about [foo].');
+ }
+
+ /**
+ * Helper for setting a subcommand to retrieve help for.
+ *
+ * @param \Symfony\Component\Console\Command\Command $command
+ */
+ public function setCommand(Command $command) {
+ $this->command = $command;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ protected function execute(InputInterface $input, OutputInterface $output) {
+ if ($this->command !== NULL) {
+ // Help for an individual command.
+ $output->page($this->command->asText());
+ $this->command = NULL;
+ }
+ elseif ($name = $input->getArgument('command_name')) {
+ // Help for an individual command.
+ $output->page($this->getApplication()->get($name)->asText());
+ }
+ else {
+ $categories = [];
+
+ // List available commands.
+ $commands = $this->getApplication()->all();
+
+ // Find the alignment width.
+ $width = 0;
+ foreach ($commands as $command) {
+ $width = strlen($command->getName()) > $width ? strlen($command->getName()) : $width;
+ }
+ $width += 2;
+
+ foreach ($commands as $name => $command) {
+ if ($name !== $command->getName()) {
+ continue;
+ }
+
+ if ($command->getAliases()) {
+ $aliases = sprintf(' <comment>Aliases:</comment> %s', implode(', ', $command->getAliases()));
+ }
+ else {
+ $aliases = '';
+ }
+
+ if ($command instanceof DrushCommand) {
+ $category = (string) $command->getCategory();
+ }
+ else {
+ $category = static::PSYSH_CATEGORY;
+ }
+
+ if (!isset($categories[$category])) {
+ $categories[$category] = [];
+ }
+
+ $categories[$category][] = sprintf(" <info>%-${width}s</info> %s%s", $name, $command->getDescription(), $aliases);
+ }
+
+ $messages = [];
+
+ foreach ($categories as $name => $category) {
+ $messages[] = '';
+ $messages[] = sprintf('<comment>%s</comment>', OutputFormatter::escape($name));
+ foreach ($category as $message) {
+ $messages[] = $message;
+ }
+ }
+
+ $output->page($messages);
+ }
+ }
+
+}