Merge tag 'github-api-2.0-rc.2' into release/v2.x

github-api-2.0-rc.2

Author: bitwiseman

.github/PULL_REQUEST_TEMPLATE.md

@@ -8,7 +8,7 @@
 - [ ] Add JavaDocs and other comments explaining the behavior. 
 - [ ] When adding or updating methods that fetch entities, add `@link` JavaDoc entries to the relevant documentation on https://docs.github.com/en/rest . 
 - [ ] Add tests that cover any added or changed code. This generally requires capturing snapshot test data. See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
-- [ ] Run `mvn -D enable-ci clean install site` locally. If this command doesn't succeed, your change will not pass CI.
+- [ ] Run `mvn -D enable-ci clean install site "-Dsurefire.argLine=--add-opens java.base/java.net=ALL-UNNAMED"` locally. If this command doesn't succeed, your change will not pass CI.
 - [ ] Push your changes to a branch other than `main`. You will create your PR from that branch.
 
 # When creating a PR: 

.github/workflows/maven-build.yml

@@ -35,7 +35,7 @@ jobs:
     - name: Maven Install (skipTests)
       env:
         MAVEN_OPTS: ${{ env.JAVA_11_PLUS_MAVEN_OPTS }}
-      run: mvn -B clean install -DskipTests --file pom.xml
+      run: mvn -B clean install -Djapicmp.skip=true -DskipTests --file pom.xml
     - uses: actions/upload-artifact@v4
       with:
         name: maven-target-directory
@@ -59,7 +59,27 @@ jobs:
         MAVEN_OPTS: ${{ env.JAVA_11_PLUS_MAVEN_OPTS }}
       # running install site seems to more closely imitate real site deployment,
       # more likely to prevent failed deployment
-      run: mvn -B clean install site -DskipTests --file pom.xml
+      run: mvn -B clean install site -Djapicmp.skip=true -DskipTests --file pom.xml
+  test-bridged:
+    name: build-and-test Bridged (Java 17)
+    # Does not require build output, but orders execution to prevent launching test workflows when simple build fails 
+    needs: build
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: true
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up JDK
+      uses: actions/setup-java@v4
+      with:
+        java-version: 17
+        distribution: 'temurin'
+        cache: 'maven'
+    - name: Maven Install (skipTests)
+      env:
+        MAVEN_OPTS: ${{ env.JAVA_11_PLUS_MAVEN_OPTS }}
+      #skipping japicmp check for bridged artifact until after next release
+      run: mvn -B clean install -Djapicmp.skip=true -Pbridged -D enable-ci --file pom.xml "-Dsurefire.argLine=--add-opens java.base/java.net=ALL-UNNAMED"
   test:
     name: test (${{ matrix.os }}, Java ${{ matrix.java }})
     # Does not require build output, but orders execution to prevent launching test workflows when simple build fails 
@@ -88,7 +108,8 @@ jobs:
       if: matrix.os != 'windows'
       env:
         MAVEN_OPTS: ${{ env.JAVA_11_PLUS_MAVEN_OPTS }}
-      run: mvn -B clean install -D enable-ci --file pom.xml "-Dsurefire.argLine=--add-opens java.base/java.net=ALL-UNNAMED"
+      # Disable japicmp until next release
+      run: mvn -B clean install -Djapicmp.skip=true -D enable-ci --file pom.xml "-Dsurefire.argLine=--add-opens java.base/java.net=ALL-UNNAMED"
     - name: Save coverage data
       if: matrix.os == 'ubuntu' && matrix.java == '17'
       uses: actions/upload-artifact@v4

.github/workflows/publish_release_branch.yml

@@ -56,6 +56,14 @@ jobs:
           MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN_PASSWORD }}
           MAVEN_GPG_PASSPHRASE: ${{ secrets.OSSRH_GPG_SECRET_KEY_PASSPHRASE }}
 
+      - name: Publish package with bridge methods 
+        run: mvn -B clean deploy -DskipTests -Prelease -Pbridged
+        env:
+          MAVEN_OPTS: ${{ env.JAVA_11_PLUS_MAVEN_OPTS }}
+          MAVEN_USERNAME: ${{ secrets.OSSRH_TOKEN_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN_PASSWORD }}
+          MAVEN_GPG_PASSPHRASE: ${{ secrets.OSSRH_GPG_SECRET_KEY_PASSPHRASE }}
+  
   publish_gh_pages:
     runs-on: ubuntu-latest
     needs: build

pom.xml

@@ -2,8 +2,8 @@
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
   <modelVersion>4.0.0</modelVersion>
   <groupId>org.kohsuke</groupId>
-  <artifactId>github-api</artifactId>
-  <version>2.0-rc.1</version>
+  <artifactId>${github-api.artifactId}</artifactId>
+  <version>2.0-rc.2</version>
   <name>GitHub API for Java</name>
   <description>GitHub API for Java</description>
   <url>https://hub4j.github.io/github-api/</url>
@@ -62,6 +62,7 @@
   </distributionManagement>
 
   <properties>
