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

stof · web-flow · commit cdeafa70e14c · 2023-06-24T18:58:20.000+02:00
diff --git a/src/Input/CreateRepositoryInput.php b/src/Input/CreateRepositoryInput.php
@@ -62,6 +62,14 @@ public function __construct(array $input = [])
         parent::__construct($input);
     }
 
+    /**
+     * @param array{
+     *   repositoryName?: string,
+     *   repositoryDescription?: string,
+     *   tags?: array<string, string>,
+     *   '@region'?: string|null,
+     * }|CreateRepositoryInput $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);
diff --git a/src/Input/DeleteRepositoryInput.php b/src/Input/DeleteRepositoryInput.php
@@ -33,6 +33,12 @@ public function __construct(array $input = [])
         parent::__construct($input);
     }
 
+    /**
+     * @param array{
+     *   repositoryName?: string,
+     *   '@region'?: string|null,
+     * }|DeleteRepositoryInput $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);
diff --git a/src/Input/GetBlobInput.php b/src/Input/GetBlobInput.php
@@ -44,6 +44,13 @@ public function __construct(array $input = [])
         parent::__construct($input);
     }
 
+    /**
+     * @param array{
+     *   repositoryName?: string,
+     *   blobId?: string,
+     *   '@region'?: string|null,
+     * }|GetBlobInput $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);
diff --git a/src/Input/GetBranchInput.php b/src/Input/GetBranchInput.php
@@ -39,6 +39,13 @@ public function __construct(array $input = [])
         parent::__construct($input);
     }
 
+    /**
+     * @param array{
+     *   repositoryName?: string,
+     *   branchName?: string,
+     *   '@region'?: string|null,
+     * }|GetBranchInput $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);
diff --git a/src/Input/GetCommitInput.php b/src/Input/GetCommitInput.php
@@ -44,6 +44,13 @@ public function __construct(array $input = [])
         parent::__construct($input);
     }
 
+    /**
+     * @param array{
+     *   repositoryName?: string,
+     *   commitId?: string,
+     *   '@region'?: string|null,
+     * }|GetCommitInput $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);
diff --git a/src/Input/GetDifferencesInput.php b/src/Input/GetDifferencesInput.php
@@ -91,6 +91,18 @@ public function __construct(array $input = [])
         parent::__construct($input);
     }
 
+    /**
+     * @param array{
+     *   repositoryName?: string,
+     *   beforeCommitSpecifier?: string,
+     *   afterCommitSpecifier?: string,
+     *   beforePath?: string,
+     *   afterPath?: string,
+     *   MaxResults?: int,
+     *   NextToken?: string,
+     *   '@region'?: string|null,
+     * }|GetDifferencesInput $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);
diff --git a/src/Input/ListRepositoriesInput.php b/src/Input/ListRepositoriesInput.php
@@ -53,6 +53,14 @@ public function __construct(array $input = [])
         parent::__construct($input);
     }
 
+    /**
+     * @param array{
+     *   nextToken?: string,
+     *   sortBy?: SortByEnum::*,
+     *   order?: OrderEnum::*,
+     *   '@region'?: string|null,
+     * }|ListRepositoriesInput $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);
diff --git a/src/Input/PutRepositoryTriggersInput.php b/src/Input/PutRepositoryTriggersInput.php
@@ -45,6 +45,13 @@ public function __construct(array $input = [])
         parent::__construct($input);
     }
 
+    /**
+     * @param array{
+     *   repositoryName?: string,
+     *   triggers?: RepositoryTrigger[],
+     *   '@region'?: string|null,
+     * }|PutRepositoryTriggersInput $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);
diff --git a/src/ValueObject/BlobMetadata.php b/src/ValueObject/BlobMetadata.php
@@ -41,6 +41,13 @@ public function __construct(array $input)
         $this->mode = $input['mode'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   blobId?: null|string,
+     *   path?: null|string,
+     *   mode?: null|string,
+     * }|BlobMetadata $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);
diff --git a/src/ValueObject/BranchInfo.php b/src/ValueObject/BranchInfo.php
@@ -29,6 +29,12 @@ public function __construct(array $input)
         $this->commitId = $input['commitId'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   branchName?: null|string,
+     *   commitId?: null|string,
+     * }|BranchInfo $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);
diff --git a/src/ValueObject/Commit.php b/src/ValueObject/Commit.php
@@ -72,6 +72,17 @@ public function __construct(array $input)
         $this->additionalData = $input['additionalData'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   commitId?: null|string,
+     *   treeId?: null|string,
+     *   parents?: null|string[],
+     *   message?: null|string,
+     *   author?: null|UserInfo|array,
+     *   committer?: null|UserInfo|array,
+     *   additionalData?: null|string,
+     * }|Commit $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);
diff --git a/src/ValueObject/Difference.php b/src/ValueObject/Difference.php
@@ -38,6 +38,13 @@ public function __construct(array $input)
         $this->changeType = $input['changeType'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   beforeBlob?: null|BlobMetadata|array,
+     *   afterBlob?: null|BlobMetadata|array,
+     *   changeType?: null|ChangeTypeEnum::*,
+     * }|Difference $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);
diff --git a/src/ValueObject/RepositoryMetadata.php b/src/ValueObject/RepositoryMetadata.php
@@ -85,6 +85,20 @@ public function __construct(array $input)
         $this->arn = $input['Arn'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   accountId?: null|string,
+     *   repositoryId?: null|string,
+     *   repositoryName?: null|string,
+     *   repositoryDescription?: null|string,
+     *   defaultBranch?: null|string,
+     *   lastModifiedDate?: null|\DateTimeImmutable,
+     *   creationDate?: null|\DateTimeImmutable,
+     *   cloneUrlHttp?: null|string,
+     *   cloneUrlSsh?: null|string,
+     *   Arn?: null|string,
+     * }|RepositoryMetadata $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);
diff --git a/src/ValueObject/RepositoryNameIdPair.php b/src/ValueObject/RepositoryNameIdPair.php
@@ -29,6 +29,12 @@ public function __construct(array $input)
         $this->repositoryId = $input['repositoryId'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   repositoryName?: null|string,
+     *   repositoryId?: null|string,
+     * }|RepositoryNameIdPair $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);
diff --git a/src/ValueObject/RepositoryTrigger.php b/src/ValueObject/RepositoryTrigger.php
@@ -59,6 +59,15 @@ public function __construct(array $input)
         $this->events = $input['events'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   name: string,
+     *   destinationArn: string,
+     *   customData?: null|string,
+     *   branches?: null|string[],
+     *   events: list<RepositoryTriggerEventEnum::*>,
+     * }|RepositoryTrigger $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);
diff --git a/src/ValueObject/UserInfo.php b/src/ValueObject/UserInfo.php
@@ -36,6 +36,13 @@ public function __construct(array $input)
         $this->date = $input['date'] ?? null;
     }
 
+    /**
+     * @param array{
+     *   name?: null|string,
+     *   email?: null|string,
+     *   date?: null|string,
+     * }|UserInfo $input
+     */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);

