githubclt

package
v0.5.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Dec 17, 2024 License: AGPL-3.0 Imports: 14 Imported by: 0

Documentation

Overview

Package githubclt provides a github API client.

Index

Constants

View Source 
const (
	ReviewDecisionApproved         = ReviewDecision(githubv4.PullRequestReviewDecisionApproved)
	ReviewDecisionChangesRequested = ReviewDecision(githubv4.PullRequestReviewDecisionChangesRequested)
	ReviewDecisionReviewRequired   = ReviewDecision(githubv4.PullRequestReviewDecisionReviewRequired)
)
View Source 
const DefaultHTTPClientTimeout = time.Minute

Variables

View Source 
var ErrPullRequestIsClosed = errors.New("pull request is closed")

Functions

This section is empty.

Types

type CIJobStatus 

type CIJobStatus struct {
	Name     string
	Status   CIStatus
	Required bool
	JobURL   string
}

CIJobStatus is the status of a CI job. It represents the status of GitHub CheckRuns and Commit statuses.

type CIStatus 

type CIStatus string

CIStatus abstracts the multiple result values of GitHub check runs and Commit statuses into a single value. 

const (
	CIStatusSuccess CIStatus = "SUCCESS"
	CIStatusPending CIStatus = "PENDING"
	CIStatusFailure CIStatus = "FAILURE"
)

type Client 

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

Client is an github API client. All methods return a goorderr.RetryableError when an operation can be retried. This can be e.g. the case when the API ratelimit is exceeded.

func New 

func New(oauthAPItoken string) *Client

New returns a new github api client.

func (*Client) AddLabel 

func (clt *Client) AddLabel(ctx context.Context, owner, repo string, pullRequestOrIssueNumber int, label string) error

AddLabel adds a label to Pull-Request or Issue.

func (*Client) BranchIsBehindBase 

func (clt *Client) BranchIsBehindBase(ctx context.Context, owner, repo, base, head string) (behind bool, err error)

BranchIsBehindBase returns true if the head reference contains all changes of base.

func (*Client) CreateIssueComment 

func (clt *Client) CreateIssueComment(ctx context.Context, owner, repo string, issueOrPRNr int, comment string) error

CreateIssueComment creates a comment in a issue or pull request

func (*Client) ListPullRequests 

func (clt *Client) ListPullRequests(ctx context.Context, owner, repo, state, sort, sortDirection string) PRIterator

ListPullRequests returns an iterator for receiving all pull requests. The parameters state, sort, sortDirection expect the same values then their pendants in the struct github.PullRequestListOptions. all pull requests should be returned.

func (*Client) PRIsUptodate 

func (clt *Client) PRIsUptodate(ctx context.Context, owner, repo string, pullRequestNumber int) (isUptodate bool, headSHA string, err error)

PullRequestIsUptodateWithBase returns true if the pull request is open and contains all changes from it's base branch. Additionally it returns the SHA of the head commit for which the status was checked. If the PR is closed PullRequestIsClosedError is returned.

func (*Client) ReadyForMerge 

func (clt *Client) ReadyForMerge(ctx context.Context, owner, repo string, prNumber int) (*ReadyForMergeStatus, error)

ReadyForMerge returns the review decision and status check rollup for a PR.

The returned [ReadyForMergeStatus.CIStatus] is CIStatusPending, if one or more checks or status are in pending state. It is CIStatusSuccess, if no check or status is in pending state and all required ones succeeded. If a required check or status is in failed state the CIStatus is CIStatusFailure.

func (*Client) RemoveLabel 

func (clt *Client) RemoveLabel(ctx context.Context, owner, repo string, pullRequestOrIssueNumber int, label string) error

RemoveLabel removes a label from a Pull-Request or issue. If the issue or PR does not have the label, the operation succeeds.

func (*Client) UpdateBranch 

func (clt *Client) UpdateBranch(ctx context.Context, owner, repo string, pullRequestNumber int) (*UpdateBranchResult, error)

UpdateBranch schedules merging the base-branch into a pull request branch. If the PR contains all changes of it's base branch, false is returned for changed If it's not up-to-date and updating the PR was scheduled at github, true is returned for changed and scheduled. If the PR was updated while the method was executed, a goorderr.RetryableError is returned and the operation can be retried. If the branch can not be updated automatically because of a merge conflict, an error is returned.

type PRIter 

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

func (*PRIter) Next 

func (it *PRIter) Next() (*github.PullRequest, error)

Next returns the next pullRequest. When the last result was returned a nil PullRequest is returned.

type PRIterator 

type PRIterator interface {
	Next() (*github.PullRequest, error)
}

type ReadyForMergeStatus 

type ReadyForMergeStatus struct {
	ReviewDecision ReviewDecision
	CIStatus       CIStatus
	Statuses       []*CIJobStatus
	Commit         string
}

ReadyForMergeStatus represent the information deciding if a pull request is ready to be merged. It contains the review decision and CI job results.

type ReviewDecision 

type ReviewDecision string

ReviewDecision is the result of a pull request review.

type UpdateBranchResult 

type UpdateBranchResult struct {
	Changed      bool
	Scheduled    bool
	HeadCommitID string
}

Source Files

View all Source files

Directories

Path Synopsis
Package mocks is a generated GoMock package.
 Package mocks is a generated GoMock package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.