http

Documentation

Index

• func AwaitConvergence(t *testing.T, threshold int, maxTimeToConsistency time.Duration, ...)
• func CompareRequest(t *testing.T, req *roundtripper.Request, cReq *roundtripper.CapturedRequest, ...) error
• func ExpectMirroredRequest(t *testing.T, client client.Client, clientset clientset.Interface, ...)
• func MakeRequest(t *testing.T, expected *ExpectedResponse, gwAddr, protocol, scheme string) roundtripper.Request
• func MakeRequestAndExpectEventuallyConsistentResponse(t *testing.T, r roundtripper.RoundTripper, timeoutConfig config.TimeoutConfig, ...)
• func WaitForConsistentResponse(t *testing.T, r roundtripper.RoundTripper, req roundtripper.Request, ...)
• type ExpectedRequest
• type ExpectedResponse
  • func (er *ExpectedResponse) GetTestCaseName(i int) string
• type Request
• type Response

Functions

func AwaitConvergence

func AwaitConvergence(t *testing.T, threshold int, maxTimeToConsistency time.Duration, fn func(elapsed time.Duration) bool)

AwaitConvergence runs the given function until it returns 'true' `threshold` times in a row. Each failed attempt has a 1s delay; successful attempts have no delay.

func CompareRequest

func CompareRequest(t *testing.T, req *roundtripper.Request, cReq *roundtripper.CapturedRequest, cRes *roundtripper.CapturedResponse, expected ExpectedResponse) error

func ExpectMirroredRequest

func ExpectMirroredRequest(t *testing.T, client client.Client, clientset clientset.Interface, ns, mirrorPod, path string)

func MakeRequest

func MakeRequest(t *testing.T, expected *ExpectedResponse, gwAddr, protocol, scheme string) roundtripper.Request

func MakeRequestAndExpectEventuallyConsistentResponse

func MakeRequestAndExpectEventuallyConsistentResponse(t *testing.T, r roundtripper.RoundTripper, timeoutConfig config.TimeoutConfig, gwAddr string, expected ExpectedResponse)

MakeRequestAndExpectEventuallyConsistentResponse makes a request with the given parameters, understanding that the request may fail for some amount of time.

Once the request succeeds consistently with the response having the expected status code, make additional assertions on the response body using the provided ExpectedResponse.

func WaitForConsistentResponse

func WaitForConsistentResponse(t *testing.T, r roundtripper.RoundTripper, req roundtripper.Request, expected ExpectedResponse, threshold int, maxTimeToConsistency time.Duration)

WaitForConsistentResponse repeats the provided request until it completes with a response having the expected response consistently. The provided threshold determines how many times in a row this must occur to be considered "consistent".

Types

type ExpectedRequest

type ExpectedRequest struct {
	Request

	// AbsentHeaders are names of headers that are expected
	// *not* to be present on the request.
	AbsentHeaders []string
}

ExpectedRequest defines expected properties of a request that reaches a backend.

type ExpectedResponse

type ExpectedResponse struct {
	// Request defines the request to make.
	Request Request

	// ExpectedRequest defines the request that
	// is expected to arrive at the backend. If
	// not specified, the backend request will be
	// expected to match Request.
	ExpectedRequest *ExpectedRequest

	RedirectRequest *roundtripper.RedirectRequest

	// BackendSetResponseHeaders is a set of headers
	// the echoserver should set in its response.
	BackendSetResponseHeaders map[string]string

	// Response defines what response the test case
	// should receive.
	Response Response

	Backend   string
	Namespace string

	// MirroredTo is the destination pod of the mirrored request.
	MirroredTo string

	// User Given TestCase name
	TestCaseName string
}

ExpectedResponse defines the response expected for a given request.

func (*ExpectedResponse) GetTestCaseName

func (er *ExpectedResponse) GetTestCaseName(i int) string

GetTestCaseName gets the user-defined test case name or generates one from expected response to a given request.

type Request

type Request struct {
	Host             string
	Method           string
	Path             string
	Headers          map[string]string
	UnfollowRedirect bool
	Protocol         string
}

Request can be used as both the request to make and a means to verify that echoserver received the expected request. Note that multiple header values can be provided, as a comma-separated value.

type Response

type Response struct {
	StatusCode    int
	Headers       map[string]string
	AbsentHeaders []string
}

Response defines expected properties of a response from a backend.