image

Oct 11, 2026

Changes in this version

+ const MaxArchiveEntries

type AnalyzeOptions

+ Platform string

Oct 7, 2026

Changes in this version

type FileNode

+ Inferred bool

Aug 8, 2026

Changes in this version

type FileNode

+ EffectiveSize int64

Jul 16, 2026

Changes in this version

+ const MaxArchiveSize

+ const MaxMetadataSize

Jul 6, 2026

Changes in this version

type ErrDaemonNotRunning

+ Engine string

+ Host string

type Option

+ func WithEngineTag(name string) Option

+ func WithHostTag(host string) Option

Jun 24, 2026

Changes in this version

+ func FormatPlatform(p *ocispec.Platform) string

+ func ParsePlatform(s string) (*ocispec.Platform, error)

+ func PlatformsEqual(want, got *ocispec.Platform) bool

type Analysis

+ AggregatedTrees []*FileTree

type ArchiveResolver

+ func NewArchiveResolverWithPlatform(path string, p *ocispec.Platform) *ArchiveResolver

+ type ErrPlatformInvalid struct

+ Reason string

+ Spec string

+ func (e *ErrPlatformInvalid) Error() string

+ type ErrPlatformNotInImage struct

+ Available []string

+ Ref string

+ Requested string

+ func (e *ErrPlatformNotInImage) Error() string

type FileTree

+ func BuildAggregatedTrees(layers []Layer) []*FileTree

type Option

+ func WithPlatform(p *ocispec.Platform) Option

Jun 6, 2026

Changes in this version

+ type CacheEntry struct

+ CachedAt time.Time

+ Digest string

+ ImageRef string

+ Size int64

+ func ListCache(root string) ([]CacheEntry, []string, error)

+ type ErrNoEngineFound struct

+ Tried []string

+ func (e *ErrNoEngineFound) Error() string

+ type ErrPodmanSocketNotSet struct

+ Platform string

+ func (e *ErrPodmanSocketNotSet) Error() string

+ type PruneOptions struct

+ All bool

+ DryRun bool

+ Keep string

+ MaxBytes int64

+ Now func() time.Time

+ TTL time.Duration

+ type PruneResult struct

+ Kept []CacheEntry

+ Removed []CacheEntry

+ Warnings []string

+ func PruneCache(root string, opts PruneOptions) (PruneResult, error)

type Resolver

+ func NewDockerResolverWithHost(host string, opts ...Option) (Resolver, error)

May 30, 2026

Changes in this version

+ const MaxLayerBlobSize

+ func IsWhiteoutName(name string) bool

+ type CompareResult struct

+ After ImageSummary

+ AfterEfficiency EfficiencySummary

+ Before ImageSummary

+ BeforeEfficiency EfficiencySummary

+ FileDiffs []FileDiff

+ FileSummary FileDiffSummary

+ LayerDiffs []LayerDiff

+ Warnings []string

+ WasteDiffs []WasteDiff

+ func CompareAnalysis(before, after *Analysis) *CompareResult

+ func (r *CompareResult) IsRegression() bool

+ func (r *CompareResult) RegressionReasons() []string

type EfficiencyResult

+ func EfficiencyFromAnalysis(a *Analysis) *EfficiencyResult

+ type EfficiencySummary struct

+ Score float64

+ ScoreDelta float64

+ ScoreDeltaPercent float64

+ WastedBytes int64

+ WastedBytesDelta int64

+ WastedBytesPercent float64

+ type FileDiff struct

+ AfterSize int64

+ BeforeSize int64

+ ChangeReason string

+ DiffType DiffType

+ Path string

+ SizeDelta int64

+ type FileDiffSummary struct

+ AddedCount int

+ BytesAdded int64

+ BytesRemoved int64

+ ModifiedCount int

+ RemovedCount int

+ type ImageSummary struct

+ ImageRef string

+ LayerCount int

+ TotalSize int64

+ type LayerDiff struct

+ AfterCommand string

+ AfterNetDelta int64

+ AfterSize int64

+ BeforeCommand string

+ BeforeNetDelta int64

+ BeforeSize int64

+ CommandsMatch bool

+ Index int

