caramelo

Crates.io MSRV

Caramelo (caramel in Portuguese) is a comprehensive, production-ready unit testing framework for Rust with a focus on simplicity and ease of use.

Features

Matchers

logical: eq, ne, le, lt, ge and gt
range: in_inc, in_exc
array: item, len, _in_
wildcard: any
string: contains, starts-with, ends-with
http: method, path, header, header_value, body
json: exact_json_body, partial_json_body
xml: exact_xml_body, partial_xml_body

Assertion traits

is, is_eq, is_ne, is_lt, is_le, is_gt and is_ge

Quick Start

Add caramelo to your Cargo.toml:

caramelo = { version = "0.1.0" }

Feature flags

http - Enable HTTP matchers
json - Enable JSON matchers
xml - Enable XML matchers

Usage Example

Here's how simple it is to create unit tests with caramelo:

use caramelo::{expect, matchers::eq, assertions::Is};

/// Test equality matcher

#[test]
fn test_equal() {
    expect(1).to_be(eq(1));
}

#[test]
#[should_panic(expected = "Expected 1 to be equals to 2")]
fn test_not_equal() {
    expect(1).to_be(eq(2));
}

/// Test is assertion

#[test]
fn test_is() {
    "a".is("a");
}

#[test]
#[should_panic(expected = "Expected a to be equal to b")]
fn test_is_panic() {
    "a".is("b");
}

License

Licensed under either of

Apache License, Version 2.0 (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT)

at your option.

Author

Rogerio Pereira Araujo rogerio.araujo@gmail.com

caramelo 0.1.1-beta.2