internal

Documentation

Overview

Package internal supports the options and transport packages.

Index

• func Creds(ctx context.Context, ds *DialSettings) (*google.Credentials, error)
• func QuotaProjectFromCreds(cred *google.Credentials) string
• type ConnPool
• type DialSettings
  • func (ds *DialSettings) Validate() error
• type PoolResolver
  • func NewPoolResolver(size int, o *DialSettings) *PoolResolver
  • func (r *PoolResolver) Close()
  • func (r *PoolResolver) Next() ([]*naming.Update, error)
  • func (r *PoolResolver) Resolve(target string) (naming.Watcher, error)

Functions

func Creds

func Creds(ctx context.Context, ds *DialSettings) (*google.Credentials, error)

Creds returns credential information obtained from DialSettings, or if none, then it returns default credential information.

func QuotaProjectFromCreds

func QuotaProjectFromCreds(cred *google.Credentials) string

QuotaProjectFromCreds returns the quota project from the JSON blob in the provided credentials.

NOTE(cbro): consider promoting this to a field on google.Credentials.

Types

type ConnPool

type ConnPool interface {
	// Conn returns a ClientConn from the pool.
	//
	// Conns aren't returned to the pool.
	Conn() *grpc.ClientConn

	// Num returns the number of connections in the pool.
	//
	// It will always return the same value.
	Num() int

	// Close closes every ClientConn in the pool.
	//
	// The error returned by Close may be a single error or multiple errors.
	Close() error

	// ConnPool implements grpc.ClientConnInterface to enable it to be used directly with generated proto stubs.
	grpc.ClientConnInterface
}

ConnPool is a pool of grpc.ClientConns.

type DialSettings

type DialSettings struct {
	Endpoint          string
	Scopes            []string
	TokenSource       oauth2.TokenSource
	Credentials       *google.Credentials
	CredentialsFile   string // if set, Token Source is ignored.
	CredentialsJSON   []byte
	UserAgent         string
	APIKey            string
	Audiences         []string
	HTTPClient        *http.Client
	GRPCDialOpts      []grpc.DialOption
	GRPCConn          *grpc.ClientConn
	GRPCConnPool      ConnPool
	GRPCConnPoolSize  int
	NoAuth            bool
	TelemetryDisabled bool

	// Google API system parameters. For more information please read:
	// https://cloud.google.com/apis/docs/system-parameters
	QuotaProject  string
	RequestReason string
}

DialSettings holds information needed to establish a connection with a Google API service.

func (*DialSettings) Validate

func (ds *DialSettings) Validate() error

Validate reports an error if ds is invalid.

type PoolResolver

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

PoolResolver provides a fixed list of addresses to load balance between and does not provide further updates.

func NewPoolResolver

func NewPoolResolver(size int, o *DialSettings) *PoolResolver

NewPoolResolver returns a PoolResolver This is an EXPERIMENTAL API and may be changed or removed in the future.

func (*PoolResolver) Close

func (r *PoolResolver) Close()

Close releases resources associated with the pool and causes Next to unblock.

func (*PoolResolver) Next

func (r *PoolResolver) Next() ([]*naming.Update, error)

Next returns a static list of updates on the first call, and blocks indefinitely until Close is called on subsequent calls.

func (*PoolResolver) Resolve

func (r *PoolResolver) Resolve(target string) (naming.Watcher, error)

Resolve returns a Watcher for the endpoint defined by the DialSettings provided to NewPoolResolver.