v2.5.0

Tip

Upgrade to v2.5.0 for optimal performance when compiled with Go 1.22 or later.

Warning

v2.5.0 does not compile with Go 1.20.x or earlier.

New Features

• Upgrade to image-spec v1.1.0 and distributio-spec v1.1.0
  • Introduce oras.PackManifestVersion1_1 for packing OCI Image Manifest defined in image-spec v1.1.0

Deprecation

• oras.PackManifestVersion1_1_RC4 is deprecated and not recommended for future use. Use oras.PackManifestVersion1_1 instead.

Bug Fixes

• Fix #698: registry.ParseReference returns false positive when registry is empty
• Fix #727: Subsequent calls to credentials.DynamicStore.Put will not set the detected credential store after the first failed attempt
• Fix #730: file.Store has race conditions when restoring content with the same name

Other Changes

• Update the Go support window to [1.21, 1.22]
• Update unit tests and examples
• Improve performance

Detailed Commits

• build(deps): bump github.com/opencontainers/image-spec from 1.1.0-rc6 to 1.1.0 by @dependabot in #708
• feat: upgrade to distribution-spec v1.1.0 by @wangxiaoxuan273 in #720
• build: bump go version by @dextrot in #715
• test: add a new case for UnwrapNopCloser by @shizhMSFT in #725
• perf: use new built-in methods introduced before go 1.22 by @shizhMSFT in #726
• fix: check empty registry name by @shizhMSFT in #729
• fix(DynamicStore): retry setCredsStore on next PUT by @shizhMSFT in #728
• fix(file.Store): fix race condition on restoring the same named content by @shizhMSFT in #731

New Contributors

• @dextrot made their first contribution in #715

Full Changelog: v2.4.0...v2.5.0