refrakt - v0.5.0

refrakt/testing

Test helpers for Refrakt applications.

Build test requests without a running HTTP server.

Example

import refrakt/testing

pub fn index_returns_200_test() {
  let req = testing.get("/posts")
  let resp = post_handler.index(req, test_ctx())
  resp.status |> should.equal(200)
}

Values

assert_header

</> 
pub fn assert_header(
  resp: response.Response(String),
  name: String,
  expected: String,
) -> Bool

Check that a response has a specific header value.

assert_status

</> 
pub fn assert_status(
  resp: response.Response(String),
  expected: Int,
) -> Bool

Check that a response has a specific status code.

cross_site

</> 
pub fn cross_site(
  req: request.Request(body),
  from origin: String,
) -> request.Request(body)

Mark a test request as sent by a page on another site, such as "https://evil.example". refrakt/csrf.protect rejects it with 403 unless the method is safe.

delete

</> 
pub fn delete(path: String) -> request.Request(String)

Create a DELETE request for testing.

get

</> 
pub fn get(path: String) -> request.Request(String)

Create a GET request for testing.

json_request

</> 
pub fn json_request(
  method: http.Method,
  path: String,
  body: String,
) -> request.Request(wisp.Connection)

Create a request with a JSON body, ready to pass straight to a handler.

Unlike the builders above, this returns a wisp.Request, the type handlers take. The body is a string so tests can send malformed JSON too; build valid bodies with gleam/json. The content-type header is application/json, as wisp.require_json expects.

let body = json.object([#("title", json.string("Hello"))])

testing.json_request(http.Post, "/api/posts", json.to_string(body))
|> post_handler.create(ctx)

post

</> 
pub fn post(path: String) -> request.Request(String)

Create a POST request for testing.

put

</> 
pub fn put(path: String) -> request.Request(String)

Create a PUT request for testing.

request

</> 
pub fn request(
  method: http.Method,
  path: String,
) -> request.Request(String)

Create a request with a specific method and path.

same_origin

</> 
pub fn same_origin(
  req: request.Request(body),
) -> request.Request(body)

Mark a test request as sent by a page of this app, the way a browser submits a form: sets the host header (from the request’s host, if it is missing) and a matching origin header. Unsafe requests need these to get past refrakt/csrf.protect with their cookies.

with_body

</> 
pub fn with_body(
  req: request.Request(String),
  body: String,
) -> request.Request(String)

Set the body of a test request.

with_header

</> 
pub fn with_header(
  req: request.Request(String),
  name: String,
  value: String,
) -> request.Request(String)

Add a header to a test request.

✨ Search Document