Add additional fields and additional utility

Author: Crim

src/main/java/org/sourcelab/buildkite/api/client/request/RetryMultipleJobsOptions.java

@@ -0,0 +1,76 @@
+/**
+ * Copyright 2023 SourceLab.org https://github.com/SourceLabOrg/Buildkite-Api-Client
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
+ * documentation files (the "Software"), to deal in the Software without restriction, including without limitation the
+ * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit
+ * persons to whom the Software is furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
+ * WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+ * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.sourcelab.buildkite.api.client.request;
+
+import java.util.Collection;
+import java.util.HashSet;
+import java.util.Set;
+
+/**
+ * Options for Retrying multiple Jobs.
+ */
+public class RetryMultipleJobsOptions {
+    private final String organizationSlug;
+    private final String pipelineSlug;
+    private final long buildNumber;
+    private final Set<String> jobIds;
+
+    /**
+     * Builder instance for {@link RetryMultipleJobsOptions}.
+     * @return Builder instance for {@link RetryMultipleJobsOptions}.
+     */
+    public static RetryMultipleJobsOptionsBuilder newBuilder() {
+        return new RetryMultipleJobsOptionsBuilder();
+    }
+
+    /**
+     * Constructor.
+     */
+    public RetryMultipleJobsOptions(final String organizationSlug, final String pipelineIdSlug, final long buildNumber, final Collection<String> jobIds) {
+        this.organizationSlug = organizationSlug;
+        this.pipelineSlug = pipelineIdSlug;
+        this.buildNumber = buildNumber;
+        this.jobIds = new HashSet<>(jobIds);
+    }
+
+    public String getOrganizationSlug() {
+        return organizationSlug;
+    }
+
+    public String getPipelineSlug() {
+        return pipelineSlug;
+    }
+
+    public long getBuildNumber() {
+        return buildNumber;
+    }
+
+    public Set<String> getJobIds() {
+        return jobIds;
+    }
+
+    @Override
+    public String toString() {
+        return "RetryMultipleJobsOptions{"
+            + "\n\torganizationSlug='" + organizationSlug + '\''
+            + "\n\tpipelineSlug='" + pipelineSlug + '\''
+            + "\n\tbuildNumber=" + buildNumber
+            + "\n\tjobIds=" + jobIds
+            + "\n}";
+    }
+}

src/main/java/org/sourcelab/buildkite/api/client/request/RetryMultipleJobsOptionsBuilder.java

@@ -0,0 +1,80 @@
+/**
+ * Copyright 2023 SourceLab.org https://github.com/SourceLabOrg/Buildkite-Api-Client
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
+ * documentation files (the "Software"), to deal in the Software without restriction, including without limitation the
+ * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit
+ * persons to whom the Software is furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
+ * WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+ * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+package org.sourcelab.buildkite.api.client.request;
+
+import org.sourcelab.buildkite.api.client.exception.BuilderValidationException;
+
+import java.util.Collection;
+import java.util.HashSet;
+import java.util.Set;
+
+public final class RetryMultipleJobsOptionsBuilder {
+    private String organizationSlug = null;
+    private String pipelineSlug = null;
+    private Long buildNumber = null;
+    private Set<String> jobIds = new HashSet<>(;
+
+    public RetryMultipleJobsOptionsBuilder() {
+    }
+
+    public RetryMultipleJobsOptionsBuilder withOrganizationSlug(final String organizationSlug) {
+        this.organizationSlug = organizationSlug;
+        return this;
+    }
+
+    public RetryMultipleJobsOptionsBuilder withPipelineSlug(final String pipelineSlug) {
+        this.pipelineSlug = pipelineSlug;
+        return this;
+    }
+
+    public RetryMultipleJobsOptionsBuilder withBuildNumber(long buildNumber) {
+        this.buildNumber = buildNumber;
+        return this;
+    }
+
+    public RetryMultipleJobsOptionsBuilder withJobId(final String jobId) {
+        this.jobIds.add(jobId);
+        return this;
+    }
+
+    public RetryMultipleJobsOptionsBuilder withJobIds(final Collection<String> jobIds) {
+        this.jobIds.addAll(jobIds);
+        return this;
+    }
+
+    /**
+     * Create new {@link RetryMultipleJobsOptions} instance.
+     * @return Create new {@link RetryMultipleJobsOptions} instance.
+     */
+    public RetryMultipleJobsOptions build() {
+        // Validation
+        if (organizationSlug == null) {
+            throw new BuilderValidationException("Organization must be provided.");
+        }
+        if (pipelineSlug == null) {
+            throw new BuilderValidationException("Pipeline must be provided.");
+        }
+        if (buildNumber == null) {
+            throw new BuilderValidationException("BuildNumber must be provided.");
+        }
+        if (jobIds.isEmpty()) {
+            throw new BuilderValidationException("At least one JobId must be provided.");
+        }
+        return new RetryMultipleJobsOptions(organizationSlug, pipelineSlug, buildNumber, jobIds);
+    }
+}

