bddkit 0.2.2

Gherkin acceptance testing for backend services: one binary drives the HTTP API and the resources behind it
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

use crate::world::World;

pub fn set_header(w: &mut World, name: &str, value: &str) -> Result<(), String> {
    w.http.set_header(name, value);
    Ok(())
}

/// Argument order matches `set_header`. The step text names them in
/// reverse order — the swap happens on the dispatcher side, in one place.
pub fn add_header(w: &mut World, name: &str, value: &str) -> Result<(), String> {
    w.http.add_header(name, value);
    Ok(())
}

pub fn set_query(w: &mut World, name: &str, value: &str) -> Result<(), String> {
    w.http.set_query(name, value);
    Ok(())
}

pub fn set_body(w: &mut World, docstring: Option<&String>) -> Result<(), String> {
    let b = docstring.ok_or("step `the request body is:` requires a doc string")?;
    w.http.set_body(b.clone());
    Ok(())
}

pub fn clear_body(w: &mut World) -> Result<(), String> {
    w.http.clear_body();
    Ok(())
}

pub fn set_form(w: &mut World, table: Option<&Vec<Vec<String>>>) -> Result<(), String> {
    let rows = table.ok_or("step `the request form parameters are:` requires a table")?;
    let head = rows.first().ok_or("table is empty")?;
    if head.len() != 2 || head[0] != "name" || head[1] != "value" {
        return Err("table must have exactly two columns: name | value".into());
    }
    let pairs = rows[1..]
        .iter()
        .map(|r| (r[0].clone(), r[1].clone()))
        .collect();
    w.http.set_form(pairs);
    Ok(())
}

pub async fn request(w: &mut World, path: &str, method: &str) -> Result<(), String> {
    w.http.send(path, method).await
}

/// Records Hawk credentials for the next `I request ...` only; it does not
/// sign anything itself. `HttpState::send` consumes them.
pub fn sign_next_request_with_hawk(w: &mut World, id: &str, key: &str) -> Result<(), String> {
    w.http.sign_next(id, key);
    Ok(())
}

/// Switches the scenario's current API. An error if the name is not declared.
pub fn use_api(w: &mut World, name: &str) -> Result<(), String> {
    w.http.use_api(name)
}