Crate caramelo 

caramelo

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

Features

Several useful matchers:

• logical: eq, ne, le, lt, ge and gt
• range: between
• array: item, len
• wildcard: any
• string: contains, starts-with, ends-with

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-beta.1" }

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

Modules

assertions

Module containing assertions

matchers

Module containing matchers for assertions

Structs

Expect

Main expectation struct for assertions

Enums

MatchType

Enum representing the type of match operation

Traits

Matcher

Trait for matchers used in assertions

Functions

expect

Function to create a new expectation