precept 0.3.0

A testing utility for fuzzing and fault injection to discover erroneous and interesting states.
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

<h1 align="center">Precept</h1>
<p align="center">
  <a href="https://docs.rs/precept"><img alt="docs.rs" src="https://img.shields.io/docsrs/precept"></a>
  &nbsp;
  <a href="https://github.com/orbitinghail/precept/actions"><img alt="Build Status" src="https://img.shields.io/github/actions/workflow/status/orbitinghail/precept/rust.yml"></a>
  &nbsp;
  <a href="https://crates.io/crates/precept"><img alt="crates.io" src="https://img.shields.io/crates/v/precept.svg"></a>
</p>

This crate is designed to be used in testing and development to aid in finding interesting and erroneous states. It can be used in concert with a guidance system to provide high signal fuzz testing.

The crate offers a few features:

1. expectations: a set of macros that can be used to check that the program reaches certain states, and that those states are valid. these macros do not cause the program to crash like an assert would. rather they are emitted to a configured collector for later analysis or a configured guidance system to assist with fuzz testing. notably, these macros support tracking when a state is never reached is extremely helpful for automated fuzzing and verifying test correctness

2. simulation: wrappers around time and randomness to support fast forwarding and better control over randomness when run within a guidance system

3. fault injection: a fault injection system that allows a guidance system to trigger custom faults in a controlled manner

## Credits

Precept is heavily inspired by the official [Antithesis Rust SDK].

[Antithesis Rust SDK]: https://github.com/antithesishq/antithesis-sdk-rust/

## 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.

[LICENSE-APACHE]: ./LICENSE-APACHE
[LICENSE-MIT]: ./LICENSE-MIT

### Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you shall be dual licensed as above, without any
additional terms or conditions.