Implement EC2 client (#2064)

* Implement EC2 client

* Applied corrections

* Bump aliases

Author: GrahamCampbell

src/Definition/ServiceDefinition.php

@@ -15,7 +15,7 @@
  */
 class ServiceDefinition
 {
-    private const SUPPORTED_PROTOCOLS = ['json', 'rest-json', 'query', 'rest-xml'];
+    private const SUPPORTED_PROTOCOLS = ['ec2', 'json', 'rest-json', 'query', 'rest-xml'];
 
     /**
      * @var string

src/Generator/ClientGenerator.php

@@ -261,6 +261,7 @@ public function getVersion() {
             $errorFactory = $customErrorFactory;
         } else {
             switch ($definition->getProtocol()) {
+                case 'ec2':
                 case 'query':
                 case 'rest-xml':
                     $errorFactory = XmlAwsErrorFactory::class;

src/Generator/RequestSerializer/Ec2QuerySerializer.php

@@ -0,0 +1,59 @@
+<?php
+
+declare(strict_types=1);
+
+namespace AsyncAws\CodeGenerator\Generator\RequestSerializer;
+
+use AsyncAws\CodeGenerator\Definition\ListShape;
+use AsyncAws\CodeGenerator\Definition\MapShape;
+use AsyncAws\CodeGenerator\Definition\Member;
+use AsyncAws\CodeGenerator\Definition\StructureMember;
+
+/**
+ * EC2 wire-format variant of the query protocol.
+ *
+ * Differences vs standard query:
+ *  - Lists are encoded as `Parent.$index` — no `.member` infix, the list-member
+ *    locationName is ignored, and the flattened/non-flattened distinction is
+ *    irrelevant (every list serializes positionally).
+ *  - Structure-member names prefer `queryName` verbatim, else `ucfirst(locationName)`,
+ *    else the PHP key (already PascalCase in AWS EC2 models).
+ *
+ * Mirrors aws-sdk-php's `Aws\Api\Serializer\Ec2ParamBuilder`.
+ *
+ * @internal
+ */
+class Ec2QuerySerializer extends QuerySerializer
+{
+    protected function getQueryName(Member $member, string $default): string
+    {
+        if (null !== $member->getQueryName()) {
+            return $member->getQueryName();
+        }
+        if (null !== $locationName = $member->getLocationName()) {
+            return ucfirst($locationName);
+        }
+
+        return $default;
+    }
+
+    protected function getName(Member $member): string
+    {
+        if (!$member instanceof StructureMember) {
+            throw new \RuntimeException('Guessing the name for this member is not yet implemented');
+        }
+
+        $name = $this->getQueryName($member, $member->getName());
+        $shape = $member->getShape();
+
+        if ($shape instanceof ListShape) {
+            return $name;
+        }
+
+        if ($shape instanceof MapShape) {
+            return $name . ($shape->isFlattened() ? '' : '.entry');
+        }
+
+        return $name;
+    }
+}

src/Generator/RequestSerializer/QuerySerializer.php

@@ -146,7 +146,7 @@ public function getRequestBuilderExtraArguments(): array
         return [];
     }
 
-    private function getQueryName(Member $member, string $default): string
+    protected function getQueryName(Member $member, string $default): string
     {
         if (null !== $member->getQueryName()) {
             return $member->getQueryName();
@@ -162,7 +162,7 @@ private function getQueryName(Member $member, string $default): string
         return $default;
     }
 
-    private function getName(Member $member): string
+    protected function getName(Member $member): string
     {
         if ($member instanceof StructureMember) {
             $name = $this->getQueryName($member, $member->getName());

src/Generator/RequestSerializer/SerializerProvider.php

@@ -42,6 +42,8 @@ public function get(ServiceDefinition $definition): Serializer
                 return new RestJsonSerializer($this->namespaceRegistry, $this->requirementsRegistry);
             case 'query':
                 return new QuerySerializer($this->namespaceRegistry, $this->requirementsRegistry);
+            case 'ec2':
+                return new Ec2QuerySerializer($this->namespaceRegistry, $this->requirementsRegistry);
             case 'json':
                 return new JsonRpcSerializer($this->namespaceRegistry, $this->requirementsRegistry);
             default:

src/Generator/ResponseParser/ParserProvider.php

@@ -43,6 +43,7 @@ public function __construct(NamespaceRegistry $namespaceRegistry, RequirementsRe
     public function get(ServiceDefinition $definition): Parser
     {
         switch ($definition->getProtocol()) {
+            case 'ec2':
             case 'query':
             case 'rest-xml':
                 return new RestXmlParser($this->namespaceRegistry, $this->requirementsRegistry, $this->typeGenerator);

src/Generator/TestGenerator.php

@@ -102,6 +102,7 @@ private function generateInput(Operation $operation, StructureShape $shape): voi
                 $contentType = 'application/x-amz-json-' . number_format($operation->getService()->getJsonVersion(), 1);
 
                 break;
+            case 'ec2':
             case 'query':
                 $stub = substr(var_export($exampleInput ? http_build_query($exampleInput, '', '&', \PHP_QUERY_RFC3986) : "
     Action={$operation->getName()}
@@ -171,6 +172,7 @@ private function generateResult(Operation $operation, StructureShape $shape): vo
         $exampleOutput = $operation->getExample()->getOutput();
         $comment = $exampleOutput ? '// see example-1.json from SDK' : '// see ' . $operation->getApiReferenceDocumentationUrl();
         switch ($operation->getService()->getProtocol()) {
+            case 'ec2':
             case 'rest-xml':
             case 'query':
                 $stub = \sprintf('$response = new SimpleMockedResponse(%s);', var_export($this->arrayToXml($exampleOutput ?? ['change' => 'it']), true));