https://github.com/anchore/stereoscope
go library for processing container images and simulating a squash filesystem
https://github.com/anchore/stereoscope
container container-image go golang hacktoberfest squashfs
Last synced: 5 months ago
JSON representation
go library for processing container images and simulating a squash filesystem
- Host: GitHub
- URL: https://github.com/anchore/stereoscope
- Owner: anchore
- License: apache-2.0
- Created: 2020-05-05T18:39:19.000Z (about 6 years ago)
- Default Branch: main
- Last Pushed: 2025-04-01T13:56:00.000Z (about 1 year ago)
- Last Synced: 2025-04-07T08:07:41.000Z (about 1 year ago)
- Topics: container, container-image, go, golang, hacktoberfest, squashfs
- Language: Go
- Homepage:
- Size: 1.08 MB
- Stars: 90
- Watchers: 12
- Forks: 50
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# stereoscope
A library for working with container image contents, layer file trees, and squashed file trees.
## Getting Started
See `examples/basic.go`
```bash
docker image save centos:8 -o centos.tar
go run examples/basic.go ./centos.tar
```
Note: To run tests you will need `skopeo` installed.
## Overview
This library provides the means to:
- parse and read images from multiple sources, supporting:
- docker V2 schema images from the docker daemon, podman, or archive
- OCI images from disk, directory, or registry
- singularity formatted image files
- build a file tree representing each layer blob
- create a squashed file tree representation for each layer
- search one or more file trees for selected paths
- catalog file metadata in all layers
- query the underlying image tar for content (file content within a layer)