Skip to content

fix: unblock Java releases and replace the stale README - #1

Merged
Loschcode merged 2 commits into
mainfrom
docs/readme-generated-methods
Oct 10, 2026
Merged

Loschcode merged 2 commits into
mainfrom
docs/readme-generated-methods

Conversation

@Loschcode

Copy link
Copy Markdown
Contributor

Release runs fail at Build with Maven: the spec gained an OAuth2 security scheme so the generated code imports org.apache.oltu.oauth2, which the hand-kept pom.xml never declared. Maven Central is stuck on 1.144.0.

  • pom.xml declares org.apache.oltu.oauth2.client 1.0.2 (the generator's own version); pom url is the homepage
  • src regenerated from the live spec with generator 7.21.0 (openapitools.json) so main builds like the release will; OPENAPI_VERSION and pom stay 1.144.0 so the next dispatch still publishes
  • README was a frozen 1.43.0 generator README importing org.openapitools.client.*; replaced with a short hand README using com.linkbreakers and linksServiceCreate/linksServiceGet
  • scripts/check-docs.sh compiles every README Java block against the built SDK, on PRs and in the release workflow
  • generator gets real git ids (git_push.sh placeholders)

🤖 Generated with Claude Code

Loschcode and others added 2 commits October 10, 2026 22:41
Every release since 1.144.0 failed at "Build with Maven": the API spec gained
an OAuth2 security scheme, so the generated ApiClient and OAuthOkHttpClient
import org.apache.oltu.oauth2, but the hand-kept pom.xml (restored over the
generated one each run) never declared it. Maven Central stayed on 1.144.0.

pom.xml now declares org.apache.oltu.oauth2.client 1.0.2, the version the
generator's own pom uses. The source is regenerated from the current spec with
generator 7.21.0 (the version in openapitools.json) so main builds as the
release will; OPENAPI_VERSION and the pom version stay at 1.144.0, so the next
dispatch still sees a new API version, regenerates and publishes. The
generator also gets the real git ids, which replaces the GIT_USER_ID and
GIT_REPO_ID placeholders in git_push.sh, and the pom <url> is the homepage.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The README was a frozen OpenAPI Generator README from API 1.43.0: it imported
org.openapitools.client.* (the packages are com.linkbreakers.*), pinned
version 1.43.0, and listed endpoints linking to docs/ files that are never
generated. It is now a short hand-written README whose example creates and
reads a link with the generated LinksApi methods.

scripts/check-docs.sh compiles every Java block in it against the built SDK.
It runs on pull requests and in the release workflow after the Maven build.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@Loschcode
Loschcode merged commit c4df7b2 into main Oct 10, 2026
3 checks passed
@Loschcode
Loschcode deleted the docs/readme-generated-methods branch October 10, 2026 19:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant