apitesting

type APITest struct {
	// GetHTTPHandler returns an http.Handler (e.g. *gin.Engine) which will be bootstrapped with httptest
	// Only one of GetHTTPHandler and APIEndpointURL should be provided
	GetHTTPHandler func(ctx context.Context, t *testing.T) http.Handler
	// APIEndpointURL is the HTTP endpoint to send the HTTP calls to
	// Only one of GetHTTPHandler and APIEndpointURL should be provided
	APIEndpointURL string
	//
	// A function that will run once before any tests execute.
	SetupTest func(ctx context.Context, t *testing.T)
	// A function that will run once after all tests have run (optional)
	TeardownTest func(ctx context.Context, t *testing.T)
	// A function that will run before each test case (i.e. before each element in the []ApiTestCase passed to RunTests)
	SetupTestCase func(ctx context.Context, t *testing.T, tc APITestCase)
	// A function that will run after each test case
	TeardownTestCase func(ctx context.Context, t *testing.T, tc APITestCase)
	// A Context object that can be used to maintain context between tests/test cases
	Ctx context.Context
	// contains filtered or unexported fields
}

type APITestCase struct {
	// Description of the test case
	Name string
	// HTTP Request type (e.g. "POST", "GET")
	ReqType string
	// A function that returns the path to the resource to call (e.g. /v1/product or /v1/product/<uuid> etc)
	ResourcePath func(ctx context.Context, t *testing.T) string
	// A function that will be run immediately before the testcase request is sent
	BeforeRequest func(ctx context.Context, t *testing.T, e *httpexpect.Expect)
	// A function that returns the request headers (will be sent via "WithHeaders")
	PopulateHeaders func(ctx context.Context, t *testing.T) map[string]string
	// A function that returns the request query parameters (will be sent via "WithQuery")
	PopulateQueryParams func(ctx context.Context, t *testing.T) map[string]string
	// A function that returns the request cookies (will be sent via "WithCookies")
	PopulateCookies func(ctx context.Context, t *testing.T) map[string]string
	// Expected HTTP status code from the API call
	ExpHTTPStatus int
	// A function that returns a struct to send to the request via "WithJSON". Leave out if you don't need a JSON body
	PopulateJSON func(ctx context.Context, t *testing.T) interface{}
	// A function that validates the response. This should call t.Error as appropriate. Leave out if you don't need to validate.
	ValidateResponse func(ctx context.Context, t *testing.T, resp *httpexpect.Response) context.Context
	// A function that will be run immediately after the testcase validation
	AfterValidate func(ctx context.Context, t *testing.T, e *httpexpect.Expect)
}