+ NetDeltaDiff int64

+ SizeDelta int64

+ type WasteDiff struct

+ AfterWasted int64

+ BeforeWasted int64

+ Path string

+ WastedDelta int64

May 28, 2026

Changes in this version

+ type ArchiveExtractor struct

+ func (e *ArchiveExtractor) Extract(ctx context.Context, imageRef string, filePath string) (*FileContent, error)

+ func (e *ArchiveExtractor) ExtractFromLayer(ctx context.Context, imageRef string, filePath string, layerCursor int) (*FileContent, error)

+ func (e *ArchiveExtractor) ExtractRaw(ctx context.Context, imageRef string, filePath string) ([]byte, error)

+ func (e *ArchiveExtractor) ExtractRawFromLayer(ctx context.Context, imageRef string, filePath string, layerCursor int) ([]byte, error)

+ type ArchiveResolver struct

+ func NewArchiveResolver(path string) *ArchiveResolver

+ func (r *ArchiveResolver) ImageID(ctx context.Context, imageRef string) (string, error)

+ func (r *ArchiveResolver) Inspect(ctx context.Context, imageRef string) (*ImageMeta, error)

+ func (r *ArchiveResolver) NewExtractor() Extractor

+ func (r *ArchiveResolver) Resolve(ctx context.Context, imageRef string) ([]Layer, error)

+ func (r *ArchiveResolver) ResolveWithProgress(ctx context.Context, imageRef string, progress chan<- ProgressEvent) ([]Layer, error)

+ type ErrArchiveInfra struct

+ Cause error

+ Op string

+ func (e *ErrArchiveInfra) Error() string

+ func (e *ErrArchiveInfra) Unwrap() error

+ type ErrArchiveNotFound struct

+ Cause error

+ Path string

+ func (e *ErrArchiveNotFound) Error() string

+ func (e *ErrArchiveNotFound) Unwrap() error

+ type ErrArchivePermission struct

+ Cause error

+ Path string

+ func (e *ErrArchivePermission) Error() string

+ func (e *ErrArchivePermission) Unwrap() error

+ type ErrInvalidArchive struct

+ Cause error

+ Path string

+ func (e *ErrInvalidArchive) Error() string

+ func (e *ErrInvalidArchive) Unwrap() error

May 26, 2026

Changes in this version

+ const MaxSaveSize

type FileNode

+ IsHardlink bool

+ Linkname string

May 24, 2026

Changes in this version

type DockerExtractor

+ func (e *DockerExtractor) ExtractFromLayer(ctx context.Context, imageRef string, filePath string, layerCursor int) (*FileContent, error)

+ func (e *DockerExtractor) ExtractRawFromLayer(ctx context.Context, imageRef string, filePath string, layerCursor int) ([]byte, error)

type Extractor

+ ExtractFromLayer func(ctx context.Context, imageRef string, filePath string, layerCursor int) (*FileContent, error)

+ ExtractRawFromLayer func(ctx context.Context, imageRef string, filePath string, layerCursor int) ([]byte, error)

May 23, 2026

Changes in this version

+ const SchemaVersion

+ func CacheDir() (string, error)

type Analysis

+ func AnalyzeWithOptions(ctx context.Context, resolver Resolver, imageRef string, opts AnalyzeOptions) (*Analysis, error)

+ type AnalyzeOptions struct

+ CacheRoot string

+ NoCache bool

+ Progress chan<- ProgressEvent

type DockerResolver

+ func (r *DockerResolver) ImageID(ctx context.Context, imageRef string) (string, error)

type ProgressEvent

+ Message string

type ProgressPhase

+ const PhaseCacheLoad

+ const PhaseCacheWarn

+ const PhaseUnknown

type Resolver

+ ImageID func(ctx context.Context, imageRef string) (string, error)

May 21, 2026

Changes in this version

+ const MaxViewSize

+ func FormatBytes(b int64) string

+ func FormatMode(m fs.FileMode) string

+ func FormatSignedBytes(b int64) string

+ func IsBinary(data []byte) bool

+ func TreeLiveFileBytes(tree *FileTree) int64

+ type Analysis struct

+ ImageRef string

