Remove checked exceptions from most external APIs

src/main/java/org/kohsuke/github/AbstractBuilder.java

@@ -100,7 +100,7 @@ protected AbstractBuilder(@Nonnull Class<R> finalReturnType,
     @Override
     @Nonnull
     @BetaApi
-    public R done() throws IOException {
+    public R done() {
         R result;
         if (updateInPlace && baseInstance != null) {
             result = requester.fetchInto(baseInstance);
@@ -129,7 +129,7 @@ public R done() throws IOException {
      */
     @Nonnull
     @BetaApi
-    protected S with(@Nonnull String name, Object value) throws IOException {
+    protected S with(@Nonnull String name, Object value) {
         requester.with(name, value);
         return continueOrDone();
     }
@@ -149,7 +149,7 @@ protected S with(@Nonnull String name, Object value) throws IOException {
      */
     @Nonnull
     @BetaApi
-    protected S continueOrDone() throws IOException {
+    protected S continueOrDone() {
         // This little bit of roughness in this base class means all inheriting builders get to create Updater and
         // Setter classes from almost identical code. Creator can often be implemented with significant code reuse as
         // well.

src/main/java/org/kohsuke/github/GHApp.java

@@ -162,7 +162,7 @@ public PagedIterable<GHAppInstallation> listInstallations(final Date since) {
      *             on error
      * @see <a href="https://developer.github.com/v3/apps/#get-an-installation">Get an installation</a>
      */
-    public GHAppInstallation getInstallationById(long id) throws IOException {
+    public GHAppInstallation getInstallationById(long id) {
         return root().createRequest()
                 .withUrlPath(String.format("/app/installations/%d", id))
                 .fetch(GHAppInstallation.class);
@@ -181,7 +181,7 @@ public GHAppInstallation getInstallationById(long id) throws IOException {
      * @see <a href="https://developer.github.com/v3/apps/#get-an-organization-installation">Get an organization
      *      installation</a>
      */
-    public GHAppInstallation getInstallationByOrganization(String name) throws IOException {
+    public GHAppInstallation getInstallationByOrganization(String name) {
         return root().createRequest()
                 .withUrlPath(String.format("/orgs/%s/installation", name))
                 .fetch(GHAppInstallation.class);
@@ -202,7 +202,7 @@ public GHAppInstallation getInstallationByOrganization(String name) throws IOExc
      * @see <a href="https://developer.github.com/v3/apps/#get-a-repository-installation">Get a repository
      *      installation</a>
      */
-    public GHAppInstallation getInstallationByRepository(String ownerName, String repositoryName) throws IOException {
+    public GHAppInstallation getInstallationByRepository(String ownerName, String repositoryName) {
         return root().createRequest()
                 .withUrlPath(String.format("/repos/%s/%s/installation", ownerName, repositoryName))
                 .fetch(GHAppInstallation.class);
@@ -220,7 +220,7 @@ public GHAppInstallation getInstallationByRepository(String ownerName, String re
      *             on error
      * @see <a href="https://developer.github.com/v3/apps/#get-a-user-installation">Get a user installation</a>
      */
-    public GHAppInstallation getInstallationByUser(String name) throws IOException {
+    public GHAppInstallation getInstallationByUser(String name) {
         return root().createRequest()
                 .withUrlPath(String.format("/users/%s/installation", name))
                 .fetch(GHAppInstallation.class);

src/main/java/org/kohsuke/github/GHAppCreateTokenBuilder.java

@@ -89,7 +89,7 @@ public GHAppCreateTokenBuilder permissions(Map<String, GHPermissionType> permiss
      * @throws IOException
      *             on error
      */
-    public GHAppInstallationToken create() throws IOException {
+    public GHAppInstallationToken create() {
         return builder.method("POST").withUrlPath(apiUrlTail).fetch(GHAppInstallationToken.class);
     }
 

src/main/java/org/kohsuke/github/GHAppInstallation.java

@@ -212,7 +212,7 @@ public GHUser getSuspendedBy() {
      *             on error
      * @see <a href="https://developer.github.com/v3/apps/#delete-an-installation">Delete an installation</a>
      */
-    public void deleteInstallation() throws IOException {
+    public void deleteInstallation() {
         root().createRequest().method("DELETE").withUrlPath(String.format("/app/installations/%d", getId())).send();
     }
 
@@ -263,7 +263,7 @@ public GHAppCreateTokenBuilder createToken() {
      *      "https://docs.github.com/en/rest/apps/marketplace?apiVersion=2022-11-28#get-a-subscription-plan-for-an-account">Get
      *      a subscription plan for an account</a>
      */
-    public GHMarketplaceAccountPlan getMarketplaceAccount() throws IOException {
+    public GHMarketplaceAccountPlan getMarketplaceAccount() {
         return new GHMarketplacePlanForAccountBuilder(root(), account.getId()).createRequest();
     }
 }

src/main/java/org/kohsuke/github/GHAppInstallationToken.java

@@ -69,7 +69,7 @@ public GHRepositorySelection getRepositorySelection() {
      * @throws IOException
      *             on error
      */
-    public Date getExpiresAt() throws IOException {
+    public Date getExpiresAt() {
         return GitHubClient.parseDate(expires_at);
     }
 }

src/main/java/org/kohsuke/github/GHArtifact.java

@@ -97,7 +97,7 @@ public GHRepository getRepository() {
      * @throws IOException
      *             the io exception
      */
-    public void delete() throws IOException {
+    public void delete() {
         root().createRequest().method("DELETE").withUrlPath(getApiRoute()).send();
     }
 
@@ -112,7 +112,7 @@ public void delete() throws IOException {
      * @throws IOException
      *             The IO exception.
      */
-    public <T> T download(InputStreamFunction<T> streamFunction) throws IOException {
+    public <T> T download(InputStreamFunction<T> streamFunction) {
         requireNonNull(streamFunction, "Stream function must not be null");
 
         return root().createRequest().method("GET").withUrlPath(getApiRoute(), "zip").fetchStream(streamFunction);

src/main/java/org/kohsuke/github/GHAsset.java

@@ -45,7 +45,7 @@ public String getContentType() {
      * @throws IOException
      *             the io exception
      */
-    public void setContentType(String contentType) throws IOException {
+    public void setContentType(String contentType) {
         edit("content_type", contentType);
         this.content_type = contentType;
     }
@@ -76,7 +76,7 @@ public String getLabel() {
      * @throws IOException
      *             the io exception
      */
-    public void setLabel(String label) throws IOException {
+    public void setLabel(String label) {
         edit("label", label);
         this.label = label;
     }
@@ -127,7 +127,7 @@ public String getBrowserDownloadUrl() {
         return browser_download_url;
     }
 
-    private void edit(String key, Object value) throws IOException {
+    private void edit(String key, Object value) {
         root().createRequest().with(key, value).method("PATCH").withUrlPath(getApiRoute()).send();
     }
 
@@ -137,7 +137,7 @@ private void edit(String key, Object value) throws IOException {
      * @throws IOException
      *             the io exception
      */
-    public void delete() throws IOException {
+    public void delete() {
         root().createRequest().method("DELETE").withUrlPath(getApiRoute()).send();
     }
 

src/main/java/org/kohsuke/github/GHBlobBuilder.java

@@ -60,7 +60,7 @@ private String getApiTail() {
      * @throws IOException
      *             if the blob cannot be created.
      */
-    public GHBlob create() throws IOException {
+    public GHBlob create() {
         return req.method("POST").withUrlPath(getApiTail()).fetch(GHBlob.class);
     }
 }

src/main/java/org/kohsuke/github/GHBranch.java

@@ -38,7 +38,7 @@ public class GHBranch extends GitHubInteractiveObject {
      *             the exception
      */
     @JsonCreator
-    GHBranch(@JsonProperty(value = "name", required = true) String name) throws Exception {
+    GHBranch(@JsonProperty(value = "name", required = true) String name) {
         Objects.requireNonNull(name);
         this.name = name;
     }
@@ -106,7 +106,7 @@ public URL getProtectionUrl() {
      * @throws IOException
      *             the io exception
      */
-    public GHBranchProtection getProtection() throws IOException {
+    public GHBranchProtection getProtection() {
         return root().createRequest().setRawUrlPath(protection_url).fetch(GHBranchProtection.class);
     }
 
@@ -125,7 +125,7 @@ public String getSHA1() {
      * @throws IOException
      *             if disabling protection fails
      */
-    public void disableProtection() throws IOException {
+    public void disableProtection() {
         root().createRequest().method("DELETE").setRawUrlPath(protection_url).send();
     }
 
@@ -155,7 +155,7 @@ public GHBranchProtectionBuilder enableProtection() {
      *             if merging fails
      */
     @CheckForNull
-    public GHCommit merge(GHBranch headBranch, String commitMessage) throws IOException {
+    public GHCommit merge(GHBranch headBranch, String commitMessage) {
         return merge(headBranch.getName(), commitMessage);
     }
 
@@ -176,7 +176,7 @@ public GHCommit merge(GHBranch headBranch, String commitMessage) throws IOExcept
      *             if merging fails
      */
     @CheckForNull
-    public GHCommit merge(String head, String commitMessage) throws IOException {
+    public GHCommit merge(String head, String commitMessage) {
         GHCommit result = root().createRequest()
                 .withUrlPath(owner.getApiTailUrl("merges"))
                 .method("POST")

src/main/java/org/kohsuke/github/GHBranchProtection.java

@@ -70,7 +70,7 @@ public GHBranchProtection() {
      * @throws IOException
      *             the io exception
      */
-    public void enabledSignedCommits() throws IOException {
+    public void enabledSignedCommits() {
         requester().method("POST").withUrlPath(url + REQUIRE_SIGNATURES_URI).fetch(RequiredSignatures.class);
     }
 
@@ -80,7 +80,7 @@ public void enabledSignedCommits() throws IOException {
      * @throws IOException
      *             the io exception
      */
-    public void disableSignedCommits() throws IOException {
+    public void disableSignedCommits() {
         requester().method("DELETE").withUrlPath(url + REQUIRE_SIGNATURES_URI).send();
     }
 
@@ -172,7 +172,7 @@ public RequiredReviews getRequiredReviews() {
      * @throws IOException
      *             the io exception
      */
-    public boolean getRequiredSignatures() throws IOException {
+    public boolean getRequiredSignatures() {
         return requester().withUrlPath(url + REQUIRE_SIGNATURES_URI).fetch(RequiredSignatures.class).enabled;
     }
 

src/main/java/org/kohsuke/github/GHBranchProtectionBuilder.java

@@ -182,7 +182,7 @@ public GHBranchProtectionBuilder dismissStaleReviews(boolean v) {
      * @throws IOException
      *             the io exception
      */
-    public GHBranchProtection enable() throws IOException {
+    public GHBranchProtection enable() {
         return requester().method("PUT")
                 .with(fields)
                 .withNullable("required_status_checks", statusChecks)

src/main/java/org/kohsuke/github/GHCheckRun.java

@@ -218,10 +218,10 @@ public String getHeadSha() {
      * @throws IOException
      *             the io exception
      */
-    public List<GHPullRequest> getPullRequests() throws IOException {
+    public List<GHPullRequest> getPullRequests() {
         for (GHPullRequest singlePull : pullRequests) {
             // Only refresh if we haven't do so before
-            singlePull.refresh(singlePull.getTitle());
+            singlePull.refreshWithUnchecked(singlePull.getTitle());
         }
         return Collections.unmodifiableList(Arrays.asList(pullRequests));
     }

src/main/java/org/kohsuke/github/GHCheckRunBuilder.java

@@ -231,7 +231,7 @@ private GHCheckRunBuilder(GHRepository repo, Requester requester) {
      * @throws IOException
      *             for the usual reasons
      */
-    public @NonNull GHCheckRun create() throws IOException {
+    public @NonNull GHCheckRun create() {
         List<Annotation> extraAnnotations;
         if (output != null && output.annotations != null && output.annotations.size() > MAX_ANNOTATIONS) {
             extraAnnotations = output.annotations.subList(MAX_ANNOTATIONS, output.annotations.size());

src/main/java/org/kohsuke/github/GHCheckSuite.java

@@ -196,11 +196,11 @@ public GHApp getApp() {
      * @throws IOException
      *             the io exception
      */
-    public List<GHPullRequest> getPullRequests() throws IOException {
+    public List<GHPullRequest> getPullRequests() {
         if (pullRequests != null && pullRequests.length != 0) {
             for (GHPullRequest singlePull : pullRequests) {
                 // Only refresh if we haven't do so before
-                singlePull.refresh(singlePull.getTitle());
+                singlePull.refreshWithUnchecked(singlePull.getTitle());
             }
             return Collections.unmodifiableList(Arrays.asList(pullRequests));
         }