git

Documentation

Overview

This file mainly provides some functions that can be used to adapt for git downloading by go-getter.

Index

• Constants
• func Clone(repoURL string, tagName string, localPath string, writer io.Writer) (*git.Repository, error)
• func CloneWithOpts(opts ...CloneOption) (*git.Repository, error)
• func Fetch(dir string, args ...string) error
• func ForceProtocol(url, protocol string) string
• func GetAllGithubReleases(url string) ([]string, error)
• func IsGitBareRepo(dir string) bool
• type CloneOption
  • func WithBare(isBare bool) CloneOption
  • func WithBranch(branch string) CloneOption
  • func WithCommit(commit string) CloneOption
  • func WithLocalPath(localPath string) CloneOption
  • func WithRepoURL(repoURL string) CloneOption
  • func WithTag(tag string) CloneOption
  • func WithWriter(writer io.Writer) CloneOption
• type CloneOptions
  • func NewCloneOptions(repoUrl, commit, tag, branch, localpath string, Writer io.Writer) *CloneOptions
  • func (cloneOpts *CloneOptions) CheckoutFromBare() error
  • func (cloneOpts *CloneOptions) Clone() (*git.Repository, error)
  • func (cloneOpts *CloneOptions) ForceGitUrl() (string, error)
  • func (cloneOpts *CloneOptions) Validate() error
• type GitHubRelease

Constants

const GIT_PROTOCOL = "git::"

Functions

func Clone

func Clone(repoURL string, tagName string, localPath string, writer io.Writer) (*git.Repository, error)

Clone will clone from `repoURL` to `localPath` via git by tag name. Deprecated: This function will be removed in a future version. Use CloneWithOpts instead.

func CloneWithOpts

func CloneWithOpts(opts ...CloneOption) (*git.Repository, error)

CloneWithOpts will clone from `repoURL` to `localPath` via git by using CloneOptions

func Fetch

func Fetch(dir string, args ...string) error

Fetch fetches the latest changes from a remote repository

func ForceProtocol

func ForceProtocol(url, protocol string) string

func GetAllGithubReleases

func GetAllGithubReleases(url string) ([]string, error)

GetAllGithubReleases fetches all releases from a GitHub repository

func IsGitBareRepo

func IsGitBareRepo(dir string) bool

IsGitBareRepo checks if a directory is a bare git repository

Types

type CloneOption

type CloneOption func(*CloneOptions)

CloneOption is a function that modifies CloneOptions

func WithBare

func WithBare(isBare bool) CloneOption

WithBare sets the bare flag for CloneOptions

func WithBranch

func WithBranch(branch string) CloneOption

WithBranch sets the branch for CloneOptions

func WithCommit

func WithCommit(commit string) CloneOption

WithCommit sets the commit for CloneOptions

func WithLocalPath

func WithLocalPath(localPath string) CloneOption

WithLocalPath sets the local path for CloneOptions

func WithRepoURL

func WithRepoURL(repoURL string) CloneOption

WithRepoURL sets the repo URL for CloneOptions

func WithTag

func WithTag(tag string) CloneOption

WithTag sets the tag for CloneOptions

func WithWriter

func WithWriter(writer io.Writer) CloneOption

WithWriter sets the writer for CloneOptions

type CloneOptions

type CloneOptions struct {
	RepoURL   string
	Commit    string
	Tag       string
	Branch    string
	LocalPath string
	Writer    io.Writer
	Bare      bool // New field to indicate if the clone should be bare
}

CloneOptions is a struct for specifying options for cloning a git repository

func NewCloneOptions

func NewCloneOptions(repoUrl, commit, tag, branch, localpath string, Writer io.Writer) *CloneOptions

func (*CloneOptions) CheckoutFromBare

func (cloneOpts *CloneOptions) CheckoutFromBare() error

CheckoutFromBare checks out the specified reference from a bare repository

func (*CloneOptions) Clone

func (cloneOpts *CloneOptions) Clone() (*git.Repository, error)

Clone clones a git repository, handling both bare and non-bare options

func (*CloneOptions) ForceGitUrl

func (cloneOpts *CloneOptions) ForceGitUrl() (string, error)

ForceGitUrl will add the branch, tag or commit to the git URL and force it to the git protocol `<URL>` will return `Git::<URL>?ref=<branch|tag|commit>`

func (*CloneOptions) Validate

func (cloneOpts *CloneOptions) Validate() error

Validate checks if the CloneOptions are valid

type GitHubRelease

type GitHubRelease struct {
	TagName string `json:"tag_name"`
}