gh

Documentation

Index

• Constants
• Variables
• func NewClient(authenticated *http.Client, gccf ...ClientCreationFunc) (*github.Client, error)
• func NewClientDefault(authenticated *http.Client) (*github.Client, error)
• type ClientCreationFunc
• type Queryable

Constants

const (
	// PerPageResultsDefault defines the default page size for search query responses
	PerPageResultsDefault = 100
)

Variables

var (
	// WellKnownTokenVarNames lists known env var names for Github related tokens
	WellKnownTokenVarNames = []string{"GITHUB_TOKEN", "GH_TOKEN", "NPM_TOKEN"}
)

Functions

func NewClient

func NewClient(authenticated *http.Client, gccf ...ClientCreationFunc) (*github.Client, error)

NewClient conveniently creates a client connection to the Github API based on an already authenticated http client connection

If the authenticated client is not provided, a new client will be created by calling [NewOAuthClient] trying to find tokens in [WellKnownGithubTokenVarNames]

Providing a parameter for gccf would allow creating the github client with a customized function

func NewClientDefault

func NewClientDefault(authenticated *http.Client) (*github.Client, error)

NewClientDefault provides a client connection to the Github API based on an already authenticated http client connection

Types

type ClientCreationFunc

type ClientCreationFunc func(*http.Client) (*github.Client, error)

ClientCreationFunc defines the structure of a function, which is capable for creating an oauth2 client

type Queryable

type Queryable interface {
	Query(context.Context, *github.Client) (interface{}, error)
}

Queryable is able to query Github API and returns a data structure