git

Documentation

Index

• Variables
• func Providers() []string
• type AddFlagsOptions
• type Auth
• type Client
• type CloneOptions
  • func AddFlags(cmd *cobra.Command, opts *AddFlagsOptions) *CloneOptions
  • func (o *CloneOptions) GetRepo(ctx context.Context) (Repository, fs.FS, error)
  • func (o *CloneOptions) Parse()
  • func (o *CloneOptions) Path() string
  • func (o *CloneOptions) Revision() string
  • func (o *CloneOptions) URL() string
• type CreateRepoOptions
• type GetRepoOptions
• type Provider
• type ProviderOptions
• type PushOptions
• type Repository

Variables

var (
	ErrProviderNotSupported = func(providerType string) error {
		return fmt.Errorf("git provider '%s' not supported", providerType)
	}
	ErrAuthenticationFailed = func(err error) error {
		return fmt.Errorf("authentication failed, make sure credentials are correct: %w", err)
	}
)

Errors

var (
	ErrNilOpts      = errors.New("options cannot be nil")
	ErrNoParse      = errors.New("must call Parse before using CloneOptions")
	ErrRepoNotFound = errors.New("git repository not found")
	ErrNoRemotes    = errors.New("no remotes in repository")
)

Errors

Functions

func Providers

func Providers() []string

Types

type AddFlagsOptions

type AddFlagsOptions struct {
	FS               billy.Filesystem
	Prefix           string
	CreateIfNotExist bool
	Optional         bool
}

type Auth

type Auth struct {
	Username string
	Password string
}

type Client

type Client interface {
	CreateOrgRepo(org string, opt gt.CreateRepoOption) (*gt.Repository, *gt.Response, error)
	CreateRepo(opt gt.CreateRepoOption) (*gt.Repository, *gt.Response, error)
	GetMyUserInfo() (*gt.User, *gt.Response, error)
}

type CloneOptions

type CloneOptions struct {
	Provider string
	Repo     string
	Auth     Auth
	FS       fs.FS
	Progress io.Writer
	// contains filtered or unexported fields
}

func AddFlags

func AddFlags(cmd *cobra.Command, opts *AddFlagsOptions) *CloneOptions

func (*CloneOptions) GetRepo

func (o *CloneOptions) GetRepo(ctx context.Context) (Repository, fs.FS, error)

func (*CloneOptions) Parse

func (o *CloneOptions) Parse()

func (*CloneOptions) Path

func (o *CloneOptions) Path() string

func (*CloneOptions) Revision

func (o *CloneOptions) Revision() string

func (*CloneOptions) URL

func (o *CloneOptions) URL() string

type CreateRepoOptions

type CreateRepoOptions struct {
	Owner   string
	Name    string
	Private bool
}

type GetRepoOptions

type GetRepoOptions struct {
	Owner string
	Name  string
}

type Provider

type Provider interface {
	// CreateRepository creates the repository in the remote provider and returns a
	// clone url
	CreateRepository(ctx context.Context, opts *CreateRepoOptions) (string, error)
}

Provider represents a git provider

type ProviderOptions

type ProviderOptions struct {
	Type string
	Auth *Auth
	Host string
}

ProviderOptions for a new git provider

type PushOptions

type PushOptions struct {
	AddGlobPattern string
	CommitMsg      string
	Progress       io.Writer
}

type Repository

type Repository interface {
	// Persist runs add, commit and push to the repository default remote
	Persist(ctx context.Context, opts *PushOptions) (string, error)
	// CurrentBranch returns the name of the current branch
	CurrentBranch() (string, error)
}

Repository represents a git repository