registry

package

v0.1.1 Latest Latest Go to latest Published: Jun 27, 2026 License: MIT Imports: 11 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/jclement/pullpilot

Links

Open Source Insights

Documentation ¶

Overview ¶

Package registry resolves the current manifest digest for an image tag from its registry, using a cheap manifest HEAD and the standard bearer-token auth challenge flow. It never pulls image layers.

Index ¶

type Client
- func New() *Client
- func (c *Client) RemoteDigest(ctx context.Context, image string) (string, error)
type CredStore
- func (s *CredStore) Basic(host string) (string, string, bool)
type Ref
- func ParseRef(image string) (Ref, error)
- func (r Ref) Pinned() bool

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type Client ¶

type Client struct {
	// contains filtered or unexported fields
}

Client resolves remote digests.

func New ¶

func New() *Client

New returns a Client. If a Docker config.json is present (DOCKER_CONFIG or ~/.docker/config.json), its registry credentials are used; otherwise requests are anonymous.

func (*Client) RemoteDigest ¶

func (c *Client) RemoteDigest(ctx context.Context, image string) (string, error)

RemoteDigest returns the current manifest (or index) digest for the tag of the given image reference. For a digest-pinned reference it returns the pin.

type CredStore ¶

type CredStore struct {
	// contains filtered or unexported fields
}

CredStore holds registry credentials parsed from a Docker config.json.

func (*CredStore) Basic ¶

func (s *CredStore) Basic(host string) (string, string, bool)

Basic returns username/password for a registry host, if known.

type Ref ¶

type Ref struct {
	Registry   string // network host, e.g. registry-1.docker.io
	Repository string // e.g. library/nginx
	Tag        string // e.g. latest (empty if pinned by digest)
	Digest     string // sha256:… if the ref is pinned by digest
}

Ref is a parsed image reference.

func ParseRef ¶

func ParseRef(image string) (Ref, error)

ParseRef normalizes an image reference (adding docker.io/library and :latest as needed) and splits it into registry host, repository, tag and/or digest.

func (Ref) Pinned ¶

func (r Ref) Pinned() bool

Pinned reports whether the reference is pinned to an immutable digest.

Source Files ¶

View all Source files

registry.go

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL