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

Author: stof

src/Input/BatchGetItemInput.php

@@ -98,6 +98,13 @@ public function __construct(array $input = [])
         parent::__construct($input);
     }
 
+    /**
+     * @param array{
+     *   RequestItems?: array<string, KeysAndAttributes>,
+     *   ReturnConsumedCapacity?: ReturnConsumedCapacity::*,
+     *   '@region'?: string|null,
+     * }|BatchGetItemInput $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/Input/BatchWriteItemInput.php

@@ -79,6 +79,14 @@ public function __construct(array $input = [])
         parent::__construct($input);
     }
 
+    /**
+     * @param array{
+     *   RequestItems?: array<string, array>,
+     *   ReturnConsumedCapacity?: ReturnConsumedCapacity::*,
+     *   ReturnItemCollectionMetrics?: ReturnItemCollectionMetrics::*,
+     *   '@region'?: string|null,
+     * }|BatchWriteItemInput $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/Input/CreateTableInput.php

@@ -252,6 +252,23 @@ public function __construct(array $input = [])
         parent::__construct($input);
     }
 
+    /**
+     * @param array{
+     *   AttributeDefinitions?: AttributeDefinition[],
+     *   TableName?: string,
+     *   KeySchema?: KeySchemaElement[],
+     *   LocalSecondaryIndexes?: LocalSecondaryIndex[],
+     *   GlobalSecondaryIndexes?: GlobalSecondaryIndex[],
+     *   BillingMode?: BillingMode::*,
+     *   ProvisionedThroughput?: ProvisionedThroughput|array,
+     *   StreamSpecification?: StreamSpecification|array,
+     *   SSESpecification?: SSESpecification|array,
+     *   Tags?: Tag[],
+     *   TableClass?: TableClass::*,
+     *   DeletionProtectionEnabled?: bool,
+     *   '@region'?: string|null,
+     * }|CreateTableInput $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/Input/DeleteItemInput.php

@@ -221,6 +221,21 @@ public function __construct(array $input = [])
         parent::__construct($input);
     }
 
+    /**
+     * @param array{
+     *   TableName?: string,
+     *   Key?: array<string, AttributeValue>,
+     *   Expected?: array<string, ExpectedAttributeValue>,
+     *   ConditionalOperator?: ConditionalOperator::*,
+     *   ReturnValues?: ReturnValue::*,
+     *   ReturnConsumedCapacity?: ReturnConsumedCapacity::*,
+     *   ReturnItemCollectionMetrics?: ReturnItemCollectionMetrics::*,
+     *   ConditionExpression?: string,
+     *   ExpressionAttributeNames?: array<string, string>,
+     *   ExpressionAttributeValues?: array<string, AttributeValue>,
+     *   '@region'?: string|null,
+     * }|DeleteItemInput $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/Input/DeleteTableInput.php

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

src/Input/DescribeEndpointsRequest.php

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

src/Input/DescribeTableInput.php

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

src/Input/ExecuteStatementInput.php

@@ -81,6 +81,17 @@ public function __construct(array $input = [])
         parent::__construct($input);
     }
 
+    /**
+     * @param array{
+     *   Statement?: string,
+     *   Parameters?: AttributeValue[],
+     *   ConsistentRead?: bool,
+     *   NextToken?: string,
+     *   ReturnConsumedCapacity?: ReturnConsumedCapacity::*,
+     *   Limit?: int,
+     *   '@region'?: string|null,
+     * }|ExecuteStatementInput $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/Input/GetItemInput.php

@@ -140,6 +140,18 @@ public function __construct(array $input = [])
         parent::__construct($input);
     }
 
+    /**
+     * @param array{
+     *   TableName?: string,
+     *   Key?: array<string, AttributeValue>,
+     *   AttributesToGet?: string[],
+     *   ConsistentRead?: bool,
+     *   ReturnConsumedCapacity?: ReturnConsumedCapacity::*,
+     *   ProjectionExpression?: string,
+     *   ExpressionAttributeNames?: array<string, string>,
+     *   '@region'?: string|null,
+     * }|GetItemInput $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

src/Input/ListTablesInput.php

@@ -40,6 +40,13 @@ public function __construct(array $input = [])
         parent::__construct($input);
     }
 
+    /**
+     * @param array{
+     *   ExclusiveStartTableName?: string,
+     *   Limit?: int,
+     *   '@region'?: string|null,
+     * }|ListTablesInput $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);