v2.0.0-alpha-1 🌈

[bitwiseman]

Major version bump to v2.x

I would love for github-api v2.x to be a larger change that has major new features.

However, the most pressing need is clearing technical debt for better stability and ease of adding new features. These changes break binary compatibility requiring a major version bump.

v2.0 includes:

• Drop support for Java 8
• Remove functional dependencies on HttpURLConnection
• Remove most deprecated classes and methods
• Remove all "bridge methods"

Changes

• Prepare release (bitwiseman): github-api-2.0.0-alpha-1 @bitwiseman (Prepare release (bitwiseman): github-api-2.0.0-alpha-1 #1936)
• Begin 2.x release train @bitwiseman (Begin 2.x release train #1935)
• Prepare release (bitwiseman): github-api-1.325 @github-actions (Prepare release (bitwiseman): github-api-1.325 #1932)

---

This discussion was created from the release v2.0.0-alpha-1 🌈.

[bitwiseman]

@gsmet @ihrigb @mestebangutierrez @tginiotis-at-work @kgromov @MarkEWaite @alecharp
Any feedback you can provide would be appreciated.

[gsmet]

@bitwiseman yeah I need to have a look and try to port the Quarkus extension and Quarkus GitHub App to this new version. It's on my TODO list for soonish.

[bitwiseman]

@ihrigb
Filed as #1957

[gsmet]

@bitwiseman I was finally able to do some testing. From my perspective, it's all good: I ported Quarkus GitHub API and Quarkus GitHub App to it with only very minor changes and tested our GitHub bot both in JVM mode and native.

Only one thing comes to mind: it seems you dropped the unbridged artifact? I think you should reinstate it even if for now you don't have bridges as you will add some at some point and they are going to be problematic again for Mockito users.

[gsmet]

Oh and also, it seems you didn't drop all the IOException that are extremely annoying when coding with the API. It has been one of my major complaint over time, as it's a bit painful to have to throw IOException everywhere.

In some cases, we even have IOException for methods that are definitely not throwing anything such as:

github-api/src/main/java/org/kohsuke/github/GHDiscussion.java

Lines 42 to 44 in 7150121

	public URL getHtmlUrl() throws IOException {
	return GitHubClient.parseURL(htmlUrl);
	}

I think we have a unique opportunity here to clean this up.

[gsmet]

BTW, I'm aware it's going to require app changes but really it's for the better and given we are doing a major, I think it's probably now or never. People who don't want to handle this in their apps can keep using the old version if they prefer.