+    <github-api.artifactId>github-api</github-api.artifactId>
     <hamcrest.version>3.0</hamcrest.version>
     <!-- Using this as the minimum bar for code coverage.  Adding methods without covering them will fail this. -->
     <jacoco.coverage.target.bundle.method>0.70</jacoco.coverage.target.bundle.method>
@@ -141,6 +142,10 @@
       <groupId>com.fasterxml.jackson.core</groupId>
       <artifactId>jackson-databind</artifactId>
     </dependency>
+    <dependency>
+      <groupId>com.fasterxml.jackson.datatype</groupId>
+      <artifactId>jackson-datatype-jsr310</artifactId>
+    </dependency>
     <dependency>
       <groupId>com.infradna.tool</groupId>
       <artifactId>bridge-method-annotation</artifactId>
@@ -214,7 +219,7 @@
     <dependency>
       <groupId>com.google.guava</groupId>
       <artifactId>guava</artifactId>
-      <version>33.4.5-jre</version>
+      <version>33.4.6-jre</version>
       <scope>test</scope>
     </dependency>
     <dependency>
@@ -302,6 +307,18 @@
     </testResources>
     <pluginManagement>
       <plugins>
+        <plugin>
+          <groupId>com.infradna.tool</groupId>
+          <artifactId>bridge-method-injector</artifactId>
+          <version>1.30</version>
+          <executions>
+            <execution>
+              <goals>
+                <goal>process</goal>
+              </goals>
+            </execution>
+          </executions>
+        </plugin>
         <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-gpg-plugin</artifactId>
@@ -324,13 +341,16 @@
           </configuration>
         </plugin>
         <plugin>
-          <groupId>org.apache.maven.plugins</groupId>
+          <artifactId>maven-resources-plugin</artifactId>
+          <version>3.3.1</version>
+        </plugin>
+        <plugin>
           <artifactId>maven-source-plugin</artifactId>
           <version>3.3.1</version>
         </plugin>
         <plugin>
           <artifactId>maven-surefire-plugin</artifactId>
-          <version>3.5.2</version>
+          <version>3.5.3</version>
           <configuration>
             <!-- SUREFIRE-1226 workaround -->
             <trimStackTrace>false</trimStackTrace>
@@ -455,7 +475,7 @@
       <plugin>
         <groupId>com.diffplug.spotless</groupId>
         <artifactId>spotless-maven-plugin</artifactId>
-        <version>2.44.2</version>
+        <version>2.44.3</version>
         <configuration>
           <java>
             <includes>
@@ -511,7 +531,7 @@
       <plugin>
         <groupId>com.github.siom79.japicmp</groupId>
         <artifactId>japicmp-maven-plugin</artifactId>
-        <version>0.23.0</version>
+        <version>0.23.1</version>
         <configuration>
           <parameter>
             <breakBuildOnBinaryIncompatibleModifications>true</breakBuildOnBinaryIncompatibleModifications>
@@ -561,7 +581,7 @@
       </plugin>
       <plugin>
         <artifactId>maven-compiler-plugin</artifactId>
-        <version>3.13.0</version>
+        <version>3.14.0</version>
         <configuration>
           <source>11</source>
           <target>11</target>
@@ -570,7 +590,7 @@
             <annotationProcessorPath>
               <groupId>org.jenkins-ci</groupId>
               <artifactId>annotation-indexer</artifactId>
-              <version>1.17</version>
+              <version>1.18</version>
             </annotationProcessorPath>
           </annotationProcessorPaths>
         </configuration>
@@ -619,6 +639,9 @@
         <artifactId>maven-surefire-plugin</artifactId>
         <configuration>
           <argLine>@{jacoco.surefire.argLine} ${surefire.argLine}</argLine>
+          <systemPropertyVariables>
+            <test.projectArtifactId>${project.artifactId}</test.projectArtifactId>
+          </systemPropertyVariables>
         </configuration>
         <executions>
           <execution>
