# caramelo

**Caramelo** is a comprehensive, production-ready unit testing framework for Rust with a focus on simplicity and ease of use.

## Installation

```toml
[dependencies]
caramelo = { version = "0.1.0" }
```

## Basic usage:

```rust
use caramelo::{expect, matchers::eq};

#[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));
}
```

## Crates

| Crate | Description | Documentation |
|-------|-------------|---------------|
| [caramelo](./caramelo) | Core testing framework | [![docs.rs](https://img.shields.io/docsrs/caramelo/latest)](https://docs.rs/caramelo) |
| [caramelo-macros](./caramelo-macros) | Convenience macros | [![docs.rs](https://img.shields.io/docsrs/caramelo-macros/latest)](https://docs.rs/caramelo-macros) |

## Blog Posts

- [Caramelo - Unit testing made easy](https://www.linkedin.com/pulse/caramelo-unit-testing-made-easy-rog%C3%A9rio-pereira-araujo-mba-m2osf/)
