github

Documentation

Index

• type Client
  • func NewClient(opts ...Option) *Client
  • func (c *Client) HasToken() bool
  • func (c *Client) LatestRelease(ctx context.Context, owner, repo string) (string, error)
  • func (c *Client) RateLimitHit() bool
  • func (c *Client) ResolveTagSHA(ctx context.Context, owner, repo, tag string) (string, error)
  • func (c *Client) VerifyCommit(ctx context.Context, owner, repo, sha string) (bool, error)
• type Option
  • func WithBaseURL(url string) Option
  • func WithHTTPClient(hc *http.Client) Option
  • func WithToken(token string) Option

Types

type Client

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

func NewClient

func NewClient(opts ...Option) *Client

func (*Client) HasToken

func (c *Client) HasToken() bool

HasToken reports whether the client was configured with a GitHub token.

func (*Client) LatestRelease

func (c *Client) LatestRelease(ctx context.Context, owner, repo string) (string, error)

LatestRelease fetches the latest release tag name for the given repository.

func (*Client) RateLimitHit

func (c *Client) RateLimitHit() bool

RateLimitHit reports whether any API call encountered a rate limit error.

func (*Client) ResolveTagSHA

func (c *Client) ResolveTagSHA(ctx context.Context, owner, repo, tag string) (string, error)

ResolveTagSHA resolves a git tag to its underlying commit SHA. For annotated tags, it dereferences the tag object to find the commit. Results are cached to avoid duplicate API calls for the same owner/repo@tag.

func (*Client) VerifyCommit

func (c *Client) VerifyCommit(ctx context.Context, owner, repo, sha string) (bool, error)

VerifyCommit checks whether a commit SHA is reachable from any branch or tag in the given repository. Results are cached.

type Option

type Option func(*Client)

func WithBaseURL

func WithBaseURL(url string) Option

func WithHTTPClient

func WithHTTPClient(hc *http.Client) Option

func WithToken

func WithToken(token string) Option