Repository navigation
v2026.3.10.0
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 aGitHubClient. 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 withrefresh(). Optionallookups: looking up something that may not exist returns an emptyOptionalon 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.githubsdkand also works on the class path. - Depends only on
github-rest-client(built against2026.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