Version 1
[yaffs-website] / vendor / drush / drush / lib / Drush / Psysh / DrushHelpCommand.php
diff --git a/vendor/drush/drush/lib/Drush/Psysh/DrushHelpCommand.php b/vendor/drush/drush/lib/Drush/Psysh/DrushHelpCommand.php
new file mode 100644 (file)
index 0000000..9a3961f
--- /dev/null
@@ -0,0 +1,126 @@
+<?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);
+    }
+  }
+
+}