From bf880ad5e0d81154694c636a48a29ea3571afb93 Mon Sep 17 00:00:00 2001
From: Thom Toogood <thomtoogood@gmail.com>
Date: Tue, 12 Sep 2017 13:17:08 +1000
Subject: [PATCH] Allow custom script descriptions.

---
 doc/articles/scripts.md                     | 16 ++++++++++++++++
 src/Composer/Command/ScriptAliasCommand.php |  6 ++++--
 src/Composer/Console/Application.php        |  3 ++-
 3 files changed, 22 insertions(+), 3 deletions(-)

diff --git a/doc/articles/scripts.md b/doc/articles/scripts.md
index 6328b0eab..f81163a56 100644
--- a/doc/articles/scripts.md
+++ b/doc/articles/scripts.md
@@ -271,3 +271,19 @@ resolve to whatever php process is currently being used:
 One limitation of this is that you can not call multiple commands in
 a row like `@php install && @php foo`. You must split them up in a
 JSON array of commands.
+
+## Custom descriptions.
+
+You can set custom script descriptions with the following extra in your composer.json:
+
+ ```json
+ {
+     "extra": {
+        "scripts-description": {
+            "test": "Run all tests!"
+        }
+     }
+ }
+ ```
+
+> **Note:** You can only set custom descriptions of custom commands.
diff --git a/src/Composer/Command/ScriptAliasCommand.php b/src/Composer/Command/ScriptAliasCommand.php
index 50d0d77a1..81f1454da 100644
--- a/src/Composer/Command/ScriptAliasCommand.php
+++ b/src/Composer/Command/ScriptAliasCommand.php
@@ -23,10 +23,12 @@ use Symfony\Component\Console\Output\OutputInterface;
 class ScriptAliasCommand extends BaseCommand
 {
     private $script;
+    private $description;
 
-    public function __construct($script)
+    public function __construct($script, $description)
     {
         $this->script = $script;
+        $this->description = empty($description) ? 'Runs the '.$script.' script as defined in composer.json.' : $description;
 
         parent::__construct();
     }
@@ -35,7 +37,7 @@ class ScriptAliasCommand extends BaseCommand
     {
         $this
             ->setName($this->script)
-            ->setDescription('Runs the '.$this->script.' script as defined in composer.json.')
+            ->setDescription($this->description)
             ->setDefinition(array(
                 new InputOption('dev', null, InputOption::VALUE_NONE, 'Sets the dev mode.'),
                 new InputOption('no-dev', null, InputOption::VALUE_NONE, 'Disables the dev mode.'),
diff --git a/src/Composer/Console/Application.php b/src/Composer/Console/Application.php
index bbe551a83..76b67e495 100644
--- a/src/Composer/Console/Application.php
+++ b/src/Composer/Console/Application.php
@@ -228,7 +228,8 @@ class Application extends BaseApplication
                             if ($this->has($script)) {
                                 $io->writeError('<warning>A script named '.$script.' would override a Composer command and has been skipped</warning>');
                             } else {
-                                $this->add(new Command\ScriptAliasCommand($script));
+                                $description = isset($composer['extra']['scripts-description'][$script]) ? $composer['extra']['scripts-description'][$script]:NULL;
+                                $this->add(new Command\ScriptAliasCommand($script, $description));
                             }
                         }
                     }