src/main/java/org/sourcelab/buildkite/api/client/response/Build.java

@@ -47,6 +47,7 @@ public class Build {
     private final Pipeline pipeline;
     private final List<Job> jobs;
     private final RebuiltFrom rebuiltFrom;
+    private final PullRequest pullRequest;
 
     /**
      * Constructor.
@@ -72,7 +73,8 @@ public Build(
         @JsonProperty("creator") final Creator creator,
         @JsonProperty("pipeline") final Pipeline pipeline,
         @JsonProperty("jobs") final List<Job> jobs,
-        @JsonProperty("rebuilt_from") final RebuiltFrom rebuiltFrom
+        @JsonProperty("rebuilt_from") final RebuiltFrom rebuiltFrom,
+        @JsonProperty("pull_request") final PullRequest pullRequest
     ) {
         this.id = id;
         this.graphqlId = graphqlId;
@@ -94,6 +96,7 @@ public Build(
         this.pipeline = pipeline;
         this.jobs = jobs;
         this.rebuiltFrom = rebuiltFrom;
+        this.pullRequest = pullRequest;
     }
 
     public String getId() {
@@ -176,30 +179,35 @@ public RebuiltFrom getRebuiltFrom() {
         return rebuiltFrom;
     }
 
+    public PullRequest getPullRequest() {
+        return pullRequest;
+    }
+
     @Override
     public String toString() {
         return "Build{"
-            + "id='" + id + '\''
-            + ", graphqlId='" + graphqlId + '\''
-            + ", url='" + url + '\''
-            + ", webUrl='" + webUrl + '\''
-            + ", number=" + number
-            + ", state='" + state + '\''
-            + ", blocked=" + blocked
-            + ", message='" + message + '\''
-            + ", commit='" + commit + '\''
-            + ", branch='" + branch + '\''
-            + ", source='" + source + '\''
-            + ", createdAt=" + createdAt
-            + ", scheduledAt=" + scheduledAt
-            + ", startedAt=" + startedAt
-            + ", finishedAt=" + finishedAt
-            + ", author=" + author
-            + ", creator=" + creator
-            + ", pipeline=" + pipeline
-            + ", jobs=" + jobs
-            + ", rebuiltFrom=" + rebuiltFrom
-            + '}';
+            + "\n\tid='" + id + '\''
+            + "\n\tgraphqlId='" + graphqlId + '\''
+            + "\n\turl='" + url + '\''
+            + "\n\twebUrl='" + webUrl + '\''
+            + "\n\tnumber=" + number
+            + "\n\tstate='" + state + '\''
+            + "\n\tblocked=" + blocked
+            + "\n\tmessage='" + message + '\''
+            + "\n\tcommit='" + commit + '\''
+            + "\n\tbranch='" + branch + '\''
+            + "\n\tsource='" + source + '\''
+            + "\n\tcreatedAt=" + createdAt
+            + "\n\tscheduledAt=" + scheduledAt
+            + "\n\tstartedAt=" + startedAt
+            + "\n\tfinishedAt=" + finishedAt
+            + "\n\tauthor=" + author
+            + "\n\tcreator=" + creator
+            + "\n\tpipeline=" + pipeline
+            + "\n\tjobs=" + jobs
+            + "\n\trebuiltFrom=" + rebuiltFrom
+            + "\n\tpullRequest=" + pullRequest
+            + "\n}";
     }
 
     // TODO

src/main/java/org/sourcelab/buildkite/api/client/response/Job.java

@@ -51,6 +51,10 @@ public class Job {
     private final long retriesCount;
     private final String retryType;
 
+    // Parallel Builds
+    private final Integer parallelGroupIndex;
+    private final Integer parallelGroupTotal;
+
     // TODO
     // "agent_query_rules": ["*"],
 
@@ -81,7 +85,9 @@ public Job(
         @JsonProperty("retried") final Boolean retried,
         @JsonProperty("retriedInJobId") final String retriedInJobId,
         @JsonProperty("retriesCount") final Long retriesCount,
-        @JsonProperty("retryType") final String retryType
+        @JsonProperty("retryType") final String retryType,
+        @JsonProperty("parallel_group_index") final Integer parallelGroupIndex,
+        @JsonProperty("parallel_group_total") final Integer parallelGroupTotal
     ) {
         this.id = id;
         this.graphqlId = graphqlId;
@@ -106,6 +112,8 @@ public Job(
         this.retriedInJobId = retriedInJobId;
         this.retriesCount = retriesCount == null ? 0 : retriesCount;
         this.retryType = retryType;
+        this.parallelGroupIndex = parallelGroupIndex;
+        this.parallelGroupTotal = parallelGroupTotal;
     }
 
     public String getId() {
@@ -200,32 +208,42 @@ public String getRetryType() {
         return retryType;
     }
 
+    public Integer getParallelGroupIndex() {
+        return parallelGroupIndex;
+    }
+
+    public Integer getParallelGroupTotal() {
+        return parallelGroupTotal;
+    }
+
     @Override
     public String toString() {
         return "Job{"
-            + "id='" + id + '\''
-            + ", graphqlId='" + graphqlId + '\''
-            + ", type='" + type + '\''
-            + ", name='" + name + '\''
-            + ", stepKey='" + stepKey + '\''
-            + ", state='" + state + '\''
-            + ", webUrl='" + webUrl + '\''
-            + ", logUrl='" + logUrl + '\''
-            + ", rawLogUrl='" + rawLogUrl + '\''
-            + ", command='" + command + '\''
-            + ", softFailed=" + softFailed
-            + ", exitStatus=" + exitStatus
-            + ", artifactPaths='" + artifactPaths + '\''
-            + ", agent=" + agent
-            + ", createdAt=" + createdAt
-            + ", scheduledAt=" + scheduledAt
-            + ", runnableAt=" + runnableAt
-            + ", startedAt=" + startedAt
-            + ", finishedAt=" + finishedAt
-            + ", retried=" + retried
-            + ", retriedInJobId='" + retriedInJobId + '\''
-            + ", retriesCount=" + retriesCount
-            + ", retryType='" + retryType + '\''
-            + '}';
+            + "\n\tid='" + id + '\''
+            + "\n\tgraphqlId='" + graphqlId + '\''
+            + "\n\ttype='" + type + '\''
+            + "\n\tname='" + name + '\''
+            + "\n\tstepKey='" + stepKey + '\''
+            + "\n\tstate='" + state + '\''
+            + "\n\twebUrl='" + webUrl + '\''
+            + "\n\tlogUrl='" + logUrl + '\''
+            + "\n\trawLogUrl='" + rawLogUrl + '\''
+            + "\n\tcommand='" + command + '\''
+            + "\n\tsoftFailed=" + softFailed
+            + "\n\texitStatus=" + exitStatus
+            + "\n\tartifactPaths='" + artifactPaths + '\''
+            + "\n\tagent=" + agent
+            + "\n\tcreatedAt=" + createdAt
+            + "\n\tscheduledAt=" + scheduledAt
+            + "\n\trunnableAt=" + runnableAt
+            + "\n\tstartedAt=" + startedAt
+            + "\n\tfinishedAt=" + finishedAt
+            + "\n\tretried=" + retried
+            + "\n\tretriedInJobId='" + retriedInJobId + '\''
+            + "\n\tretriesCount=" + retriesCount
+            + "\n\tretryType='" + retryType + '\''
+            + "\n\tparallelGroupIndex=" + parallelGroupIndex
+            + "\n\tparallelGroupTotal=" + parallelGroupTotal
+            + "\n}";
     }
 }