Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

git

package

Go to main page

Versions in this module

v1

v1.18.0

Sep 14, 2026

Changes in this version

type Deletion

+ SLOUsesOrigin bool

type Snapshot

+ SLOUsesOriginByIdentifier map[string]bool

v1.17.0

Aug 27, 2026

Changes in this version

+ const AllZerosSHA

+ var ErrRefNotFound = errors.New("git ref not found")

+ func IsNotAGitRepository(err error) bool

+ type AlertDeletion struct

+ CRDIdentifier string

+ type Deletion struct

+ Identifier string

+ Kind string

+ Path string

+ PrometheusAlerts []asset.PrometheusAlertName

+ SpamFilterUsesOrigin bool

+ type DeletionPlan struct

+ AlertsByName []AlertDeletion

+ ByIdentifier []Deletion

+ NoIdentifier []string

+ func Diff(before, after Snapshot) DeletionPlan

+ func (p DeletionPlan) IsEmpty() bool

+ type IdentifierKey struct

+ Identifier string

+ Kind string

+ type NoIdentifierDoc struct

+ FilePath string

+ Kind string

+ type RefState string

+ const RefAllZeros

+ const RefEmpty

+ const RefResolvedAncestor

+ const RefResolvedNonAncestor

+ const RefUnresolvable

+ type Repo struct

+ Dir string

+ func (r Repo) ClassifyRef(ctx context.Context, ref string) (state RefState, resolvedSHA string, err error)

+ func (r Repo) ExplainUnresolvableRef(ctx context.Context, ref string) string

+ func (r Repo) HasSkipWorktreeFiles(ctx context.Context, scope string) (bool, error)

+ func (r Repo) IsAncestor(ctx context.Context, ancestor, descendant string) (bool, error)

+ func (r Repo) IsTreeAtRef(ctx context.Context, ref, path string) (bool, error)

+ func (r Repo) ListYAMLFilesAtRef(ctx context.Context, ref, scope string) ([]string, error)

+ func (r Repo) ReadFileAtRef(ctx context.Context, ref, path string) ([]byte, error)

+ func (r Repo) Root(ctx context.Context) (string, error)

+ type Snapshot struct

+ Identifiers map[IdentifierKey]string

+ NoIdentifier map[string]NoIdentifierDoc

+ Paths map[string]bool

+ PrometheusAlertsByIdentifier map[string][]asset.PrometheusAlertName

+ PrometheusRecordingRoleByIdentifier map[string]bool

+ RawContent map[string][]byte

+ SpamFilterUsesOriginByIdentifier map[string]bool

+ func BuildSnapshotFromDisk(ctx context.Context, scope, repoRoot string) (Snapshot, error)

+ func BuildSnapshotFromRef(ctx context.Context, repo Repo, ref, scope string) (Snapshot, error)