Updated to Drupal 8.5. Core Media not yet in use.
[yaffs-website] / vendor / drush / drush / src / Psysh / DrushHelpCommand.php
diff --git a/vendor/drush/drush/src/Psysh/DrushHelpCommand.php b/vendor/drush/drush/src/Psysh/DrushHelpCommand.php
new file mode 100644 (file)
index 0000000..fb3f0a1
--- /dev/null
@@ -0,0 +1,128 @@
+<?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';
+
+    /**
+     * 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 {
+            $namespaces = [];
+
+            // 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 = '';
+                }
+
+                $namespace = '';
+                if ($command instanceof DrushCommand) {
+                    $namespace = $command->getNamespace();
+                }
+
+                if (empty($namespace)) {
+                    $namespace = static::PSYSH_CATEGORY;
+                }
+
+                if (!isset($namespaces[$namespace])) {
+                    $namespaces[$namespace] = [];
+                }
+
+                $namespaces[$namespace][] = sprintf("    <info>%-${width}s</info> %s%s", $name, $command->getDescription(), $aliases);
+            }
+
+            $messages = [];
+
+            foreach ($namespaces as $namespace => $command_messages) {
+                $messages[] = '';
+                $messages[] = sprintf('<comment>%s</comment>', OutputFormatter::escape($namespace));
+                foreach ($command_messages as $command_message) {
+                    $messages[] = $command_message;
+                }
+            }
+
+            $output->page($messages);
+        }
+    }
+}