@@ -636,7 +659,7 @@
       <!--
       This plugin is used to generate AOT metadata during tests so that it can be
       compared against those in META-INF/native-image/org.kohsuke/github-api/*.
-      The tests are start with the name "Aot..." 
+      The tests are start with the name "Aot..."
       -->
       <plugin>
         <groupId>org.springframework.boot</groupId>
@@ -799,6 +822,42 @@
         </plugins>
       </build>
     </profile>
+    <profile>
+      <id>bridged</id>
+      <properties>
+        <!-- Only fail code coverage on non-windows machines -->
+        <github-api.artifactId>github-api-bridged</github-api.artifactId>
+      </properties>
+      <build>
+        <plugins>
+          <plugin>
+            <groupId>com.infradna.tool</groupId>
+            <artifactId>bridge-method-injector</artifactId>
+          </plugin>
+          <plugin>
+            <artifactId>maven-resources-plugin</artifactId>
+            <executions>
+              <execution>
+                <id>copy-bridged-resources</id>
+                <goals>
+                  <goal>copy-resources</goal>
+                </goals>
+                <!-- here the phase you need -->
+                <phase>validate</phase>
+                <configuration>
+                  <outputDirectory>${basedir}/target/classes/META-INF/native-image/org.kohsuke/${github-api.artifactId}</outputDirectory>
+                  <resources>
+                    <resource>
+                      <directory>src/main/resources/META-INF/native-image/org.kohsuke/github-api</directory>
+                    </resource>
+                  </resources>
+                </configuration>
+              </execution>
+            </executions>
+          </plugin>
+        </plugins>
+      </build>
+    </profile>
     <profile>
       <id>ci-non-windows</id>
       <activation>

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

@@ -5,6 +5,7 @@
 
 import java.io.IOException;
 import java.net.URL;
+import java.time.Instant;
 import java.util.Collections;
 import java.util.Date;
 import java.util.List;
@@ -145,7 +146,7 @@ public PagedIterable<GHAppInstallationRequest> listInstallationRequests() {
      * @see <a href="https://developer.github.com/v3/apps/#list-installations">List installations</a>
      */
     public PagedIterable<GHAppInstallation> listInstallations() {
-        return listInstallations(null);
+        return listInstallations(GitHubClient.toInstantOrNull(null));
     }
 
     /**
@@ -157,11 +158,27 @@ public PagedIterable<GHAppInstallation> listInstallations() {
      *            - Allows users to get installations that have been updated since a given date.
      * @return a list of App installations since a given time.
      * @see <a href="https://developer.github.com/v3/apps/#list-installations">List installations</a>
+     * @deprecated use {@link #listInstallations(Instant)}
      */
+    @Deprecated
     public PagedIterable<GHAppInstallation> listInstallations(final Date since) {
+        return listInstallations(since.toInstant());
+    }
+
+    /**
+     * Obtains all the installations associated with this app since a given date.
+     * <p>
+     * You must use a JWT to access this endpoint.
+     *
+     * @param since
+     *            - Allows users to get installations that have been updated since a given date.
+     * @return a list of App installations since a given time.
+     * @see <a href="https://developer.github.com/v3/apps/#list-installations">List installations</a>
+     */
+    public PagedIterable<GHAppInstallation> listInstallations(final Instant since) {
         Requester requester = root().createRequest().withUrlPath("/app/installations");
         if (since != null) {
-            requester.with("since", GitHubClient.printDate(since));
+            requester.with("since", GitHubClient.printInstant(since));
         }
         return requester.toIterable(GHAppInstallation[].class, null);
     }

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

@@ -1,11 +1,13 @@
 package org.kohsuke.github;
 
 import com.fasterxml.jackson.annotation.JsonProperty;
+import com.infradna.tool.bridge_method_injector.WithBridgeMethods;
 import edu.umd.cs.findbugs.annotations.SuppressFBWarnings;
 import org.kohsuke.github.internal.EnumUtils;
 
 import java.io.IOException;
 import java.net.URL;
+import java.time.Instant;
 import java.util.Collections;
 import java.util.Date;
 import java.util.List;
@@ -189,8 +191,9 @@ public GHRepositorySelection getRepositorySelection() {
      *
      * @return the suspended at
      */
-    public Date getSuspendedAt() {
-        return GitHubClient.parseDate(suspendedAt);
+    @WithBridgeMethods(value = Date.class, adapterMethod = "instantToDate")
+    public Instant getSuspendedAt() {
+        return GitHubClient.parseInstant(suspendedAt);
     }
 
     /**

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

@@ -1,5 +1,8 @@
 package org.kohsuke.github;
 
+import com.infradna.tool.bridge_method_injector.WithBridgeMethods;
+
+import java.time.Instant;
 import java.util.*;
 
 // TODO: Auto-generated Javadoc
@@ -66,7 +69,8 @@ public GHRepositorySelection getRepositorySelection() {
      *
      * @return date when this token expires
      */
-    public Date getExpiresAt() {
-        return GitHubClient.parseDate(expires_at);
+    @WithBridgeMethods(value = Date.class, adapterMethod = "instantToDate")
+    public Instant getExpiresAt() {
+        return GitHubClient.parseInstant(expires_at);
     }
 }

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

@@ -1,12 +1,14 @@
 package org.kohsuke.github;
 
 import com.fasterxml.jackson.annotation.JsonIgnore;
+import com.infradna.tool.bridge_method_injector.WithBridgeMethods;
 import edu.umd.cs.findbugs.annotations.SuppressFBWarnings;
 import org.apache.commons.lang3.StringUtils;
 import org.kohsuke.github.function.InputStreamFunction;
 
 import java.io.IOException;
 import java.net.URL;
+import java.time.Instant;
 import java.util.Date;
 import java.util.Objects;
 
@@ -77,8 +79,9 @@ public boolean isExpired() {
      *
      * @return the date of expiration
      */
-    public Date getExpiresAt() {
-        return GitHubClient.parseDate(expiresAt);
+    @WithBridgeMethods(value = Date.class, adapterMethod = "instantToDate")
+    public Instant getExpiresAt() {
+        return GitHubClient.parseInstant(expiresAt);
     }
 
     /**