Generate Exceptions (#921)

* Generate Exceptions

* Add documentation on top of class

* Leverage the new AwsErrorFactory

* Fix __constructor signature in  GeneratedException

* Fix private vs protected

* Generate all methods

* Fix things

* Add constraint in composer.Json

* Add changelog entry

Author: jderusse

CHANGELOG.md

@@ -5,6 +5,7 @@
 ### Added
 
 - Added documentation in class's headers.
+- Added Business Exceptions.
 
 ## 1.1.1
 

composer.json

@@ -13,7 +13,7 @@
     "require": {
         "php": "^7.2.5 || ^8.0",
         "ext-json": "*",
-        "async-aws/core": "^1.2"
+        "async-aws/core": "^1.9"
     },
     "extra": {
         "branch-alias": {

src/CodeDeployClient.php

@@ -3,6 +3,13 @@
 namespace AsyncAws\CodeDeploy;
 
 use AsyncAws\CodeDeploy\Enum\LifecycleEventStatus;
+use AsyncAws\CodeDeploy\Exception\DeploymentDoesNotExistException;
+use AsyncAws\CodeDeploy\Exception\DeploymentIdRequiredException;
+use AsyncAws\CodeDeploy\Exception\InvalidDeploymentIdException;
+use AsyncAws\CodeDeploy\Exception\InvalidLifecycleEventHookExecutionIdException;
+use AsyncAws\CodeDeploy\Exception\InvalidLifecycleEventHookExecutionStatusException;
+use AsyncAws\CodeDeploy\Exception\LifecycleEventAlreadyCompletedException;
+use AsyncAws\CodeDeploy\Exception\UnsupportedActionForDeploymentTypeException;
 use AsyncAws\CodeDeploy\Input\PutLifecycleEventHookExecutionStatusInput;
 use AsyncAws\CodeDeploy\Result\PutLifecycleEventHookExecutionStatusOutput;
 use AsyncAws\Core\AbstractApi;
@@ -32,11 +39,27 @@ class CodeDeployClient extends AbstractApi
      *   status?: LifecycleEventStatus::*,
      *   @region?: string,
      * }|PutLifecycleEventHookExecutionStatusInput $input
+     *
+     * @throws InvalidLifecycleEventHookExecutionStatusException
+     * @throws InvalidLifecycleEventHookExecutionIdException
+     * @throws LifecycleEventAlreadyCompletedException
+     * @throws DeploymentIdRequiredException
+     * @throws DeploymentDoesNotExistException
+     * @throws InvalidDeploymentIdException
+     * @throws UnsupportedActionForDeploymentTypeException
      */
     public function putLifecycleEventHookExecutionStatus($input = []): PutLifecycleEventHookExecutionStatusOutput
     {
         $input = PutLifecycleEventHookExecutionStatusInput::create($input);
-        $response = $this->getResponse($input->request(), new RequestContext(['operation' => 'PutLifecycleEventHookExecutionStatus', 'region' => $input->getRegion()]));
+        $response = $this->getResponse($input->request(), new RequestContext(['operation' => 'PutLifecycleEventHookExecutionStatus', 'region' => $input->getRegion(), 'exceptionMapping' => [
+            'InvalidLifecycleEventHookExecutionStatusException' => InvalidLifecycleEventHookExecutionStatusException::class,
+            'InvalidLifecycleEventHookExecutionIdException' => InvalidLifecycleEventHookExecutionIdException::class,
+            'LifecycleEventAlreadyCompletedException' => LifecycleEventAlreadyCompletedException::class,
+            'DeploymentIdRequiredException' => DeploymentIdRequiredException::class,
+            'DeploymentDoesNotExistException' => DeploymentDoesNotExistException::class,
+            'InvalidDeploymentIdException' => InvalidDeploymentIdException::class,
+            'UnsupportedActionForDeploymentTypeException' => UnsupportedActionForDeploymentTypeException::class,
+        ]]));
 
         return new PutLifecycleEventHookExecutionStatusOutput($response);
     }

src/Exception/DeploymentDoesNotExistException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The deployment with the IAM user or AWS account does not exist.
+ */
+final class DeploymentDoesNotExistException extends ClientException
+{
+}

src/Exception/DeploymentIdRequiredException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * At least one deployment ID must be specified.
+ */
+final class DeploymentIdRequiredException extends ClientException
+{
+}

src/Exception/InvalidDeploymentIdException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * At least one of the deployment IDs was specified in an invalid format.
+ */
+final class InvalidDeploymentIdException extends ClientException
+{
+}

src/Exception/InvalidLifecycleEventHookExecutionIdException.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * A lifecycle event hook is invalid. Review the `hooks` section in your AppSpec file to ensure the lifecycle events and
+ * `hooks` functions are valid.
+ */
+final class InvalidLifecycleEventHookExecutionIdException extends ClientException
+{
+}

src/Exception/InvalidLifecycleEventHookExecutionStatusException.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The result of a Lambda validation function that verifies a lifecycle event is invalid. It should return `Succeeded`
+ * or `Failed`.
+ */
+final class InvalidLifecycleEventHookExecutionStatusException extends ClientException
+{
+}

src/Exception/LifecycleEventAlreadyCompletedException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * An attempt to return the status of an already completed lifecycle event occurred.
+ */
+final class LifecycleEventAlreadyCompletedException extends ClientException
+{
+}

src/Exception/UnsupportedActionForDeploymentTypeException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeDeploy\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * A call was submitted that is not supported for the specified deployment type.
+ */
+final class UnsupportedActionForDeploymentTypeException extends ClientException
+{
+}