gitindex

Documentation

Overview

Package gitindex provides functions for indexing Git repositories.

Index

• func CloneRepo(destDir, name, cloneURL string, settings map[string]string) (string, error)
• func FindGitRepos(dir string) ([]string, error)
• func IndexGitRepo(opts Options) error
• func ListRepos(baseDir string, u *url.URL) ([]string, error)
• func ParseGitModules(content []byte) (map[string]*SubmoduleEntry, error)
• func Path(baseDir string, name string) string
• func RepoModTime(dir string) (time.Time, error)
• func SetTemplatesFromOrigin(desc *zoekt.Repository, u *url.URL) error
• func TreeToFiles(r *git.Repository, t *object.Tree, repoURL string, repoCache *RepoCache) (map[fileKey]BlobLocation, map[string]plumbing.Hash, error)
• type BlobLocation
  • func (l *BlobLocation) Blob(id *plumbing.Hash) ([]byte, error)
• type Filter
  • func NewFilter(includeRegex, excludeRegex string) (*Filter, error)
  • func (f *Filter) Include(name string) bool
• type Options
• type RepoCache
  • func NewRepoCache(dir string) *RepoCache
  • func (rc *RepoCache) Open(u *url.URL) (*git.Repository, error)
  • func (rc *RepoCache) Path(u *url.URL) string
• type SubmoduleEntry

Functions

func CloneRepo

func CloneRepo(destDir, name, cloneURL string, settings map[string]string) (string, error)

CloneRepo clones one repository, adding the given config settings. It returns the bare repo directory. The `name` argument determines where the repo is stored relative to `destDir`. Returns the directory of the repository.

func FindGitRepos

func FindGitRepos(dir string) ([]string, error)

FindGitRepos finds directories holding git repositories below the given directory. It will find both bare and the ".git" dirs in non-bare repositories. It returns the full path including the dir passed in.

func IndexGitRepo

func IndexGitRepo(opts Options) error

IndexGitRepo indexes the git repository as specified by the options.

func ListRepos

func ListRepos(baseDir string, u *url.URL) ([]string, error)

ListRepos returns paths to repos on disk that start with the given URL prefix. The paths are relative to baseDir, and typically include a ".git" suffix.

func ParseGitModules

func ParseGitModules(content []byte) (map[string]*SubmoduleEntry, error)

ParseGitModules parses the contents of a .gitmodules file.

func Path

func Path(baseDir string, name string) string

Path returns the absolute path of the bare repository.

func RepoModTime

func RepoModTime(dir string) (time.Time, error)

RepoModTime returns the time of last fetch of a git repository.

func SetTemplatesFromOrigin

func SetTemplatesFromOrigin(desc *zoekt.Repository, u *url.URL) error

SetTemplates fills in templates based on the origin URL.

func TreeToFiles

func TreeToFiles(r *git.Repository, t *object.Tree,
	repoURL string, repoCache *RepoCache) (map[fileKey]BlobLocation, map[string]plumbing.Hash, error)

TreeToFiles fetches the blob SHA1s for a tree. If repoCache is non-nil, recurse into submodules. In addition, it returns a mapping that indicates in which repo each SHA1 can be found.

Types

type BlobLocation

type BlobLocation struct {
	Repo *git.Repository
	URL  *url.URL
}

BlobLocation holds data where a blob can be found.

func (*BlobLocation) Blob

func (l *BlobLocation) Blob(id *plumbing.Hash) ([]byte, error)

type Filter

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

Filter is a include/exclude filter to be used for repo names.

func NewFilter

func NewFilter(includeRegex, excludeRegex string) (*Filter, error)

NewFilter creates a new filter.

func (*Filter) Include

func (f *Filter) Include(name string) bool

Include returns true if the name passes the filter.

type Options

type Options struct {
	// The repository to be indexed.
	RepoDir string

	// If set, follow submodule links. This requires RepoCacheDir to be set.
	Submodules bool

	// If set, skip indexing if the existing index shard is newer
	// than the refs in the repository.
	Incremental bool

	// Don't error out if some branch is missing
	AllowMissingBranch bool

	// Specifies the root of a Repository cache. Needed for submodule indexing.
	RepoCacheDir string

	// Indexing options.
	BuildOptions build.Options

	// Prefix of the branch to index, e.g. `remotes/origin`.
	BranchPrefix string

	// List of branch names to index, e.g. []string{"HEAD", "stable"}
	Branches []string
}

The Options structs controls details of the indexing process.

type RepoCache

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

RepoCache is a set of repositories on the file system, named and stored by URL.

func NewRepoCache

func NewRepoCache(dir string) *RepoCache

NewRepoCache creates a new RepoCache rooted at the given directory.

func (*RepoCache) Open

func (rc *RepoCache) Open(u *url.URL) (*git.Repository, error)

Open opens a git repository. The cache retains a pointer to the repository.

func (*RepoCache) Path

func (rc *RepoCache) Path(u *url.URL) string

type SubmoduleEntry

type SubmoduleEntry struct {
	Path   string
	URL    string
	Branch string
}

SubmoduleEntry represent one entry in a .gitmodules file