gh

Documentation

Index

• func IsHTTPUnauthorized(err error) bool
• func Ptr[T any](v T) *T
• type AddIssueLabelInput
• type Client
  • func NewClient(token string) (*Client, error)
  • func (c *Client) AddIssueLabels(ctx context.Context, input AddIssueLabelInput) error
  • func (c *Client) ConvertPullRequestToDraft(ctx context.Context, id string) (*PullRequest, error)
  • func (c *Client) CreatePullRequest(ctx context.Context, input githubv4.CreatePullRequestInput) (*PullRequest, error)
  • func (c *Client) GetPullRequests(ctx context.Context, input GetPullRequestsInput) (*GetPullRequestsPage, error)
  • func (c *Client) GetRepositoryBySlug(ctx context.Context, slug string) (*Repository, error)
  • func (c *Client) MarkPullRequestReadyForReview(ctx context.Context, id string) (*PullRequest, error)
  • func (c *Client) OrganizationTeam(ctx context.Context, organizationLogin string, teamSlug string) (*Team, error)
  • func (c *Client) PullRequest(ctx context.Context, id string) (*PullRequest, error)
  • func (c *Client) RepoPullRequests(ctx context.Context, opts RepoPullRequestOpts) (RepoPullRequestsResponse, error)
  • func (c *Client) RequestReviews(ctx context.Context, input githubv4.RequestReviewsInput) (*PullRequest, error)
  • func (c *Client) UpdatePullRequest(ctx context.Context, input githubv4.UpdatePullRequestInput) (*PullRequest, error)
  • func (c *Client) User(ctx context.Context, login string) (*User, error)
  • func (c *Client) Viewer(ctx context.Context) (*Viewer, error)
• type GetPullRequestsInput
• type GetPullRequestsPage
• type PageInfo
• type PullRequest
  • func (p *PullRequest) BaseBranchName() string
  • func (p *PullRequest) GetMergeCommit() string
  • func (p *PullRequest) HeadBranchName() string
• type PullRequestOpts
• type RepoPullRequestOpts
• type RepoPullRequestsResponse
• type Repository
• type Team
• type User
• type Viewer

Functions

func IsHTTPUnauthorized

func IsHTTPUnauthorized(err error) bool

IsHTTPUnauthorized returns true if the given error is an HTTP 401 Unauthorized error.

func Ptr

func Ptr[T any](v T) *T

Ptr returns a pointer to the argument. It's a convenience function to make working with the API easier: since Go disallows pointers-to-literals, and optional input fields are expressed as pointers, this function can be used to easily set optional fields to non-nil primitives. For example, githubv4.CreatePullRequestInput{Draft: Ptr(true)}

Types

type AddIssueLabelInput

type AddIssueLabelInput struct {
	// The owner of the GitHub repository.
	Owner string
	// The name of the GitHub repository.
	Repo string
	// The number of the issue or pull request to add a label to.
	Number int64
	// The names of the labels to add to the issue. This will implicitly create
	// a label on the repository if the label doesn't already exist (this is the
	// main reason we use the REST API for this call).
	LabelNames []string
}

type Client

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

func NewClient

func NewClient(token string) (*Client, error)

NewClient creates a new GitHub client. It takes configuration from the global config.Av.GitHub variable.

func (*Client) AddIssueLabels

func (c *Client) AddIssueLabels(ctx context.Context, input AddIssueLabelInput) error

AddIssueLabels adds labels to an issue (or pull request, since in GitHub a pull request is a superset of an issue).

func (*Client) ConvertPullRequestToDraft

func (c *Client) ConvertPullRequestToDraft(ctx context.Context, id string) (*PullRequest, error)

func (*Client) CreatePullRequest

func (c *Client) CreatePullRequest(
	ctx context.Context,
	input githubv4.CreatePullRequestInput,
) (*PullRequest, error)

func (*Client) GetPullRequests

func (c *Client) GetPullRequests(
	ctx context.Context,
	input GetPullRequestsInput,
) (*GetPullRequestsPage, error)

func (*Client) GetRepositoryBySlug

