client

type APIKeySigner struct {
	// SignQuery indicates whether to set the API key in the URL query with key KeyName
	// or whether to use a header with name KeyName.
	SignQuery bool
	// KeyName is the name of the HTTP header or query string that contains the API key.
	KeyName string
	// KeyValue stores the actual key.
	KeyValue string
	// Format is the format used to render the key, e.g. "Bearer %s"
	Format string
}

type BasicSigner struct {
	// Username is the basic auth user.
	Username string
	// Password is err guess what? the basic auth password.
	Password string
}

type Client struct {
	// Doer is the underlying http client.
	Doer
	// Scheme overrides the default action scheme.
	Scheme string
	// Host is the service hostname.
	Host string
	// UserAgent is the user agent set in requests made by the client.
	UserAgent string
	// Dump indicates whether to dump request response.
	Dump bool
}

type Doer interface {
	Do(context.Context, *http.Request) (*http.Response, error)
}

type JWTSigner struct {
	// TokenSource is a JWT token source.
	// See https://godoc.org/golang.org/x/oauth2/jwt#Config.TokenSource for an example
	// of an implementation.
	TokenSource TokenSource
}

type OAuth2Signer struct {
	// TokenSource is an OAuth2 access token source.
	// See package golang/oauth2 and its subpackage for implementations of token
	// sources.
	TokenSource TokenSource
}

type Signer interface {
	// Sign adds required headers, cookies etc.
	Sign(*http.Request) error
}

type StaticToken struct {
	// Value used to set the auth header.
	Value string
	// OAuth type, defaults to "Bearer".
	Type string
}

type StaticTokenSource struct {
	StaticToken *StaticToken
}

type Token interface {
	// SetAuthHeader sets the Authorization header to r.
	SetAuthHeader(r *http.Request)
	// Valid reports whether Token can be used to properly sign requests.
	Valid() bool
}

type TokenSource interface {
	// Token returns a token or an error.
	// Token must be safe for concurrent use by multiple goroutines.
	// The returned Token must not be modified.
	Token() (Token, error)
}