Replace the readme updater script with a callable

Author: jeskew

composer.json

@@ -9,20 +9,19 @@
       "homepage": "http://aws.amazon.com"
     }
   ],
-  "require-dev": {
-    "phpunit/phpunit": "~4.7",
-    "symfony/framework-bundle": "~2.3",
-    "symfony/finder": "~2.3",
-    "symfony/yaml": "~2.3",
-    "psy/psysh": "~0.4.4"
-  },
   "require": {
     "aws/aws-sdk-php": "^3.0.5",
     "symfony/config": "~2.3",
     "symfony/dependency-injection": "~2.3",
     "symfony/http-kernel": "~2.3",
     "doctrine/inflector": "~1.0"
   },
+  "require-dev": {
+    "phpunit/phpunit": "~4.7",
+    "symfony/framework-bundle": "~2.3",
+    "symfony/finder": "~2.3",
+    "symfony/yaml": "~2.3"
+  },
   "autoload": {
     "psr-4": {
       "Aws\\Symfony\\": "src/"
@@ -32,5 +31,10 @@
     "psr-4": {
       "Aws\\Symfony\\": "tests/"
     }
+  },
+  "scripts": {
+    "post-autoload-dump": [
+      "Aws\\Symfony\\ReadMeUpdater::updateReadMe"
+    ]
   }
 }

generateAvailableServices.php

@@ -0,0 +1,89 @@
+<?php
+
+namespace Aws\Symfony;
+
+use Symfony\Component\DependencyInjection\Container;
+
+class ReadMeUpdater
+{
+    const SERVICES_TABLE_START = '<!-- BEGIN SERVICE TABLE -->';
+    const SERVICES_TABLE_END = '<!-- END SERVICE TABLE -->';
+    const SERVICE_CLASS_DELIMITER = '@CLASS@';
+    const DOCS_URL_TEMPLATE = 'http://docs.aws.amazon.com/aws-sdk-php/v3/api/class-'
+        . self::SERVICE_CLASS_DELIMITER . '.html';
+
+    public static function updateReadMe()
+    {
+        require __DIR__ . '/../vendor/autoload.php';
+        (new static)->doUpdateReadMe();
+    }
+
+
+    protected function doUpdateReadMe()
+    {
+        $readMeParts = $this->getReadMeWithoutServicesTable();
+        $servicesTable = self::SERVICES_TABLE_START . "\n"
+            . $this->getServicesTable()
+            . self::SERVICES_TABLE_END;
+
+        $updatedReadMe = implode($servicesTable, $readMeParts);
+        file_put_contents($this->getReadMePath(), $updatedReadMe);
+    }
+
+    protected function getReadMeWithoutServicesTable()
+    {
+        $readMe = file_get_contents($this->getReadMePath());
+        $tablePattern = '/' . preg_quote(self::SERVICES_TABLE_START)
+            . '.*' . preg_quote(self::SERVICES_TABLE_END) . '/s';
+
+        return preg_split($tablePattern, $readMe, 2);
+    }
+
+    protected function getReadMePath()
+    {
+        return dirname(__DIR__) . '/README.md';
+    }
+
+    protected function getServicesTable()
+    {
+        $table = "Service | Instance Of\n--- | ---\n";
+
+        $container = $this->getContainer();
+        foreach ($this->getAWSServices($container) as $service) {
+            $serviceClass = get_class($container->get($service));
+            $apiDocLink = preg_replace(
+                '/' . preg_quote(self::SERVICE_CLASS_DELIMITER) . '/',
+                str_replace('\\', '.', $serviceClass),
+                self::DOCS_URL_TEMPLATE
+            );
+
+            $table .= "$service | [$serviceClass]($apiDocLink) \n";
+        }
+
+        return $table;
+    }
+
+    protected function getAWSServices(Container $container)
+    {
+        return array_filter($container->getServiceIds(), function ($service) {
+            return strpos($service, 'aws.') === 0;
+        });
+    }
+
+    /**
+     * @return Container
+     */
+    protected function getContainer()
+    {
+        static $container = null;
+
+        if (empty($container)) {
+            require_once __DIR__ . '/fixtures/AppKernel.php';
+            $kernel = new \AppKernel('test', true);
+            $kernel->boot();
+            $container = $kernel->getContainer();
+        }
+
+        return $container;
+    }
+}