func (c *Client) GetRepositoryBySlug(ctx context.Context, slug string) (*Repository, error)

func (*Client) MarkPullRequestReadyForReview

func (c *Client) MarkPullRequestReadyForReview(
	ctx context.Context,
	id string,
) (*PullRequest, error)

func (*Client) OrganizationTeam

func (c *Client) OrganizationTeam(
	ctx context.Context,
	organizationLogin string,
	teamSlug string,
) (*Team, error)

OrganizationTeam returns information about the given team in the given organization.

func (*Client) PullRequest

func (c *Client) PullRequest(ctx context.Context, id string) (*PullRequest, error)

func (*Client) RepoPullRequests

func (c *Client) RepoPullRequests(
	ctx context.Context,
	opts RepoPullRequestOpts,
) (RepoPullRequestsResponse, error)

func (*Client) RequestReviews

func (c *Client) RequestReviews(
	ctx context.Context,
	input githubv4.RequestReviewsInput,
) (*PullRequest, error)

RequestReviews requests reviews from the given users on the given pull request.

func (*Client) UpdatePullRequest

func (c *Client) UpdatePullRequest(
	ctx context.Context,
	input githubv4.UpdatePullRequestInput,
) (*PullRequest, error)

func (*Client) User

func (c *Client) User(ctx context.Context, login string) (*User, error)

User returns information about the given user.

func (*Client) Viewer

func (c *Client) Viewer(ctx context.Context) (*Viewer, error)

type GetPullRequestsInput

type GetPullRequestsInput struct {
	// REQUIRED
	Owner string
	Repo  string
	// OPTIONAL
	HeadRefName string
	BaseRefName string
	States      []githubv4.PullRequestState
	First       int64
	After       string
}

type GetPullRequestsPage

type GetPullRequestsPage struct {
	PageInfo
	PullRequests []PullRequest
}

type PageInfo

type PageInfo struct {
	EndCursor       string
	HasNextPage     bool
	HasPreviousPage bool
	StartCursor     string
}

PageInfo contains information about the current/previous/next page of results when using paginated APIs.

type PullRequest

type PullRequest struct {
	ID     string
	Number int64
	Author struct {
		Login string
	}
	HeadRefName         string
	HeadRefOID          string
	BaseRefName         string
	IsDraft             bool
	Mergeable           githubv4.MergeableState
	Merged              bool
	Permalink           string
	State               githubv4.PullRequestState
	Title               string
	Body                string
	PRIVATE_MergeCommit struct {
		Oid string
	} `graphql:"mergeCommit"`
	PRIVATE_TimelineItems struct {
		Nodes []struct {
			ClosedEvent struct {
				Closer struct {
					Commit struct {
						Oid string
					} `graphql:"... on Commit"`
				}
			} `graphql:"... on ClosedEvent"`
		}
	} `graphql:"timelineItems(last: 10, itemTypes: CLOSED_EVENT)"`
}

func (*PullRequest) BaseBranchName

func (p *PullRequest) BaseBranchName() string

func (*PullRequest) GetMergeCommit

func (p *PullRequest) GetMergeCommit() string

func (*PullRequest) HeadBranchName

func (p *PullRequest) HeadBranchName() string

type PullRequestOpts

type PullRequestOpts struct {
	Owner  string
	Repo   string
	Number int64
}

type RepoPullRequestOpts

type RepoPullRequestOpts struct {
	Owner  string
	Repo   string
	First  int64
	After  string
	States []githubv4.PullRequestState
}

type RepoPullRequestsResponse

type RepoPullRequestsResponse struct {
	PageInfo
	TotalCount   int64
	PullRequests []PullRequest
}

type Repository

type Repository struct {
	ID    string
	Owner struct {
		Login string
	}
	Name string
}

type Team

type Team struct {
	ID   githubv4.ID `graphql:"id"`
	Name string      `graphql:"name"`
	Slug string      `graphql:"slug"`
}

type User

type User struct {
	ID    githubv4.ID `graphql:"id"`
	Login string      `graphql:"login"`
}

type Viewer

type Viewer struct {
	Name  string `graphql:"name"`
	Login string `graphql:"login"`
}