chore: add @CanIgnoreReturnValue to builder set methods

Preparation for enabling errorprone

appengine/java/com/google/auth/appengine/AppEngineCredentials.java

@@ -40,6 +40,7 @@
 import com.google.common.base.MoreObjects;
 import com.google.common.collect.ImmutableList;
 import com.google.common.collect.ImmutableSet;
+import com.google.errorprone.annotations.CanIgnoreReturnValue;
 import java.io.IOException;
 import java.io.ObjectInputStream;
 import java.util.Collection;
@@ -154,11 +155,13 @@ protected Builder(AppEngineCredentials credentials) {
       this.appIdentityService = credentials.appIdentityService;
     }
 
+    @CanIgnoreReturnValue
     public Builder setScopes(Collection<String> scopes) {
       this.scopes = scopes;
       return this;
     }
 
+    @CanIgnoreReturnValue
     public Builder setAppIdentityService(AppIdentityService appIdentityService) {
       this.appIdentityService = appIdentityService;
       return this;

oauth2_http/java/com/google/auth/oauth2/AccessToken.java

@@ -32,6 +32,7 @@
 package com.google.auth.oauth2;
 
 import com.google.common.base.MoreObjects;
+import com.google.errorprone.annotations.CanIgnoreReturnValue;
 import java.io.Serializable;
 import java.util.ArrayList;
 import java.util.Arrays;
@@ -158,18 +159,21 @@ public Date getExpirationTime() {
       return this.expirationTime;
     }
 
+    @CanIgnoreReturnValue
     public Builder setTokenValue(String tokenValue) {
       this.tokenValue = tokenValue;
       return this;
     }
 
+    @CanIgnoreReturnValue
     public Builder setScopes(String scopes) {
       if (scopes != null && scopes.trim().length() > 0) {
         this.scopes = Arrays.asList(scopes.split(" "));
       }
       return this;
     }
 
+    @CanIgnoreReturnValue
     public Builder setScopes(List<String> scopes) {
       if (scopes == null) {
         this.scopes = new ArrayList<>();
@@ -180,6 +184,7 @@ public Builder setScopes(List<String> scopes) {
       return this;
     }
 
+    @CanIgnoreReturnValue
     public Builder setExpirationTime(Date expirationTime) {
       this.expirationTime = expirationTime;
       return this;

oauth2_http/java/com/google/auth/oauth2/AwsRequestSignature.java

@@ -31,6 +31,7 @@
 
 package com.google.auth.oauth2;
 
+import com.google.errorprone.annotations.CanIgnoreReturnValue;
 import java.util.HashMap;
 import java.util.Map;
 
@@ -130,46 +131,55 @@ static class Builder {
     private String region;
     private String authorizationHeader;
 
+    @CanIgnoreReturnValue
     Builder setSignature(String signature) {
       this.signature = signature;
       return this;
     }
 
+    @CanIgnoreReturnValue
     Builder setCredentialScope(String credentialScope) {
       this.credentialScope = credentialScope;
       return this;
     }
 
+    @CanIgnoreReturnValue
     Builder setSecurityCredentials(AwsSecurityCredentials awsSecurityCredentials) {
       this.awsSecurityCredentials = awsSecurityCredentials;
       return this;
     }
 
+    @CanIgnoreReturnValue
     Builder setUrl(String url) {
       this.url = url;
       return this;
     }
 
+    @CanIgnoreReturnValue
     Builder setHttpMethod(String httpMethod) {
       this.httpMethod = httpMethod;
       return this;
     }
 
+    @CanIgnoreReturnValue
     Builder setCanonicalHeaders(Map<String, String> canonicalHeaders) {
       this.canonicalHeaders = new HashMap<>(canonicalHeaders);
       return this;
     }
 
+    @CanIgnoreReturnValue
     Builder setDate(String date) {
       this.date = date;
       return this;
     }
 
+    @CanIgnoreReturnValue
     Builder setRegion(String region) {
       this.region = region;
       return this;
     }
 
+    @CanIgnoreReturnValue
     Builder setAuthorizationHeader(String authorizationHeader) {
       this.authorizationHeader = authorizationHeader;
       return this;

oauth2_http/java/com/google/auth/oauth2/AwsRequestSigner.java

@@ -38,6 +38,7 @@
 import com.google.common.base.Joiner;
 import com.google.common.base.Splitter;
 import com.google.common.io.BaseEncoding;
+import com.google.errorprone.annotations.CanIgnoreReturnValue;
 import java.net.URI;
 import java.security.InvalidKeyException;
 import java.security.MessageDigest;
@@ -298,11 +299,13 @@ private Builder(
       this.region = region;
     }
 
+    @CanIgnoreReturnValue
     Builder setRequestPayload(String requestPayload) {
       this.requestPayload = requestPayload;
       return this;
     }
 
+    @CanIgnoreReturnValue
     Builder setAdditionalHeaders(Map<String, String> additionalHeaders) {
       if (additionalHeaders.containsKey("date") && additionalHeaders.containsKey("x-amz-date")) {
         throw new IllegalArgumentException("One of {date, x-amz-date} can be specified, not both.");

oauth2_http/java/com/google/auth/oauth2/ClientId.java

@@ -34,6 +34,7 @@
 import com.google.api.client.json.GenericJson;
 import com.google.api.client.json.JsonObjectParser;
 import com.google.api.client.util.Preconditions;
+import com.google.errorprone.annotations.CanIgnoreReturnValue;
 import java.io.IOException;
 import java.io.InputStream;
 import java.nio.charset.StandardCharsets;
@@ -184,11 +185,13 @@ protected Builder(ClientId clientId) {
       this.clientSecret = clientId.getClientSecret();
     }
 
+    @CanIgnoreReturnValue
     public Builder setClientId(String clientId) {
       this.clientId = clientId;
       return this;
     }
 
+    @CanIgnoreReturnValue
     public Builder setClientSecret(String clientSecret) {
       this.clientSecret = clientSecret;
       return this;

oauth2_http/java/com/google/auth/oauth2/CloudShellCredentials.java

@@ -34,6 +34,7 @@
 import com.google.api.client.json.JsonParser;
 import com.google.common.base.Charsets;
 import com.google.common.base.MoreObjects;
+import com.google.errorprone.annotations.CanIgnoreReturnValue;
 import java.io.BufferedReader;
 import java.io.IOException;
 import java.io.InputStreamReader;
@@ -131,6 +132,7 @@ protected Builder(CloudShellCredentials credentials) {
       this.authPort = credentials.authPort;
     }
 
+    @CanIgnoreReturnValue
     public Builder setAuthPort(int authPort) {
       this.authPort = authPort;
       return this;

oauth2_http/java/com/google/auth/oauth2/ComputeEngineCredentials.java

@@ -47,6 +47,7 @@
 import com.google.common.base.Joiner;
 import com.google.common.base.MoreObjects;
 import com.google.common.collect.ImmutableSet;
+import com.google.errorprone.annotations.CanIgnoreReturnValue;
 import java.io.BufferedReader;
 import java.io.File;
 import java.io.IOException;
@@ -549,11 +550,13 @@ protected Builder(ComputeEngineCredentials credentials) {
       this.scopes = credentials.scopes;
     }
 
+    @CanIgnoreReturnValue
     public Builder setHttpTransportFactory(HttpTransportFactory transportFactory) {
       this.transportFactory = transportFactory;
       return this;
     }
 
+    @CanIgnoreReturnValue
     public Builder setScopes(Collection<String> scopes) {
       this.scopes = scopes;
       return this;

oauth2_http/java/com/google/auth/oauth2/CredentialAccessBoundary.java

@@ -35,6 +35,7 @@
 import static com.google.common.base.Preconditions.checkNotNull;
 
 import com.google.api.client.json.GenericJson;
+import com.google.errorprone.annotations.CanIgnoreReturnValue;
 import java.util.ArrayList;
 import java.util.List;
 import javax.annotation.Nullable;
@@ -124,11 +125,13 @@ private Builder() {}
      * @param rule the collection of rules to be set, should not be null
      * @return this {@code Builder} object
      */
+    @CanIgnoreReturnValue
     public Builder setRules(List<AccessBoundaryRule> rule) {
       accessBoundaryRules = new ArrayList<>(checkNotNull(rule));
       return this;
     }
 
+    @CanIgnoreReturnValue
     public CredentialAccessBoundary.Builder addRule(AccessBoundaryRule rule) {
       if (accessBoundaryRules == null) {
         accessBoundaryRules = new ArrayList<>();
@@ -218,6 +221,7 @@ private Builder() {}
        * @param availableResource the resource name to set
        * @return this {@code Builder} object
        */
+      @CanIgnoreReturnValue
       public Builder setAvailableResource(String availableResource) {
         this.availableResource = availableResource;
         return this;
@@ -232,6 +236,7 @@ public Builder setAvailableResource(String availableResource) {
        * @param availablePermissions the collection of permissions to set, should not be null
        * @return this {@code Builder} object
        */
+      @CanIgnoreReturnValue
       public Builder setAvailablePermissions(List<String> availablePermissions) {
         this.availablePermissions = new ArrayList<>(checkNotNull(availablePermissions));
         return this;
@@ -261,6 +266,7 @@ public Builder addAvailablePermission(String availablePermission) {
        * @param availabilityCondition the {@code AvailabilityCondition} to set
        * @return this {@code Builder} object
        */
+      @CanIgnoreReturnValue
       public Builder setAvailabilityCondition(AvailabilityCondition availabilityCondition) {
         this.availabilityCondition = availabilityCondition;
         return this;
@@ -337,6 +343,7 @@ private Builder() {}
          * @param expression the expression to set
          * @return this {@code Builder} object
          */
+        @CanIgnoreReturnValue
         public Builder setExpression(String expression) {
           this.expression = expression;
           return this;
@@ -348,6 +355,7 @@ public Builder setExpression(String expression) {
          * @param title the title to set
          * @return this {@code Builder} object
          */
+        @CanIgnoreReturnValue
         public Builder setTitle(String title) {
           this.title = title;
           return this;
@@ -359,6 +367,7 @@ public Builder setTitle(String title) {
          * @param description the description to set
          * @return this {@code Builder} object
          */
+        @CanIgnoreReturnValue
         public Builder setDescription(String description) {
           this.description = description;
           return this;

oauth2_http/java/com/google/auth/oauth2/DownscopedCredentials.java

@@ -36,6 +36,7 @@
 
 import com.google.auth.http.HttpTransportFactory;
 import com.google.common.annotations.VisibleForTesting;
+import com.google.errorprone.annotations.CanIgnoreReturnValue;
 import java.io.IOException;
 
 /**
@@ -166,16 +167,19 @@ public static class Builder extends OAuth2Credentials.Builder {
 
     private Builder() {}
 
+    @CanIgnoreReturnValue
     public Builder setSourceCredential(GoogleCredentials sourceCredential) {
       this.sourceCredential = sourceCredential;
       return this;
     }
 
+    @CanIgnoreReturnValue
     public Builder setCredentialAccessBoundary(CredentialAccessBoundary credentialAccessBoundary) {
       this.credentialAccessBoundary = credentialAccessBoundary;
       return this;
     }
 
+    @CanIgnoreReturnValue
     public Builder setHttpTransportFactory(HttpTransportFactory transportFactory) {
       this.transportFactory = transportFactory;
       return this;

oauth2_http/java/com/google/auth/oauth2/ExternalAccountAuthorizedUserCredentials.java

@@ -47,6 +47,7 @@
 import com.google.auth.http.HttpTransportFactory;
 import com.google.common.base.MoreObjects;
 import com.google.common.io.BaseEncoding;
+import com.google.errorprone.annotations.CanIgnoreReturnValue;
 import java.io.IOException;
 import java.io.InputStream;
 import java.io.ObjectInputStream;
@@ -401,6 +402,7 @@ protected Builder(ExternalAccountAuthorizedUserCredentials credentials) {
      * @param transportFactory the {@code HttpTransportFactory} to set
      * @return this {@code Builder} object
      */
+    @CanIgnoreReturnValue
     public Builder setHttpTransportFactory(HttpTransportFactory transportFactory) {
       this.transportFactory = transportFactory;
       return this;
@@ -413,6 +415,7 @@ public Builder setHttpTransportFactory(HttpTransportFactory transportFactory) {
      * @param audience the audience to set
      * @return this {@code Builder} object
      */
+    @CanIgnoreReturnValue
     public Builder setAudience(String audience) {
       this.audience = audience;
       return this;
@@ -424,6 +427,7 @@ public Builder setAudience(String audience) {
      * @param tokenUrl the token exchange url to set
      * @return this {@code Builder} object
      */
+    @CanIgnoreReturnValue
     public Builder setTokenUrl(String tokenUrl) {
       this.tokenUrl = tokenUrl;
       return this;
@@ -435,6 +439,7 @@ public Builder setTokenUrl(String tokenUrl) {
      * @param tokenInfoUrl the token info url to set
      * @return this {@code Builder} object
      */
+    @CanIgnoreReturnValue
     public Builder setTokenInfoUrl(String tokenInfoUrl) {
       this.tokenInfoUrl = tokenInfoUrl;
       return this;
@@ -446,6 +451,7 @@ public Builder setTokenInfoUrl(String tokenInfoUrl) {
      * @param revokeUrl the revoke url to set
      * @return this {@code Builder} object
      */
+    @CanIgnoreReturnValue
     public Builder setRevokeUrl(String revokeUrl) {
       this.revokeUrl = revokeUrl;
       return this;
@@ -457,6 +463,7 @@ public Builder setRevokeUrl(String revokeUrl) {
      * @param refreshToken the refresh token
      * @return this {@code Builder} object
      */
+    @CanIgnoreReturnValue
     public Builder setRefreshToken(String refreshToken) {
       this.refreshToken = refreshToken;
       return this;
@@ -468,6 +475,7 @@ public Builder setRefreshToken(String refreshToken) {
      * @param clientId the client ID
      * @return this {@code Builder} object
      */
+    @CanIgnoreReturnValue
     public Builder setClientId(String clientId) {
       this.clientId = clientId;
       return this;
@@ -479,6 +487,7 @@ public Builder setClientId(String clientId) {
      * @param clientSecret the client secret
      * @return this {@code Builder} object
      */
+    @CanIgnoreReturnValue
     public Builder setClientSecret(String clientSecret) {
       this.clientSecret = clientSecret;
       return this;
@@ -490,6 +499,7 @@ public Builder setClientSecret(String clientSecret) {
      * @param quotaProjectId the quota and billing project id to set
      * @return this {@code Builder} object
      */
+    @CanIgnoreReturnValue
     public Builder setQuotaProjectId(String quotaProjectId) {
       super.setQuotaProjectId(quotaProjectId);
       return this;
@@ -501,6 +511,7 @@ public Builder setQuotaProjectId(String quotaProjectId) {
      * @param accessToken the access token
      * @return this {@code Builder} object
      */
+    @CanIgnoreReturnValue
     public Builder setAccessToken(AccessToken accessToken) {
       super.setAccessToken(accessToken);
       return this;