donut.endpoint.test.harness — party.donut/endpoint-test 0.0.18

Includes:

• Macros and a fixture for dealing with a system for the duration of a test
• Helpers for composing and dispatching requests
• read-body multimethod for parsing response bodies of different types (transit, json etc)
• assertions that work with response segments

*system* clj

comparison-entities clj

(comparison-entities test-ent-attrs resp-data)

Returns a set that can be used to test if test-ent-attrs is contained in a response

ConfigurationComponentGroup clj

configured-instance clj

(configured-instance human-name component-config-id)

Look up a component instance that has path configured by the ::config component group

configured-value clj

(configured-value config-key)

Look up a component instance that has path configured by the ::config component group

contains-entity? clj

(contains-entity? resp-data test-ent-attrs)

Request's response data creates entity of type ent-type that has key/value pairs identical to test-ent-attrs.

content-type-request clj

(content-type-request method path-or-route-name content-type)

(content-type-request method path-or-route-name params content-type)

content-type-request* clj multimethod

Entities clj

Entity clj

handle-request clj

(handle-request method path-or-route-name & args)

Perform a request with the system's root handler

handler clj

(handler)

The endpoint handler.

headers clj

(headers req headers)

Add all headers to request

instance clj

(instance component-id & [err-msg])

Look up component instance in current test system

Path clj protocol

path clj

(path this)

prep-comparison clj

(prep-comparison resp-entity test-ent-attrs)

When testing whether a response contains test-ent-attrs, we modify a response entity by:

1. selecting only the keys that are present in test-ent-attrs. This allows us to do an = comparison that won't fail if the response entity contains attributes we don't want to test.

2. Putting the result in a map to handle case where resp-entity is a record.

read-body clj multimethod

Read body according to content type

request clj

(request method path-or-route-name)

(request method path-or-route-name params-or-content-type)

(request method path-or-route-name params content-type)

Response clj

response-entities clj

(response-entities resp-data)

Walk response data and return all entities from entity segments

route-path clj

(route-path route-name)

(route-path route-name route-params)

(route-path route-name route-params query-params)

router clj

(router)

The endpoint router.

Segment clj

Segments clj

system clj

(system)

more assertive system retrieval

system-fixture clj

(system-fixture {:keys [system-name custom-config]})

To be used with use-fixtures

with-system clj macro

(with-system {:keys [system-name custom-config]} & body)

Bind dynamic system var to a test system.