+ Layers []Layer

+ StackedTrees []*FileTree

+ TotalSize int64

+ func Analyze(ctx context.Context, resolver Resolver, imageRef string) (*Analysis, error)

+ func AnalyzeWithProgress(ctx context.Context, resolver Resolver, imageRef string, ...) (*Analysis, error)

+ type DiffType int

+ const Added

+ const Modified

+ const Removed

+ const Unchanged

+ type DockerExtractor struct

+ func NewDockerExtractor(cli client.APIClient) *DockerExtractor

+ func (e *DockerExtractor) Extract(ctx context.Context, imageRef string, filePath string) (*FileContent, error)

+ func (e *DockerExtractor) ExtractRaw(ctx context.Context, imageRef string, filePath string) ([]byte, error)

+ type DockerResolver struct

+ func (r *DockerResolver) Inspect(ctx context.Context, imageRef string) (*ImageMeta, error)

+ func (r *DockerResolver) NewExtractor() Extractor

+ func (r *DockerResolver) Resolve(ctx context.Context, imageRef string) ([]Layer, error)

+ func (r *DockerResolver) ResolveWithProgress(ctx context.Context, imageRef string, progress chan<- ProgressEvent) ([]Layer, error)

+ type EfficiencyResult struct

+ Score float64

+ WastedBytes int64

+ WastedFiles []WastedFile

+ func Efficiency(layers []Layer) *EfficiencyResult

+ type ErrDaemonNotRunning struct

+ Cause error

+ func (e *ErrDaemonNotRunning) Error() string

+ func (e *ErrDaemonNotRunning) Unwrap() error

+ type ErrImageNotFound struct

+ Cause error

+ Ref string

+ func (e *ErrImageNotFound) Error() string

+ func (e *ErrImageNotFound) Unwrap() error

+ type ErrPullFailed struct

+ Cause error

+ Ref string

+ func (e *ErrPullFailed) Error() string

+ func (e *ErrPullFailed) Unwrap() error

+ type Extractor interface

+ Extract func(ctx context.Context, imageRef string, filePath string) (*FileContent, error)

+ ExtractRaw func(ctx context.Context, imageRef string, filePath string) ([]byte, error)

+ type ExtractorSource interface

+ NewExtractor func() Extractor

+ type FileContent struct

+ Binary bool

+ Data []byte

+ Path string

+ Size int64

+ Truncated bool

+ type FileNode struct

+ Children []*FileNode

+ DiffType DiffType

+ GID int

+ IntroducedInLayer int

+ IsDir bool

+ Mode fs.FileMode

+ Name string

+ Path string

+ Size int64

+ UID int

+ func (n *FileNode) AddChild(child *FileNode)

+ func (n *FileNode) FindChild(name string) *FileNode

+ func (n *FileNode) RemoveChild(name string) bool

+ type FileTree struct

+ Root *FileNode

+ func NewFileTree() *FileTree

+ func ParseLayerTar(r io.Reader) (*FileTree, error)

+ func Stack(layers []Layer) []*FileTree

+ func (t *FileTree) Walk(fn func(*FileNode))

+ type ImageMeta struct

+ Size int64

+ type Layer struct

+ Command string

+ ID string

+ Index int

+ NetDelta int64

+ Size int64

+ Tree *FileTree

+ type Option func(*DockerResolver)

+ func WithClient(cli client.APIClient) Option

+ type ProgressEvent struct

+ BytesCurr int64

+ BytesTotal int64

+ LayersDone int

+ LayersTotal int

+ Phase ProgressPhase

+ type ProgressPhase int

+ const PhaseExporting

+ const PhaseParsing

+ const PhasePulling

+ type Resolver interface

+ Inspect func(ctx context.Context, imageRef string) (*ImageMeta, error)

+ Resolve func(ctx context.Context, imageRef string) ([]Layer, error)

+ ResolveWithProgress func(ctx context.Context, imageRef string, progress chan<- ProgressEvent) ([]Layer, error)

+ func NewDockerResolver(opts ...Option) (Resolver, error)

+ type WastedFile struct

+ LayerCount int

+ Path string

+ TotalWasted int64