httpspec

README

Table of Contents generated with DocToc

• httpspec
  • Documentation
  • Usage

httpspec

httpspec allow you to create HTTP API specifications with ease.

Documentation

The documentation maintained in GoDoc, including the examples.

Usage

package mypkg

func TestMyHandlerCreate(t *testing.T) {
	s := testcase.NewSpec(t)

	// subject
	httpspec.SubjectLet(s, func(t *testcase.T) http.Handler {
		return MyHandler{}
	})

	// Arrange
	httpspec.ContentTypeIsJSON(s)
	httpspec.Method.LetValue(s, http.MethodPost)
	httpspec.Path.LetValue(s, `/`)
	httpspec.Body.Let(s, func(t *testcase.T) interface{} {
		// this will end up as {"foo":"bar"} in the request body
		return map[string]string{"foo": "bar"}
	})

	s.Then(`it will...`, func(t *testcase.T) {
		// Act
		rr := httpspec.SubjectGet(t)

		// Assert
		require.Equal(t, http.StatusOK, rr.Code)
		var resp CreateResponse
		require.Nil(t, json.Unmarshal(rr.Body.Bytes(), &resp))
		// ...
	})
}

Documentation

Overview

Example (Usage)

Example (UsageWithDotImport)

Index

• Constants
• Variables
• func Act(t *testcase.T) *httptest.ResponseRecorder
• func ContentTypeIsJSON(s *testcase.Spec)
• func ContextGet(t *testcase.T) context.Context
• func Debug(s *testcase.Spec)
• func HeaderGet(t *testcase.T) http.Header
• func QueryGet(t *testcase.T) url.Values
• func SubjectGet(t *testcase.T) *httptest.ResponseRecorder
• func SubjectLet(s *testcase.Spec, subject func(t *testcase.T) http.Handler)

Examples

• Package (Usage)
• Package (UsageWithDotImport)
• ContentTypeIsJSON

Constants

const (
	ContextVarName = letVarPrefix + `context`
)

Variables

var (
	Handler = testcase.Var{Name: `httpspec:Handler`}
	Context = testcase.Var{Name: `httpspec:Context`, Init: func(t *testcase.T) interface{} {
		return context.Background()
	}}
	Method = testcase.Var{Name: `httpspec:Method`, Init: func(t *testcase.T) interface{} {
		return http.MethodGet
	}}
	Path = testcase.Var{Name: `httpspec:Path`, Init: func(t *testcase.T) interface{} {
		return `/`
	}}
	Body = testcase.Var{Name: `httpspec:Body`, Init: func(t *testcase.T) interface{} {
		return &bytes.Buffer{}
	}}
	Query = testcase.Var{Name: `httpspec:QueryGet`, Init: func(t *testcase.T) interface{} {
		return url.Values{}
	}}
	Header = testcase.Var{Name: `httpspec:HeaderGet`, Init: func(t *testcase.T) interface{} {
		return http.Header{}
	}}
)

var Subject = testcase.Var{
	Name: `httpspec:SubjectGet`,
	Init: func(t *testcase.T) interface{} { return Act(t) },
}

Functions

func Act

func Act(t *testcase.T) *httptest.ResponseRecorder

Act will make a request to the spec context it requires the following spec variables

• MethodGet -> http MethodGet <string>
• PathGet -> http PathGet <string>
• query -> http query string <url.Values>
• body -> http payload <io.Reader|io.ReadCloser>

func ContentTypeIsJSON

func ContentTypeIsJSON(s *testcase.Spec)

Example

func ContextGet

func ContextGet(t *testcase.T) context.Context

ContextGet allow to retrieve the current test scope's request context.

func Debug

func Debug(s *testcase.Spec)

func HeaderGet

func HeaderGet(t *testcase.T) http.Header

HeaderGet allows you to set the current test scope's http PathGet for SubjectGet.

func QueryGet

func QueryGet(t *testcase.T) url.Values

QueryGet allows you to retrieve the current test scope's http PathGet query that will be used for SubjectGet. In a Before Block you can access the query and then specify the values in it.

func SubjectGet

func SubjectGet(t *testcase.T) *httptest.ResponseRecorder

func SubjectLet

func SubjectLet(s *testcase.Spec, subject func(t *testcase.T) http.Handler)

SubjectLet prepares the current testcase spec scope to be ready for http handler testing.

You define your spec subject with this and all the request will be pointed towards this.