go: cloud.google.com/go/internal/testutil Index | Files

package testutil

import "cloud.google.com/go/internal/testutil"

Package testutil contains helper functions for writing tests.

Index

Package Files

context.go server.go unique.go

func ProjID Uses

func ProjID() string

ProjID returns the project ID to use in integration tests, or the empty string if none is configured.

func TokenSource Uses

func TokenSource(ctx context.Context, scopes ...string) oauth2.TokenSource

TokenSource returns the OAuth2 token source to use in integration tests, or nil if none is configured. If the environment variable is unset, TokenSource will try to find 'Application Default Credentials'. Else, TokenSource will return nil. TokenSource will log.Fatal if the token source is specified but missing or invalid.

type Server Uses

type Server struct {
    Addr string

    Gsrv *grpc.Server
    // contains filtered or unexported fields
}

A Server is an in-process gRPC server, listening on a system-chosen port on the local loopback interface. Servers are for testing only and are not intended to be used in production code.

To create a server, make a new Server, register your handlers, then call Start:

srv, err := NewServer()
...
mypb.RegisterMyServiceServer(srv.Gsrv, &myHandler)
....
srv.Start()

Clients should connect to the server with no security:

conn, err := grpc.Dial(srv.Addr, grpc.WithInsecure())
...

func NewServer Uses

func NewServer(opts ...grpc.ServerOption) (*Server, error)

NewServer creates a new Server. The Server will be listening for gRPC connections at the address named by the Addr field, without TLS.

func (*Server) Close Uses

func (s *Server) Close()

Close shuts down the server.

func (*Server) Start Uses

func (s *Server) Start()

Start causes the server to start accepting incoming connections. Call Start after registering handlers.

type UIDSpace Uses

type UIDSpace struct {
    Prefix string
    // contains filtered or unexported fields
}

A UIDSpace manages a set of unique IDs distinguished by a prefix.

func NewUIDSpace Uses

func NewUIDSpace(prefix string) *UIDSpace

func (*UIDSpace) New Uses

func (s *UIDSpace) New() string

New generates a new unique ID . The ID consists of the UIDSpace's prefix, a timestamp, and a counter value. All unique IDs generated in the same test execution will have the same timestamp.

Aside from the characters in the prefix, IDs contain only letters, numbers and hyphens.

func (*UIDSpace) Older Uses

func (s *UIDSpace) Older(uid string, d time.Duration) bool

Older reports whether uid was created by m and has a timestamp older than the current time by at least d.

func (*UIDSpace) Timestamp Uses

func (s *UIDSpace) Timestamp(uid string) (time.Time, bool)

Timestamp extracts the timestamp of uid, which must have been generated by s. The second return value is true on success, false if there was a problem.

Package testutil imports 13 packages (graph) and is imported by 1 packages. Updated 2017-05-27. Refresh now. Tools for package owners.