Original file line number	Diff line number	Diff line change
`@@ -62,6 +62,14 @@ public function __construct(array $input = [])`
`62`	`62`	`parent::__construct($input);`
`63`	`63`	`}`
`64`	`64`
	`65`	`+ /**`
	`66`	`+ * @param array{`
	`67`	`+ * repositoryName?: string,`
	`68`	`+ * repositoryDescription?: string,`
	`69`	`+ * tags?: array<string, string>,`
	`70`	`+ * '@region'?: string\|null,`
	`71`	`+ * }\|CreateRepositoryInput $input`
	`72`	`+ */`
`65`	`73`	`public static function create($input): self`
`66`	`74`	`{`
`67`	`75`	`return $input instanceof self ? $input : new self($input);`
Original file line number	Diff line number	Diff line change
`@@ -33,6 +33,12 @@ public function __construct(array $input = [])`
`33`	`33`	`parent::__construct($input);`
`34`	`34`	`}`
`35`	`35`
	`36`	`+ /**`
	`37`	`+ * @param array{`
	`38`	`+ * repositoryName?: string,`
	`39`	`+ * '@region'?: string\|null,`
	`40`	`+ * }\|DeleteRepositoryInput $input`
	`41`	`+ */`
`36`	`42`	`public static function create($input): self`
`37`	`43`	`{`
`38`	`44`	`return $input instanceof self ? $input : new self($input);`
Original file line number	Diff line number	Diff line change
`@@ -44,6 +44,13 @@ public function __construct(array $input = [])`
`44`	`44`	`parent::__construct($input);`
`45`	`45`	`}`
`46`	`46`
	`47`	`+ /**`
	`48`	`+ * @param array{`
	`49`	`+ * repositoryName?: string,`
	`50`	`+ * blobId?: string,`
	`51`	`+ * '@region'?: string\|null,`
	`52`	`+ * }\|GetBlobInput $input`
	`53`	`+ */`
`47`	`54`	`public static function create($input): self`
`48`	`55`	`{`
`49`	`56`	`return $input instanceof self ? $input : new self($input);`
Original file line number	Diff line number	Diff line change
`@@ -39,6 +39,13 @@ public function __construct(array $input = [])`
`39`	`39`	`parent::__construct($input);`
`40`	`40`	`}`
`41`	`41`
	`42`	`+ /**`
	`43`	`+ * @param array{`
	`44`	`+ * repositoryName?: string,`
	`45`	`+ * branchName?: string,`
	`46`	`+ * '@region'?: string\|null,`
	`47`	`+ * }\|GetBranchInput $input`
	`48`	`+ */`
