Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/becheran/ntest
Testing framework for rust enhancing the built-in library with some useful features.
https://github.com/becheran/ntest
assert library rust rust-lang test-cases testing timeout
Last synced: about 2 months ago
JSON representation
Testing framework for rust enhancing the built-in library with some useful features.
- Host: GitHub
- URL: https://github.com/becheran/ntest
- Owner: becheran
- License: mit
- Created: 2019-12-29T14:37:24.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-06-19T05:30:24.000Z (3 months ago)
- Last Synced: 2024-06-22T00:27:13.526Z (3 months ago)
- Topics: assert, library, rust, rust-lang, test-cases, testing, timeout
- Language: Rust
- Size: 138 KB
- Stars: 52
- Watchers: 2
- Forks: 11
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-rust-testing - ntest - Testing framework for rust enhancing the built-in library with some useful features (Crates / Extensions)
README
# NTest
[](https://docs.rs/ntest)
[](https://crates.io/crates/ntest)
[](https://crates.io/crates/ntest)
[](https://github.com/becheran/ntest/actions/workflows/ci.yml)
[](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).
## 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);
}
```