gitutil

Sep 30, 2025

Changes in this version

+ var ErrBadPattern = path.ErrBadPattern

type GitCLI

+ func (cli *GitCLI) LsRemote(ctx context.Context, remote string) (*Remote, error)

+ type Ref struct

+ Name string

+ SHA string

+ func (r *Ref) Digest() digest.Digest

+ func (r *Ref) ShortName() string

+ type Remote struct

+ Head *Ref

+ Refs []*Ref

+ Symrefs map[string]string

+ func (remote *Remote) Branches() *Remote

+ func (remote *Remote) Digest() digest.Digest

+ func (remote *Remote) Filter(patterns []string) *Remote

+ func (remote *Remote) Get(name string) (result *Ref)

+ func (remote *Remote) Lookup(target string) (result *Ref, _ error)

+ func (remote *Remote) ShortNames() []string

+ func (remote *Remote) Tags() *Remote

Sep 4, 2025

Changes in this version

+ var ErrGitAuthFailed = errors.New("git authentication failed")

+ var ErrGitNoRepo = errors.New("not a git repository")

+ var ErrShallowNotSupported = errors.New("shallow clone not supported")

+ func MergeGitConfigEnv(env []string, entries map[string]string) []string

type Option

+ func WithConfig(entries map[string]string) Option

+ func WithHTTPAuthorizationHeader(remote *GitURL, header string) Option

+ func WithHTTPTokenAuth(remote *GitURL, token, username string) Option

Aug 18, 2025

Changes in this version

type GitCLI

+ func (cli *GitCLI) URL(ctx context.Context) (string, error)

May 6, 2025

Changes in this version

type Option

+ func WithIgnoreError() Option

Apr 25, 2025

Changes in this version

+ const GitProtocol

+ const HTTPProtocol

+ const HTTPSProtocol

+ const InstrumentationLibrary

+ const SSHProtocol

+ var ErrInvalidProtocol = errors.New("invalid protocol")

+ var ErrUnknownProtocol = errors.New("unknown protocol")

+ func IsCommitSHA(str string) bool

+ func IsGitTransport(remote string) bool

+ func Tracer(ctx context.Context) trace.Tracer

+ type GitCLI struct

+ func NewGitCLI(opts ...Option) *GitCLI

+ func (cli *GitCLI) Dir() string

+ func (cli *GitCLI) GitDir(ctx context.Context) (string, error)

+ func (cli *GitCLI) New(opts ...Option) *GitCLI

+ func (cli *GitCLI) Run(ctx context.Context, args ...string) (_ []byte, rerr error)

+ func (cli *GitCLI) WorkTree(ctx context.Context) (string, error)

+ type GitURL struct

+ Fragment *GitURLFragment

+ Host string

+ Path string

+ Scheme string

+ User *url.Userinfo

+ func ParseURL(remote string) (*GitURL, error)

+ func (gitURL *GitURL) Remote() string

+ func (gitURL *GitURL) String() string

+ type GitURLFragment struct

+ Ref string

+ Subdir string

+ func (fragment *GitURLFragment) String() string

+ type Option func(b *GitCLI)

+ func WithArgs(args ...string) Option

+ func WithDir(dir string) Option

+ func WithExec(exec func(context.Context, *exec.Cmd) error) Option

+ func WithGitBinary(path string) Option

+ func WithGitDir(gitDir string) Option

+ func WithSSHAuthSock(sshAuthSock string) Option

+ func WithSSHKnownHosts(sshKnownHosts string) Option

+ func WithStreams(streams StreamFunc) Option

+ func WithWorkTree(workTree string) Option

+ type StreamFunc func(context.Context) (io.WriteCloser, io.WriteCloser, func())