ORAS Go library
Project status
Versioning
The ORAS Go library follows Semantic Versioning, where breaking changes are reserved for MAJOR releases, and MINOR and PATCH releases must be 100% backwards compatible.
v2: stable
The version 2 is actively developed in the main branch with all new features.
Examples for common use cases can be found below:
If you are seeking latest changes, you should use the main branch (or a specific commit hash) over a tagged version when including the ORAS Go library in your project's go.mod.
The Go Reference for the main branch is available here.
To migrate from v1 to v2, see MIGRATION_GUIDE.md.
v1: stable
As there are various stable projects depending on the ORAS Go library v1, the
v1 branch
is maintained for API stability, dependency updates, and security patches.
All v1.* releases are based upon this branch.
Since v1 is in a maintenance state, you are highly encouraged
to use releases with major version 2 for new features.
Docs
- oras.land/client_libraries/go: Documentation for the ORAS Go library
- Reviewing guide: All reviewers must read the reviewing guide and agree to follow the project review guidelines.
Code of Conduct
This project has adopted the CNCF Code of Conduct. See CODE_OF_CONDUCT.md for further details.