goahttpcheck

README

goahttpcheck

A test helper for testing endpoints of APIs generated by Goa v3. This makes it possible to test endpoints using ivpusic/httpcheck.

Usage

1. New checker.
2. Set the method handler constructor, mounter, and method endpoint in the checker.
3. Register the middleware with the checker's Use method (If any).
4. Call checker's Test method and test by ivpusic/httpcheck way.

Example

see. https://github.com/ikawaha/goahttpcheck/blob/master/testdata/calc_test.go

Design

var _ = Service("calc", func() {
	Description("The calc service performs operations on numbers.")
	Method("add", func() {
		Payload(func() {
			Field(1, "a", Int, "Left operand")
			Field(2, "b", Int, "Right operand")
			Required("a", "b")
		})
		Result(Int)
		HTTP(func() {
			GET("/add/{a}/{b}")
			Response(StatusOK)
		})
	})

Tests

import (
...
	"calc/gen/calc"
	"calc/gen/http/calc/server"
)

func TestCalcsrvc_Add(t *testing.T) {
	checker := goahttpcheck.New()
	var logger log.Logger
	checker.Mount(server.NewAddHandler, server.MountAddHandler, calc.NewAddEndpoint(NewCalc(&logger)))

	// see. https://github.com/ikawaha/httpcheck
	checker.Test(t, http.MethodGet, "/add/1/2").
		Check().
		HasStatus(http.StatusOK).
		Cb(func(r *http.Response) {
			b, err := ioutil.ReadAll(r.Body)
			if err != nil {
				t.Fatalf("unexpected error, %v", err)
			}
			r.Body.Close()
			if got, expected := strings.TrimSpace(string(b)), "3"; got != expected {
				t.Errorf("got %+v, expected %v", b, expected)
			}
		})
}

Blog: http://ikawaha.hateblo.jp/entry/2019/12/03/154521

---

License MIT

Documentation

Index

• type APIChecker
  • func New(options ...Option) *APIChecker
  • func (c *APIChecker) Mount(builder HandlerBuilder, mounter HandlerMounter, endpoint goa.Endpoint, ...)
  • func (c APIChecker) Test(t *testing.T, method, path string) *httpcheck.Checker
  • func (c *APIChecker) Use(middleware func(http.Handler) http.Handler)
• type HandlerBuilder
• type HandlerMounter
• type Option
  • func Decoder(dec decoder) Option
  • func Encoder(enc encoder) Option
  • func ErrorHandler(eh errorHandler) Option
  • func Formatter(fm formatter) Option
  • func Muxer(mux goahttp.Muxer) Option

Types

type APIChecker

type APIChecker struct {
	Mux          goahttp.Muxer
	Middleware   []middleware
	Decoder      decoder
	Encoder      encoder
	ErrorHandler errorHandler
	Formatter    formatter
}

APIChecker represents the API checker.

func New

func New(options ...Option) *APIChecker

New constructs API checker.

func (*APIChecker) Mount

func (c *APIChecker) Mount(builder HandlerBuilder, mounter HandlerMounter, endpoint goa.Endpoint, middlewares ...middleware)

Mount mounts the endpoint handler.

func (APIChecker) Test

func (c APIChecker) Test(t *testing.T, method, path string) *httpcheck.Checker

Test returns a http checker that tests the endpoint. see. https://github.com/ikawaha/httpcheck/

func (*APIChecker) Use

func (c *APIChecker) Use(middleware func(http.Handler) http.Handler)

Use sets the middleware.

type HandlerBuilder

type HandlerBuilder func(goa.Endpoint, goahttp.Muxer, decoder, encoder, errorHandler, formatter) http.Handler

HandlerBuilder represents the goa http handler builder.

type HandlerMounter

type HandlerMounter func(goahttp.Muxer, http.Handler)

HandlerMounter represents the goa http handler mounter.

type Option

type Option func(c *APIChecker)

Option represents options for API checker.

func Decoder

func Decoder(dec decoder) Option

Decoder sets the decoder.

func Encoder

func Encoder(enc encoder) Option

Encoder sets the encoder.

func ErrorHandler

func ErrorHandler(eh errorHandler) Option

ErrorHandler sets the error handler.

func Formatter

func Formatter(fm formatter) Option

Formatter sets the error handler.

func Muxer

func Muxer(mux goahttp.Muxer) Option

Muxer sets the goa http multiplexer.