Grillon

Grillon offers an elegant and natural way to approach API testing in Rust.

• Elegant, intuitive and expressive API
• Built-in testing functions
• Extensible

Please note that the API is subject to a lot of changes until the v1.0.0.

Documentation

• Book (current | dev)
• API doc
• Changelog

Getting started

This example uses Tokio as asynchronous runtime. Generally, testing libs are used in unit or integration tests. You can declare grillon as a dev-dependency.

Add grillon to Cargo.toml

toml [dev-dependencies] grillon = "0.5.0-alpha.1" tokio = { version = "1", features = ["macros"] }

Then use grillon :

```rust use grillon::{dsl::, dsl::http::, json, Grillon, StatusCode, Result}; use grillon::header::{HeaderValue, CONTENTLENGTH, CONTENTTYPE};

[tokio::test]

async fn endtoendtest() -> Result<()> { Grillon::new("https://jsonplaceholder.typicode.com")? .post("posts") .payload(json!({ "title": "foo", "body": "bar", "userId": 1 })) .assert() .await .status(issuccess()) .status(is(201)) .responsetime(islessthan(700)) .jsonbody(is(json!({ "id": 101, }))) .jsonbody(schema(json!({ "properties": { "id": { "type": "number" } } }))) .jsonpath("$.id", is(json!(101))) .headers(contains(vec![ ( CONTENTTYPE, HeaderValue::fromstatic("application/json; charset=utf-8"), ), (CONTENTLENGTH, HeaderValue::fromstatic("15")), ])) .assertfn(|assert| { assert!(!assert.headers.isempty()); assert!(assert.status == StatusCode::CREATED); assert!(assert.json.is_some());

        println!("Json response : {:#?}", assert.json);
    });

Ok(())

} ```