Generate the phpdoc for the static create method of objects (#1464)

Author: stof

src/Input/CreateDeploymentInput.php

@@ -166,6 +166,22 @@ public function __construct(array $input = [])
         parent::__construct($input);
     }
 
+    /**
+     * @param array{
+     *   applicationName?: string,
+     *   deploymentGroupName?: string,
+     *   revision?: RevisionLocation|array,
+     *   deploymentConfigName?: string,
+     *   description?: string,
+     *   ignoreApplicationStopFailures?: bool,
+     *   targetInstances?: TargetInstances|array,
+     *   autoRollbackConfiguration?: AutoRollbackConfiguration|array,
+     *   updateOutdatedInstancesOnly?: bool,
+     *   fileExistsBehavior?: FileExistsBehavior::*,
+     *   overrideAlarmConfiguration?: AlarmConfiguration|array,
+     *   '@region'?: string|null,
+     * }|CreateDeploymentInput $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/Input/GetDeploymentInput.php

@@ -33,6 +33,12 @@ public function __construct(array $input = [])
         parent::__construct($input);
     }
 
+    /**
+     * @param array{
+     *   deploymentId?: string,
+     *   '@region'?: string|null,
+     * }|GetDeploymentInput $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/Input/PutLifecycleEventHookExecutionStatusInput.php

@@ -50,6 +50,14 @@ public function __construct(array $input = [])
         parent::__construct($input);
     }
 
+    /**
+     * @param array{
+     *   deploymentId?: string,
+     *   lifecycleEventHookExecutionId?: string,
+     *   status?: LifecycleEventStatus::*,
+     *   '@region'?: string|null,
+     * }|PutLifecycleEventHookExecutionStatusInput $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/Alarm.php

@@ -22,6 +22,11 @@ public function __construct(array $input)
         $this->name = $input['name'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   name?: null|string,
+     * }|Alarm $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/AlarmConfiguration.php

@@ -40,6 +40,13 @@ public function __construct(array $input)
         $this->alarms = isset($input['alarms']) ? array_map([Alarm::class, 'create'], $input['alarms']) : null;
     }
 
+    /**
+     * @param array{
+     *   enabled?: null|bool,
+     *   ignorePollAlarmFailure?: null|bool,
+     *   alarms?: null|Alarm[],
+     * }|AlarmConfiguration $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/AppSpecContent.php

@@ -41,6 +41,12 @@ public function __construct(array $input)
         $this->sha256 = $input['sha256'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   content?: null|string,
+     *   sha256?: null|string,
+     * }|AppSpecContent $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/AutoRollbackConfiguration.php

@@ -33,6 +33,12 @@ public function __construct(array $input)
         $this->events = $input['events'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   enabled?: null|bool,
+     *   events?: null|list<AutoRollbackEvent::*>,
+     * }|AutoRollbackConfiguration $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/BlueGreenDeploymentConfiguration.php

@@ -37,6 +37,13 @@ public function __construct(array $input)
         $this->greenFleetProvisioningOption = isset($input['greenFleetProvisioningOption']) ? GreenFleetProvisioningOption::create($input['greenFleetProvisioningOption']) : null;
     }
 
+    /**
+     * @param array{
+     *   terminateBlueInstancesOnDeploymentSuccess?: null|BlueInstanceTerminationOption|array,
+     *   deploymentReadyOption?: null|DeploymentReadyOption|array,
+     *   greenFleetProvisioningOption?: null|GreenFleetProvisioningOption|array,
+     * }|BlueGreenDeploymentConfiguration $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/BlueInstanceTerminationOption.php

@@ -42,6 +42,12 @@ public function __construct(array $input)
         $this->terminationWaitTimeInMinutes = $input['terminationWaitTimeInMinutes'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   action?: null|InstanceAction::*,
+     *   terminationWaitTimeInMinutes?: null|int,
+     * }|BlueInstanceTerminationOption $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/DeploymentInfo.php

@@ -260,6 +260,40 @@ public function __construct(array $input)
         $this->overrideAlarmConfiguration = isset($input['overrideAlarmConfiguration']) ? AlarmConfiguration::create($input['overrideAlarmConfiguration']) : null;
     }
 
+    /**
+     * @param array{
+     *   applicationName?: null|string,
+     *   deploymentGroupName?: null|string,
+     *   deploymentConfigName?: null|string,
+     *   deploymentId?: null|string,
+     *   previousRevision?: null|RevisionLocation|array,
+     *   revision?: null|RevisionLocation|array,
+     *   status?: null|DeploymentStatus::*,
+     *   errorInformation?: null|ErrorInformation|array,
+     *   createTime?: null|\DateTimeImmutable,
+     *   startTime?: null|\DateTimeImmutable,
+     *   completeTime?: null|\DateTimeImmutable,
+     *   deploymentOverview?: null|DeploymentOverview|array,
+     *   description?: null|string,
+     *   creator?: null|DeploymentCreator::*,
+     *   ignoreApplicationStopFailures?: null|bool,
+     *   autoRollbackConfiguration?: null|AutoRollbackConfiguration|array,
+     *   updateOutdatedInstancesOnly?: null|bool,
+     *   rollbackInfo?: null|RollbackInfo|array,
+     *   deploymentStyle?: null|DeploymentStyle|array,
+     *   targetInstances?: null|TargetInstances|array,
+     *   instanceTerminationWaitTimeStarted?: null|bool,
+     *   blueGreenDeploymentConfiguration?: null|BlueGreenDeploymentConfiguration|array,
+     *   loadBalancerInfo?: null|LoadBalancerInfo|array,
+     *   additionalDeploymentStatusInfo?: null|string,
+     *   fileExistsBehavior?: null|FileExistsBehavior::*,
+     *   deploymentStatusMessages?: null|string[],
+     *   computePlatform?: null|ComputePlatform::*,
+     *   externalId?: null|string,
+     *   relatedDeployments?: null|RelatedDeployments|array,
+     *   overrideAlarmConfiguration?: null|AlarmConfiguration|array,
+     * }|DeploymentInfo $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/DeploymentOverview.php

@@ -57,6 +57,16 @@ public function __construct(array $input)
         $this->ready = $input['Ready'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   Pending?: null|string,
+     *   InProgress?: null|string,
+     *   Succeeded?: null|string,
+     *   Failed?: null|string,
+     *   Skipped?: null|string,
+     *   Ready?: null|string,
+     * }|DeploymentOverview $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/DeploymentReadyOption.php

@@ -39,6 +39,12 @@ public function __construct(array $input)
         $this->waitTimeInMinutes = $input['waitTimeInMinutes'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   actionOnTimeout?: null|DeploymentReadyAction::*,
+     *   waitTimeInMinutes?: null|int,
+     * }|DeploymentReadyOption $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/DeploymentStyle.php

@@ -33,6 +33,12 @@ public function __construct(array $input)
         $this->deploymentOption = $input['deploymentOption'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   deploymentType?: null|DeploymentType::*,
+     *   deploymentOption?: null|DeploymentOption::*,
+     * }|DeploymentStyle $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/EC2TagFilter.php

@@ -43,6 +43,13 @@ public function __construct(array $input)
         $this->type = $input['Type'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   Key?: null|string,
+     *   Value?: null|string,
+     *   Type?: null|EC2TagFilterType::*,
+     * }|EC2TagFilter $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/EC2TagSet.php

@@ -23,6 +23,11 @@ public function __construct(array $input)
         $this->ec2TagSetList = $input['ec2TagSetList'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   ec2TagSetList?: null|array[],
+     * }|EC2TagSet $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/ELBInfo.php

@@ -26,6 +26,11 @@ public function __construct(array $input)
         $this->name = $input['name'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   name?: null|string,
+     * }|ELBInfo $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/ErrorInformation.php

@@ -56,6 +56,12 @@ public function __construct(array $input)
         $this->message = $input['message'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   code?: null|ErrorCode::*,
+     *   message?: null|string,
+     * }|ErrorInformation $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/GitHubLocation.php

@@ -32,6 +32,12 @@ public function __construct(array $input)
         $this->commitId = $input['commitId'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   repository?: null|string,
+     *   commitId?: null|string,
+     * }|GitHubLocation $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/GreenFleetProvisioningOption.php

@@ -28,6 +28,11 @@ public function __construct(array $input)
         $this->action = $input['action'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   action?: null|GreenFleetProvisioningAction::*,
+     * }|GreenFleetProvisioningOption $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/LoadBalancerInfo.php

@@ -42,6 +42,13 @@ public function __construct(array $input)
         $this->targetGroupPairInfoList = isset($input['targetGroupPairInfoList']) ? array_map([TargetGroupPairInfo::class, 'create'], $input['targetGroupPairInfoList']) : null;
     }
 
+    /**
+     * @param array{
+     *   elbInfoList?: null|ELBInfo[],
+     *   targetGroupInfoList?: null|TargetGroupInfo[],
+     *   targetGroupPairInfoList?: null|TargetGroupPairInfo[],
+     * }|LoadBalancerInfo $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/RawString.php

@@ -31,6 +31,12 @@ public function __construct(array $input)
         $this->sha256 = $input['sha256'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   content?: null|string,
+     *   sha256?: null|string,
+     * }|RawString $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/RelatedDeployments.php

@@ -29,6 +29,12 @@ public function __construct(array $input)
         $this->autoUpdateOutdatedInstancesDeploymentIds = $input['autoUpdateOutdatedInstancesDeploymentIds'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   autoUpdateOutdatedInstancesRootDeploymentId?: null|string,
+     *   autoUpdateOutdatedInstancesDeploymentIds?: null|string[],
+     * }|RelatedDeployments $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/RevisionLocation.php

@@ -60,6 +60,15 @@ public function __construct(array $input)
         $this->appSpecContent = isset($input['appSpecContent']) ? AppSpecContent::create($input['appSpecContent']) : null;
     }
 
+    /**
+     * @param array{
+     *   revisionType?: null|RevisionLocationType::*,
+     *   s3Location?: null|S3Location|array,
+     *   gitHubLocation?: null|GitHubLocation|array,
+     *   string?: null|RawString|array,
+     *   appSpecContent?: null|AppSpecContent|array,
+     * }|RevisionLocation $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/RollbackInfo.php

@@ -38,6 +38,13 @@ public function __construct(array $input)
         $this->rollbackMessage = $input['rollbackMessage'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   rollbackDeploymentId?: null|string,
+     *   rollbackTriggeringDeploymentId?: null|string,
+     *   rollbackMessage?: null|string,
+     * }|RollbackInfo $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/S3Location.php

@@ -61,6 +61,15 @@ public function __construct(array $input)
         $this->eTag = $input['eTag'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   bucket?: null|string,
+     *   key?: null|string,
+     *   bundleType?: null|BundleType::*,
+     *   version?: null|string,
+     *   eTag?: null|string,
+     * }|S3Location $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/ValueObject/TargetGroupInfo.php

@@ -26,6 +26,11 @@ public function __construct(array $input)
         $this->name = $input['name'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   name?: null|string,
+     * }|TargetGroupInfo $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);