feature #83 Installer now generates a good project name for composer.json (javiereguiluz)

This PR was squashed before being merged into the 1.0-dev branch (closes #83).

Discussion
----------

Installer now generates a good project name for composer.json

This fixes #78 and it's completely based on the [code used by Composer](https://github.com/composer/composer/blob/4a3bc58adfd501fa6e82c82fdd9e8d4036898fa1/src/Composer/Command/InitCommand.php#L172-186) and reported by @stof.

In addition to the generation of the project name, this PR reorders and adds missing docs for some methods.

Commits
-------

d862e51 Installer now generates a good project name for composer.json

Author: javiereguiluz

src/Symfony/Installer/NewCommand.php

@@ -68,6 +68,7 @@ protected function execute(InputInterface $input, OutputInterface $output)
                 ->extract()
                 ->cleanUp()
                 ->updateParameters()
+                ->updateComposerJson()
                 ->checkSymfonyRequirements()
                 ->displayInstallationResult()
             ;
@@ -372,26 +373,6 @@ private function displayInstallationResult()
         return $this;
     }
 
-    /**
-     * Utility method to show the number of bytes in a readable format.
-     *
-     * @param int     $bytes The number of bytes to format
-     *
-     * @return string The human readable string of bytes (e.g. 4.32MB)
-     */
-    private function formatSize($bytes)
-    {
-        $units = array('B', 'KB', 'MB', 'GB', 'TB');
-
-        $bytes = max($bytes, 0);
-        $pow = $bytes ? floor(log($bytes, 1024)) : 0;
-        $pow = min($pow, count($units) - 1);
-
-        $bytes /= pow(1024, $pow);
-
-        return number_format($bytes, 2).' '.$units[$pow];
-    }
-
     /**
      * Checks if environment meets symfony requirements
      *
@@ -411,11 +392,25 @@ private function checkSymfonyRequirements()
         return $this;
     }
 
+    /**
+     * Updates the Symfony parameters.yml file to replace default configuration
+     * values with better generated values.
+     *
+     * @return NewCommand
+     */
     private function updateParameters()
     {
         $filename = $this->projectDir.'/app/config/parameters.yml';
 
         if (!is_writable($filename)) {
+            if ($this->output->isVerbose()) {
+                $this->output->writeln(sprintf(
+                    " <comment>[WARNING]</comment> The value of the <info>secret</info> configuration option cannot be updated because\n".
+                    " the <comment>%s</comment> file is not writable.\n",
+                    $filename
+                ));
+            }
+
             return $this;
         }
 
@@ -425,15 +420,64 @@ private function updateParameters()
         return $this;
     }
 
-    private function generateRandomSecret()
+    /**
+     * Updates the composer.json file to provide better values for some of the
+     * default configuration values.
+     *
+     * @return NewCommand
+     */
+    private function updateComposerJson()
     {
-        if (function_exists('openssl_random_pseudo_bytes')) {
-            return hash('sha1', openssl_random_pseudo_bytes(23));
+        $filename = $this->projectDir.'/composer.json';
+
+        if (!is_writable($filename)) {
+            if ($this->output->isVerbose()) {
+                $this->output->writeln(sprintf(
+                    " <comment>[WARNING]</comment> Project name cannot be configured because\n".
+                    " the <comment>%s</comment> file is not writable.\n",
+                    $filename
+                ));
+            }
+
+            return $this;
         }
 
-        return hash('sha1', uniqid(mt_rand(), true));
+        $ret = str_replace(
+            '"name": "symfony/framework-standard-edition",',
+            sprintf('"name": "%s",', $this->generateComposerProjectName()),
+            file_get_contents($filename)
+        );
+        file_put_contents($filename, $ret);
+
+        return $this;
     }
 
+    /**
+     * Utility method to show the number of bytes in a readable format.
+     *
+     * @param int     $bytes The number of bytes to format
+     *
+     * @return string The human readable string of bytes (e.g. 4.32MB)
+     */
+    private function formatSize($bytes)
+    {
+        $units = array('B', 'KB', 'MB', 'GB', 'TB');
+
+        $bytes = max($bytes, 0);
+        $pow = $bytes ? floor(log($bytes, 1024)) : 0;
+        $pow = min($pow, count($units) - 1);
+
+        $bytes /= pow(1024, $pow);
+
+        return number_format($bytes, 2).' '.$units[$pow];
+    }
+
+    /**
+     * Formats the error message contained in the given Requirement item
+     * using the optional line length provided.
+     *
+     * @return string
+     */
     private function getErrorMessage(\Requirement $requirement, $lineSize = 70)
     {
         if ($requirement->isFulfilled()) {
@@ -467,6 +511,45 @@ private function getInstalledSymfonyVersion()
         }
     }
 
+    /**
+     * Generates a good random value for Symfony's 'secret' option
+     *
+     * @return string
+     */
+    private function generateRandomSecret()
+    {
+        if (function_exists('openssl_random_pseudo_bytes')) {
+            return hash('sha1', openssl_random_pseudo_bytes(23));
+        }
+
+        return hash('sha1', uniqid(mt_rand(), true));
+    }
+
+    /**
+     * Generates a good Composer project name based on the application name
+     * and on the user name.
+     *
+     * @return string
+     */
+    private function generateComposerProjectName()
+    {
+        $name = preg_replace('{(?:([a-z])([A-Z])|([A-Z])([A-Z][a-z]))}', '\\1\\3-\\2\\4', $this->projectName);
+        $name = strtolower($name);
+
+        if (!empty($_SERVER['USERNAME'])) {
+            $name = $_SERVER['USERNAME'].'/'.$name;
+        } elseif ($user = posix_getpwuid(posix_getuid())) {
+            $name = $user['name'].'/'.$name;
+        } elseif (get_current_user()) {
+            $name = get_current_user().'/'.$name;
+        } else {
+            // package names must be in the format foo/bar
+            $name = $name.'/'.$name;
+        }
+
+        return $name;
+    }
+
     /**
      * Returns the executed command.
      *