ntest 0.8.0

Testing framework for rust which enhances the built-in library with some useful features.
Documentation 
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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

# NTest


[![docs](https://docs.rs/ntest/badge.svg)](https://docs.rs/ntest)
[![crates](https://img.shields.io/badge/crates.io-ntest-orange)](https://crates.io/crates/ntest)
[![downloads](https://badgen.net/crates/d/ntest)](https://crates.io/crates/ntest)
[![build status](https://gitlab.com/becheran/ntest_ci/badges/master/pipeline.svg)](https://gitlab.com/becheran/ntest_ci/pipelines)
[![license](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Testing framework for rust which enhances the built-in library with some useful features. Inspired by the *.Net* unit-testing framework [NUnit](https://github.com/nunit/nunit).

- [documentation](https://docs.rs/ntest/)
- [library on crates.io](https://crates.io/crates/ntest)

## Getting Started


Some functions of *NTest* use [procedural macros](https://doc.rust-lang.org/reference/procedural-macros.html) which are stable for rust edition 2018.
If you use the library make sure that you are using the *2018 version* of rust. Update the *Cargo.toml* file:

```toml
[package]
edition = "2018"
# ..

```

Add the *NTest library* to your developer dependencies in the *Cargo.toml* file:

```toml
[dev-dependencies]
ntest = "*"
```

## Content


- `#[timeout()]` Attribute used for timeouts in tests.
- `#[test_case()]` Attribute used to define multiple test cases for a test function.
- `assert_about_equal!()` Compare two floating point values or vectors for equality.
- `assert_false!()` Expects false argument for test case.
- `assert_true!()` Expects true argument for test case.
- `assert_panics!()` Expects block to panic. Otherwise the test fails.

For more information read the [documentation](https://docs.rs/ntest/).

## Examples


### Create test cases


```rust
use ntest::test_case;

#[test_case("https://doc.rust-lang.org.html")]

#[test_case("http://www.website.php", name="important_test")]

fn test_http_link_types(link: &str) {
    test_link(link, &LinkType::HTTP);
}
```

### Timeout for long running functions


```rust
use ntest::timeout;

#[test]

#[timeout(10)]

#[should_panic]

fn timeout() {
    loop {};
}
```

### Combine attributes


```rust
use std::{thread, time};
use ntest::timeout;
use ntest::test_case;

#[test_case(200)]

#[timeout(100)]

#[should_panic]

#[test_case(10)]

#[timeout(100)]

fn test_function(i : u32) {
    let sleep_time = time::Duration::from_millis(i);
    thread::sleep(sleep_time);
}
```

## License


This project is licensed under the MIT License - see the [LICENSE](https://github.com/becheran/ntest/blob/master/LICENSE) file for details.