`42`	`49`	`public static function create($input): self`
`43`	`50`	`{`
`44`	`51`	`return $input instanceof self ? $input : new self($input);`
Original file line number	Diff line number	Diff line change
`@@ -53,6 +53,14 @@ public function __construct(array $input = [])`
`53`	`53`	`parent::__construct($input);`
`54`	`54`	`}`
`55`	`55`
	`56`	`+ /**`
	`57`	`+ * @param array{`
	`58`	`+ * nextToken?: string,`
	`59`	`+ * sortBy?: SortByEnum::*,`
	`60`	`+ * order?: OrderEnum::*,`
	`61`	`+ * '@region'?: string\|null,`
	`62`	`+ * }\|ListRepositoriesInput $input`
	`63`	`+ */`
`56`	`64`	`public static function create($input): self`
`57`	`65`	`{`
`58`	`66`	`return $input instanceof self ? $input : new self($input);`
Original file line number	Diff line number	Diff line change
`@@ -45,6 +45,13 @@ public function __construct(array $input = [])`
`45`	`45`	`parent::__construct($input);`
`46`	`46`	`}`
`47`	`47`
	`48`	`+ /**`
	`49`	`+ * @param array{`
	`50`	`+ * repositoryName?: string,`
	`51`	`+ * triggers?: RepositoryTrigger[],`
	`52`	`+ * '@region'?: string\|null,`
	`53`	`+ * }\|PutRepositoryTriggersInput $input`
	`54`	`+ */`
`48`	`55`	`public static function create($input): self`
`49`	`56`	`{`
`50`	`57`	`return $input instanceof self ? $input : new self($input);`
Original file line number	Diff line number	Diff line change
`@@ -41,6 +41,13 @@ public function __construct(array $input)`
`41`	`41`	`$this->mode = $input['mode'] ?? null;`
`42`	`42`	`}`
`43`	`43`
	`44`	`+ /**`
	`45`	`+ * @param array{`
	`46`	`+ * blobId?: null\|string,`
	`47`	`+ * path?: null\|string,`
	`48`	`+ * mode?: null\|string,`
	`49`	`+ * }\|BlobMetadata $input`
	`50`	`+ */`
`44`	`51`	`public static function create($input): self`
`45`	`52`	`{`
`46`	`53`	`return $input instanceof self ? $input : new self($input);`
Original file line number	Diff line number	Diff line change
`@@ -29,6 +29,12 @@ public function __construct(array $input)`
`29`	`29`	`$this->commitId = $input['commitId'] ?? null;`
`30`	`30`	`}`
`31`	`31`
	`32`	`+ /**`
	`33`	`+ * @param array{`
	`34`	`+ * branchName?: null\|string,`
	`35`	`+ * commitId?: null\|string,`
	`36`	`+ * }\|BranchInfo $input`
	`37`	`+ */`
`32`	`38`	`public static function create($input): self`
`33`	`39`	`{`
`34`	`40`	`return $input instanceof self ? $input : new self($input);`
Original file line number	Diff line number	Diff line change
`@@ -38,6 +38,13 @@ public function __construct(array $input)`
`38`	`38`	`$this->changeType = $input['changeType'] ?? null;`
`39`	`39`	`}`
`40`	`40`
	`41`	`+ /**`
	`42`	`+ * @param array{`
	`43`	`+ * beforeBlob?: null\|BlobMetadata\|array,`
	`44`	`+ * afterBlob?: null\|BlobMetadata\|array,`
	`45`	`+ * changeType?: null\|ChangeTypeEnum::*,`
	`46`	`+ * }\|Difference $input`
	`47`	`+ */`
`41`	`48`	`public static function create($input): self`
`42`	`49`	`{`
`43`	`50`	`return $input instanceof self ? $input : new self($input);`
Original file line number	Diff line number	Diff line change
`@@ -36,6 +36,13 @@ public function __construct(array $input)`
`36`	`36`	`$this->date = $input['date'] ?? null;`
`37`	`37`	`}`
`38`	`38`
	`39`	`+ /**`
	`40`	`+ * @param array{`
	`41`	`+ * name?: null\|string,`
	`42`	`+ * email?: null\|string,`
	`43`	`+ * date?: null\|string,`
	`44`	`+ * }\|UserInfo $input`
	`45`	`+ */`
`39`	`46`	`public static function create($input): self`
`40`	`47`	`{`
`41`	`48`	`return $input instanceof self ? $input : new self($input);`