Documentation
¶
Index ¶
- Variables
- func FakeGCPCredentials(ctx context.Context) (*google.Credentials, error)
- func FakeGCPDefaultCredentials(t *testing.T) func()
- func HasDockerTestEnvironment() bool
- func NewAWSSession(ctx context.Context, t *testing.T, region string) (sess *session.Session, rt http.RoundTripper, cleanup func(), initState int64)
- func NewAWSv2Config(ctx context.Context, t *testing.T, region string) (cfg awsv2.Config, rt http.RoundTripper, cleanup func(), initState int64)
- func NewAzureKeyVaultTestClient(ctx context.Context, t *testing.T) (*http.Client, func())
- func NewAzureTestBlobClient(ctx context.Context, t *testing.T) (*http.Client, func())
- func NewGCPClient(ctx context.Context, t *testing.T) (client *gcp.HTTPClient, rt http.RoundTripper, done func())
- func NewGCPgRPCConn(ctx context.Context, t *testing.T, endPoint, api string) (*grpc.ClientConn, func())
- func NewRecordReplayClient(ctx context.Context, t *testing.T, rf func(r *httpreplay.Recorder)) (c *http.Client, cleanup func(), initState int64)
Constants ¶
This section is empty.
Variables ¶
var Record = flag.Bool("record", false, "whether to run tests against cloud resources and record the interactions")
Record is true iff the tests are being run in "record" mode.
Functions ¶
func FakeGCPCredentials ¶ added in v0.10.0
func FakeGCPCredentials(ctx context.Context) (*google.Credentials, error)
FakeGCPCredentials gets fake GCP credentials.
func FakeGCPDefaultCredentials ¶ added in v0.12.0
FakeGCPDefaultCredentials sets up the environment with fake GCP credentials. It returns a cleanup function.
func HasDockerTestEnvironment ¶ added in v0.14.0
func HasDockerTestEnvironment() bool
HasDockerTestEnvironment returns true when either: 1) Not on Github Actions. 2) On Github's Linux environment, where Docker is available.
func NewAWSSession ¶
func NewAWSSession(ctx context.Context, t *testing.T, region string) (sess *session.Session, rt http.RoundTripper, cleanup func(), initState int64, )
NewAWSSession creates a new session for testing against AWS. If the test is in --record mode, the test will call out to AWS, and the results are recorded in a replay file. Otherwise, the session reads a replay file and runs the test as a replay, which never makes an outgoing HTTP call and uses fake credentials. An initState is returned for tests that need a state to have deterministic results, for example, a seed to generate random sequences.
func NewAWSv2Config ¶ added in v0.24.0
func NewAWSv2Config(ctx context.Context, t *testing.T, region string) (cfg awsv2.Config, rt http.RoundTripper, cleanup func(), initState int64)
NewAWSv2Config creates a new aws.Config for testing against AWS. If the test is in --record mode, the test will call out to AWS, and the results are recorded in a replay file. Otherwise, the session reads a replay file and runs the test as a replay, which never makes an outgoing HTTP call and uses fake credentials. An initState is returned for tests that need a state to have deterministic results, for example, a seed to generate random sequences.
func NewAzureKeyVaultTestClient ¶ added in v0.12.0
NewAzureKeyVaultTestClient creates a *http.Client for Azure KeyVault test recordings.
func NewAzureTestBlobClient ¶ added in v0.27.0
NewAzureTestBlobClient creates a new connection for testing against Azure Blob.
func NewGCPClient ¶
func NewGCPClient(ctx context.Context, t *testing.T) (client *gcp.HTTPClient, rt http.RoundTripper, done func())
NewGCPClient creates a new HTTPClient for testing against GCP. NewGCPClient creates a new HTTPClient for testing against GCP. If the test is in --record mode, the client will call out to GCP, and the results are recorded in a replay file. Otherwise, the session reads a replay file and runs the test as a replay, which never makes an outgoing HTTP call and uses fake credentials.
func NewGCPgRPCConn ¶
func NewGCPgRPCConn(ctx context.Context, t *testing.T, endPoint, api string) (*grpc.ClientConn, func())
NewGCPgRPCConn creates a new connection for testing against GCP via gRPC. If the test is in --record mode, the client will call out to GCP, and the results are recorded in a replay file. Otherwise, the session reads a replay file and runs the test as a replay, which never makes an outgoing RPC and uses fake credentials.
func NewRecordReplayClient ¶ added in v0.14.0
func NewRecordReplayClient(ctx context.Context, t *testing.T, rf func(r *httpreplay.Recorder)) (c *http.Client, cleanup func(), initState int64)
NewRecordReplayClient creates a new http.Client for tests. This client's activity is being either recorded to files (when *Record is set) or replayed from files. rf is a modifier function that will be invoked with the address of the httpreplay.Recorder object used to obtain the client; this function can mutate the recorder to add service-specific header filters, for example. An initState is returned for tests that need a state to have deterministic results, for example, a seed to generate random sequences.
Types ¶
This section is empty.