github

Documentation

Index

• Constants
• type Client
  • func NewClient(option *Option) (*Client, error)
  • func (c *Client) AddRepoSecret(secretKey, secretValue string) error
  • func (c *Client) AddWorkflow(workflow *Workflow, branch string) error
  • func (c *Client) CreateFile(content []byte, filePath, targetBranch string) error
  • func (c *Client) CreateRepo() error
  • func (c *Client) DeleteRepo() error
  • func (c *Client) DeleteRepoSecret(secretKey string) error
  • func (c *Client) DeleteWorkflow(workflow *Workflow, branch string) error
  • func (c *Client) DownloadAsset(tagName, assetName string) error
  • func (c *Client) DownloadLatestCodeAsZipFile() error
  • func (c *Client) FetchRemoteContent(wsFiles []string) ([]string, map[string]error, error)
  • func (c *Client) GetLastCommit() (*github.RepositoryCommit, error)
  • func (c *Client) GetRepoDescription() (*github.Repository, error)
  • func (c *Client) GetWorkflowPath() (string, error)
  • func (c *Client) MergePullRequest(number int, mergeMethod MergeMethod) error
  • func (c *Client) NewBranch(baseBranch, newBranch string) error
  • func (c *Client) NewPullRequest(fromBranch, toBranch string) (int, error)
  • func (c *Client) RepoSecretExists(secretKey string) (bool, error)
  • func (c *Client) VerifyWorkflows(workflows []*Workflow) (map[string]error, error)
• type MergeMethod
• type Option
• type Workflow

Constants

const (
	DefaultWorkPath = ".github-workpath"
	// https://github.com/merico-dev/dtm-scaffolding-golang/archive/refs/heads/main.zip -> 302 ->
	// https://codeload.github.com/merico-dev/dtm-scaffolding-golang/zip/refs/heads/main
	DefaultLatestCodeZipfileDownloadUrlFormat = "https://codeload.github.com/%s/%s/zip/refs/heads/main"
	DefaultLatestCodeZipfileName              = "main-latest.zip"
)

Types

type Client

type Client struct {
	*Option
	*github.Client
	context.Context
}

func NewClient

func NewClient(option *Option) (*Client, error)

func (*Client) AddRepoSecret

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

AddRepoSecret adds a secret to a GitHub repo.

func (*Client) AddWorkflow

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

func (*Client) CreateFile

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

func (*Client) CreateRepo

func (c *Client) CreateRepo() 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) DeleteWorkflow

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

func (*Client) DownloadAsset

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

func (*Client) DownloadLatestCodeAsZipFile

func (c *Client) DownloadLatestCodeAsZipFile() 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) GetRepoDescription

func (c *Client) GetRepoDescription() (*github.Repository, error)

func (*Client) GetWorkflowPath

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

func (*Client) MergePullRequest

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

func (*Client) NewBranch

func (c *Client) NewBranch(baseBranch, newBranch string) error

func (*Client) NewPullRequest

func (c *Client) NewPullRequest(fromBranch, toBranch string) (int, 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 Option

type Option struct {
	Owner    string
	Repo     string
	NeedAuth bool
	WorkPath string
}

type Workflow

type Workflow struct {
	CommitMessage    string
	WorkflowFileName string
	WorkflowContent  string
}

Workflow is the struct for a GitHub Actions Workflow.