Skip to content

v2026.3.10.0

Choose a tag to compare

@github-actions github-actions released this 07 Nov 11:29
7cc97e3

First release of github-sdk, an immutable object layer over github-rest-client: you work with Repository, Issue, PullRequest and similar objects instead of building client calls by hand. It is new and not yet proven in production. Smoke-tested against the live GitHub API, and covers REST only.

✨ What's new

  • Entry point: GitHubSdk.of(client) wraps a GitHubClient. Authentication, the GitHub product (github.com, Enterprise Cloud, Enterprise Server) and limits stay on the client; the SDK has no configuration of its own.
  • Immutable objects: every object keeps the response it was built from (response()), returns GitHub's answer from each change instead of a local copy, and reloads on request with refresh().
  • Optional lookups: looking up something that may not exist returns an empty Optional on 404.
  • Lazy lists: listings are single-use streams that fetch pages as you read them, so limit(10) stops after the first page.
  • Builders for changes: edits go through update() builders.
  • Repositories: create, update, archive, transfer, fork, star and watch; topics, languages, collaborators and invitations, webhooks, deploy keys and Pages.
  • Code: branches and branch protection, rulesets, commits, comparisons, files, multi-file commits, refs, tags, releases and their assets, README.
  • Issues and pull requests: issues, comments, labels, milestones, reactions, events, sub-issues and dependencies; pull requests, reviews, review comments and merging.
  • Actions and CI: workflows, runs, jobs, artifacts, variables, caches, self-hosted runners, check runs, commit statuses, deployments and environments.
  • Security: Dependabot, secret scanning and code scanning alerts, code quality, security advisories, dependency graph and SBOM, interaction limits.
  • People and organizations: users, the signed-in account, organizations, teams, members and invitations, SSH, GPG and signing keys, notifications and gists.
  • Projects and packages: Projects v2 (read and edit items and fields) and GitHub Packages.
  • Platform: search, rate limit, events, GitHub Apps and Marketplace, licenses and Markdown rendering.

🔧 Improvements

  • Requires Java 21. Ships as the module io.github.piotr_janczukowicz.githubsdk and also works on the class path.
  • Depends only on github-rest-client (built against 2026.3.10.5). The version follows the OpenAPI version of the client.

Not covered

Copilot, codespaces, billing, Enterprise Server administration, and anything that needs GraphQL such as discussions. Use github-rest-client directly for the REST ones.

Full Changelog: https://github.com/piotr-janczukowicz/github-sdk/commits/v2026.3.10.0