test

Documentation

Overview

Utility functions to help writing tests for a Go-Json-Rest app

Go comes with net/http/httptest to help writing test for an http server. When this http server implements a JSON REST API, some basic checks end up to be always the same. This test package tries to save some typing by providing helpers for this particular use case.

package main

import (
        "github.com/ant0ine/go-json-rest/rest"
        "github.com/ant0ine/go-json-rest/rest/test"
        "testing"
)

func TestSimpleRequest(t *testing.T) {
        api := rest.NewApi()
        api.Use(rest.DefaultDevStack...)
        router, err := rest.MakeRouter(
                rest.Get("/r", func(w rest.ResponseWriter, r *rest.Request) {
                        w.WriteJson(map[string]string{"Id": "123"})
                }),
        )
        if err != nil {
               log.Fatal(err)
        }
        api.SetApp(router)
        recorded := test.RunRequest(t, api.MakeHandler(),
                test.MakeSimpleRequest("GET", "http://1.2.3.4/r", nil))
        recorded.CodeIs(200)
        recorded.ContentTypeIsJson()
}

Index

• func BodyIs(t *testing.T, r *httptest.ResponseRecorder, expectedBody string)
• func CodeIs(t *testing.T, r *httptest.ResponseRecorder, expectedCode int)
• func ContentEncodingIsGzip(t *testing.T, r *httptest.ResponseRecorder)
• func ContentTypeIsJson(t *testing.T, r *httptest.ResponseRecorder)
• func DecodeJsonPayload(r *httptest.ResponseRecorder, v interface{}) error
• func HeaderIs(t *testing.T, r *httptest.ResponseRecorder, headerKey, expectedValue string)
• func MakeSimpleRequest(method string, urlStr string, payload interface{}) *http.Request
• type Recorded
  • func RunRequest(t *testing.T, handler http.Handler, request *http.Request) *Recorded
  • func (rd *Recorded) BodyIs(expectedBody string)
  • func (rd *Recorded) CodeIs(expectedCode int)
  • func (rd *Recorded) ContentEncodingIsGzip()
  • func (rd *Recorded) ContentTypeIsJson()
  • func (rd *Recorded) DecodeJsonPayload(v interface{}) error
  • func (rd *Recorded) HeaderIs(headerKey, expectedValue string)

Functions

func BodyIs

func BodyIs(t *testing.T, r *httptest.ResponseRecorder, expectedBody string)

func CodeIs

func CodeIs(t *testing.T, r *httptest.ResponseRecorder, expectedCode int)

CodeIs compares the rescorded status code

func ContentEncodingIsGzip

func ContentEncodingIsGzip(t *testing.T, r *httptest.ResponseRecorder)

func ContentTypeIsJson

func ContentTypeIsJson(t *testing.T, r *httptest.ResponseRecorder)

func DecodeJsonPayload

func DecodeJsonPayload(r *httptest.ResponseRecorder, v interface{}) error

func HeaderIs

func HeaderIs(t *testing.T, r *httptest.ResponseRecorder, headerKey, expectedValue string)

HeaderIs tests the first value for the given headerKey

func MakeSimpleRequest

func MakeSimpleRequest(method string, urlStr string, payload interface{}) *http.Request

MakeSimpleRequest returns a http.Request. The returned request object can be further prepared by adding headers and query string parmaters, for instance.

Types

type Recorded

type Recorded struct {
	T        *testing.T
	Recorder *httptest.ResponseRecorder
}

func RunRequest

func RunRequest(t *testing.T, handler http.Handler, request *http.Request) *Recorded

RunRequest runs a HTTP request through the given handler

func (*Recorded) BodyIs

func (rd *Recorded) BodyIs(expectedBody string)

func (*Recorded) CodeIs

func (rd *Recorded) CodeIs(expectedCode int)

func (*Recorded) ContentEncodingIsGzip

func (rd *Recorded) ContentEncodingIsGzip()

func (*Recorded) ContentTypeIsJson

func (rd *Recorded) ContentTypeIsJson()

func (*Recorded) DecodeJsonPayload

func (rd *Recorded) DecodeJsonPayload(v interface{}) error

func (*Recorded) HeaderIs

func (rd *Recorded) HeaderIs(headerKey, expectedValue string)