nats_test_server 0.2.0

An intentionally buggy NATS server that facilitates fault injection for testing error paths in NATS-based libraries
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

# Test server

A test NATS server for testing the NATS rust client and applications using it. Allows injection of bugsand useful for testing a number of things.

## Example usage

```rust
#[test]
fn test_use_nats() {
  let nats = NatsTestServer::build().spawn();

  let my_component1 = component(nats.address())
  let my_component2 = component(nats.address())

  // test component behaviour

  let nats = nats.restart().spawn();

  // test behaviour after restart
} // server is stopped on drop

#[test]
fn test_use_buggy_nats() {
  let nats = NatsTestServer::build().bugginess(400).spawn(); // a 1/400 chance of restarting on any given message

  // bugginess test
}
```

## Limitations

The test server currently expects being used to test a single connection - so with multiple connections you will get some unexpected results:
* subscriptions of one client will be seen by all the others
* `hop_ports` doesn't make any sense for multiple clients