test

Documentation

Overview

Package test contains simple test helpers that should not have any dependencies on horizon's packages. think constants, custom matchers, generic helpers etc.

Index

• func Context() context.Context
• func RequestHelperRaw(r *http.Request)
• func RequestHelperStreaming(r *http.Request)
• func ResetHorizonDB(t *testing.T, db *sqlx.DB)
• type Assertions
  • func (a *Assertions) PageOf(length int, body *bytes.Buffer) bool
  • func (a *Assertions) Problem(body *bytes.Buffer, expected problem.P) bool
  • func (a *Assertions) ProblemType(body *bytes.Buffer, typ string) bool
• type RequestHelper
  • func NewRequestHelper(router *chi.Mux) RequestHelper
• type StaticMockServer
  • func NewStaticMockServer(response string) *StaticMockServer
• type T
  • func Start(t *testing.T) *T
  • func (t *T) CoreSession() *db.Session
  • func (t *T) Finish()
  • func (t *T) HorizonSession() *db.Session
  • func (t *T) LoadLedgerStatus() ledger.Status
  • func (t *T) Scenario(name string) ledger.Status
  • func (t *T) ScenarioWithoutHorizon(name string) ledger.Status
  • func (t *T) UnmarshalExtras(r io.Reader) map[string]string
  • func (t *T) UnmarshalNext(r io.Reader) string
  • func (t *T) UnmarshalPage(r io.Reader, dest interface{}) hal.Links

Functions

func Context

func Context() context.Context

Context provides a context suitable for testing in tests that do not create a full App instance (in which case your tests should be using the app's context). This context has a logger bound to it suitable for testing.

func RequestHelperRaw

func RequestHelperRaw(r *http.Request)

func RequestHelperStreaming

func RequestHelperStreaming(r *http.Request)

func ResetHorizonDB

func ResetHorizonDB(t *testing.T, db *sqlx.DB)

ResetHorizonDB sets up a new horizon database with empty tables

Types

type Assertions

type Assertions struct {
	*assert.Assertions
}

Assertions provides an assertions helper. Custom assertions for this package can be defined as methods on this struct. foo

func (*Assertions) PageOf

func (a *Assertions) PageOf(length int, body *bytes.Buffer) bool

func (*Assertions) Problem

func (a *Assertions) Problem(body *bytes.Buffer, expected problem.P) bool

Problem asserts that `body` is a serialized problem equal to `expected`, using Type and Status to compare for equality.

func (*Assertions) ProblemType

func (a *Assertions) ProblemType(body *bytes.Buffer, typ string) bool

ProblemType asserts that the provided `body` is a JSON serialized problem whose type is `typ`

type RequestHelper

type RequestHelper interface {
	Get(string, ...func(*http.Request)) *httptest.ResponseRecorder
	Post(string, url.Values, ...func(*http.Request)) *httptest.ResponseRecorder
}

func NewRequestHelper

func NewRequestHelper(router *chi.Mux) RequestHelper

type StaticMockServer

type StaticMockServer struct {
	*httptest.Server
	LastRequest *http.Request
}

StaticMockServer is a test helper that records it's last request

func NewStaticMockServer

func NewStaticMockServer(response string) *StaticMockServer

NewStaticMockServer creates a new mock server that always responds with `response`

type T

type T struct {
	T          *testing.T
	Assert     *assert.Assertions
	Require    *require.Assertions
	Ctx        context.Context
	HorizonDB  *sqlx.DB
	CoreDB     *sqlx.DB
	EndLogTest func() []logrus.Entry
}

T provides a common set of functionality for each test in horizon

func Start

func Start(t *testing.T) *T

Start initializes a new test helper object, a new instance of log, and conceptually "starts" a new test

func (*T) CoreSession

func (t *T) CoreSession() *db.Session

CoreSession returns a db.Session instance pointing at the stellar core test database

func (*T) Finish

func (t *T) Finish()

Finish finishes the test, logging any accumulated horizon logs to the logs output

func (*T) HorizonSession

func (t *T) HorizonSession() *db.Session

HorizonSession returns a db.Session instance pointing at the horizon test database

func (*T) LoadLedgerStatus

func (t *T) LoadLedgerStatus() ledger.Status

LoadLedgerStatus loads ledger state from the core db(or panicing on failure).

func (*T) Scenario

func (t *T) Scenario(name string) ledger.Status

Scenario loads the named sql scenario into the database

func (*T) ScenarioWithoutHorizon

func (t *T) ScenarioWithoutHorizon(name string) ledger.Status

ScenarioWithoutHorizon loads the named sql scenario into the database

func (*T) UnmarshalExtras

func (t *T) UnmarshalExtras(r io.Reader) map[string]string

UnmarshalExtras extracts and returns extras content

func (*T) UnmarshalNext

func (t *T) UnmarshalNext(r io.Reader) string

UnmarshalNext extracts and returns the next link

func (*T) UnmarshalPage

func (t *T) UnmarshalPage(r io.Reader, dest interface{}) hal.Links

UnmarshalPage populates dest with the records contained in the json-encoded page in r