https://github.com/docker/go-imageinspect
https://github.com/docker/go-imageinspect
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/docker/go-imageinspect
- Owner: docker
- License: apache-2.0
- Created: 2022-07-28T03:02:28.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-06-18T00:37:21.000Z (over 1 year ago)
- Last Synced: 2025-04-05T22:41:07.504Z (9 months ago)
- Language: Go
- Size: 119 KB
- Stars: 16
- Watchers: 5
- Forks: 2
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# go-imageinspect
[](https://github.com/docker/go-imageinspect/actions?query=workflow%3Aci)
Go library for accessing container images with their associated objects and
typed metadata.
## Experimental :test_tube:
This repository is considered **EXPERIMENTAL** and under active development
until further notice. It is subject to non-backward compatible changes or
removal in any future version.
## Rationale
Image authors are increasingly distributing associated metadata and artifacts
alongside their images, such as OCI annotations, SLSA Provenance, SBOMs,
signatures, and more. The exact method of storage can differ across the
ecosystem, making this information difficult to consume.
This library provides a unified interface for accessing this metadata and
ensuring that it can be consumed consistently.
## Support
This library supports pulling metadata from the following formats:
- [BuildKit attestations](https://github.com/moby/buildkit/blob/master/docs/attestations/attestation-storage.md)
## Usage
go-imageinspect is intended to be used as a library. However, for development
purposes, a simple command line tool is provided for prototyping:
```console
$ docker buildx bake bin
$ ./bin/imageinspect moby/buildkit:latest
```
## Contributing
Want to contribute? Awesome! You can find information about contributing to
this project in the [CONTRIBUTING.md](/.github/CONTRIBUTING.md)