gitclone

package

v0.1.3 Latest Latest Go to latest Published: Oct 10, 2026 License: MIT Imports: 9 Imported by: 0

Details

Package gitclone provides pinned local checkouts backed by git-pkgs/clone.

This section is empty.

This section is empty.

func DefaultContextCacheDir(workDir, repoID string) string

DefaultContextCacheDir returns a sibling cache directory for a work tree.

type Client struct {
	Cred auth.Credential
	// contains filtered or unexported fields
}

Client materializes exact commit SHAs into local directories.

func (c *Client) EnsureCheckout(ctx context.Context, remoteURL, dst, targetSHA string) error

EnsureCheckout clones or updates dst to targetSHA (full commit or prefix).

func (c *Client) Head(ctx context.Context, dst string) (string, error)

Head returns the current commit at dst.

func (c *Client) ResolveBranchHead(ctx context.Context, remoteURL, branch string) (string, error)

ResolveBranchHead resolves a remote branch to an immutable commit SHA.

type HeadDriftError struct {
	Expected    string
	Observed    string
	Destination string
}

HeadDriftError reports checkout verification failure.

func (e *HeadDriftError) Error() string