github

Documentation

Index

• Constants
• type Client
  • func NewClient(option *git.RepoInfo) (*Client, error)
  • func (c *Client) AddRepoSecret(secretKey, secretValue string) error
  • func (c *Client) AddWebhook(webhookConfig *git.WebhookConfig) error
  • func (c *Client) AddWorkflow(workflow *Workflow, branch string) error
  • func (c *Client) BuildCommitTree(ref *github.Reference, commitInfo *git.CommitInfo, checkChange bool) (*github.Tree, error)
  • func (c *Client) CreateFile(content []byte, filePath, targetBranch string) error
  • func (c *Client) CreateRepo(org, defaultBranch string) error
  • func (c *Client) DeleteBranch(branch string) error
  • func (c *Client) DeleteFiles(commitInfo *git.CommitInfo) error
  • func (c *Client) DeleteRepo() error
  • func (c *Client) DeleteRepoSecret(secretKey string) error
  • func (c *Client) DeleteWebhook(webhookConfig *git.WebhookConfig) error
  • func (c *Client) DeleteWorkflow(workflow *Workflow, branch string) error
  • func (c *Client) DescribeRepo() (*git.RepoInfo, error)
  • func (c *Client) DownloadAsset(tagName, assetName, fileName string) error
  • func (c *Client) DownloadRepo() (string, error)
  • func (c *Client) FetchRemoteContent(wsFiles []string) ([]string, map[string]error, error)
  • func (c *Client) GetLastCommit() (*github.RepositoryCommit, error)
  • func (c *Client) GetLatestReleaseTagName() (string, error)
  • func (c *Client) GetPathInfo(location string) ([]*git.RepoFileStatus, error)
  • func (c *Client) GetWorkflowPath() (string, error)
  • func (c *Client) InitRepo() error
  • func (c *Client) MergeCommits(commitInfo *git.CommitInfo) error
  • func (c *Client) MergePullRequest(number int, mergeMethod MergeMethod) error
  • func (c *Client) NewBranch(newBranch string) (*github.Reference, error)
  • func (c *Client) NewPullRequest(commitInfo *git.CommitInfo) (int, error)
  • func (c *Client) ProtectBranch(branch string) error
  • func (c *Client) PushFiles(commitInfo *git.CommitInfo, checkChange bool) (bool, error)
  • func (c *Client) PushLocalPath(ref *github.Reference, tree *github.Tree, commitInfo *git.CommitInfo) error
  • func (c *Client) RepoSecretExists(secretKey string) (bool, error)
  • func (c *Client) VerifyWorkflows(workflows []*Workflow) (map[string]error, error)
• type MergeMethod
• type Workflow

Constants

const (
	TokenEnvKey = "GITHUB_TOKEN"
)

Types

type Client

type Client struct {
	*git.RepoInfo
	*github.Client
	context.Context
}

func NewClient

func NewClient(option *git.RepoInfo) (*Client, error)

func (*Client) AddRepoSecret

func (c *Client) AddRepoSecret(secretKey, secretValue string) error

AddRepoSecret adds a secret to a GitHub repo.

func (*Client) AddWebhook

func (c *Client) AddWebhook(webhookConfig *git.WebhookConfig) error

func (*Client) AddWorkflow

func (c *Client) AddWorkflow(workflow *Workflow, branch string) error

func (*Client) BuildCommitTree

func (c *Client) BuildCommitTree(ref *github.Reference, commitInfo *git.CommitInfo, checkChange bool) (*github.Tree, error)

func (*Client) CreateFile

func (c *Client) CreateFile(content []byte, filePath, targetBranch string) error

func (*Client) CreateRepo

func (c *Client) CreateRepo(org, defaultBranch string) error

func (*Client) DeleteBranch

func (c *Client) DeleteBranch(branch string) error

func (*Client) DeleteFiles

func (c *Client) DeleteFiles(commitInfo *git.CommitInfo) error

func (*Client) DeleteRepo

func (c *Client) DeleteRepo() error

func (*Client) DeleteRepoSecret

func (c *Client) DeleteRepoSecret(secretKey string) error

DeleteRepoSecret deletes a secret in a GitHub repo.

func (*Client) DeleteWebhook

func (c *Client) DeleteWebhook(webhookConfig *git.WebhookConfig) error

func (*Client) DeleteWorkflow

func (c *Client) DeleteWorkflow(workflow *Workflow, branch string) error

func (*Client) DescribeRepo

func (c *Client) DescribeRepo() (*git.RepoInfo, error)

func (*Client) DownloadAsset

func (c *Client) DownloadAsset(tagName, assetName, fileName string) error

func (*Client) DownloadRepo

func (c *Client) DownloadRepo() (string, error)

DownloadRepo will download repo, return repo local path and error

func (*Client) FetchRemoteContent

func (c *Client) FetchRemoteContent(wsFiles []string) ([]string, map[string]error, error)

func (*Client) GetLastCommit

func (c *Client) GetLastCommit() (*github.RepositoryCommit, error)

func (*Client) GetLatestReleaseTagName

func (c *Client) GetLatestReleaseTagName() (string, error)

func (*Client) GetPathInfo

func (c *Client) GetPathInfo(location string) ([]*git.RepoFileStatus, error)

func (*Client) GetWorkflowPath

func (c *Client) GetWorkflowPath() (string, error)

func (*Client) InitRepo

func (c *Client) InitRepo() error

func (*Client) MergeCommits

func (c *Client) MergeCommits(commitInfo *git.CommitInfo) error

func (*Client) MergePullRequest

func (c *Client) MergePullRequest(number int, mergeMethod MergeMethod) error

func (*Client) NewBranch

func (c *Client) NewBranch(newBranch string) (*github.Reference, error)

func (*Client) NewPullRequest

func (c *Client) NewPullRequest(commitInfo *git.CommitInfo) (int, error)

func (*Client) ProtectBranch

func (c *Client) ProtectBranch(branch string) error

ProtectBranch will protect the special branch

func (*Client) PushFiles

func (c *Client) PushFiles(commitInfo *git.CommitInfo, checkChange bool) (bool, error)

PushFiles will push local change to remote repo return boolean value is for control whether to roll out if encounter error

func (*Client) PushLocalPath

func (c *Client) PushLocalPath(ref *github.Reference, tree *github.Tree, commitInfo *git.CommitInfo) error

func (*Client) RepoSecretExists

func (c *Client) RepoSecretExists(secretKey string) (bool, error)

RepoSecretExists detects if a secret exists in a GitHub repo.

func (*Client) VerifyWorkflows

func (c *Client) VerifyWorkflows(workflows []*Workflow) (map[string]error, error)

VerifyWorkflows get the workflows with names "wf1.yml", "wf2.yml", then: If all workflows is ok => return ({"wf1.yml":nil, "wf2.yml:nil}, nil) If some error occurred => return (nil, error) If wf1.yml is not found => return ({"wf1.yml":error("not found"), "wf2.yml:nil},nil)

type MergeMethod

type MergeMethod string

const (
	MergeMethodSquash MergeMethod = "squash"
	MergeMethodMerge  MergeMethod = "merge"
	MergeMethodRebase MergeMethod = "rebase"
)

type Workflow

type Workflow struct {
	CommitMessage    string
	WorkflowFileName string
	WorkflowContent  string
}

Workflow is the struct for a GitHub Actions Workflow.