boitalettres/doc/draft.md

# Just Enough Doc

## Run `simple` example

This example is meant to show basic service-based IMAP server with boitalettres library.

- [Source code](../examples/simple.rs)

```shell
$ export RUST_LOG="info,simple=trace,boitalettres=trace" 
$ export RUSTFLAGS="--cfg tokio_unstable"
$ cargo run --example simple
```

- [Basic python testing script](../scripts/test_imap.py)

```shell
$ python scripts/test_imap.py
```

## Notes

- The library use the `tracing` library for logging, a basic setup is shown in the `simple` example with the `tracing-subscriber` crate.

## References

- [`imap-codec`](https://docs.rs/imap-codec): IMAP protocol model+encoder/decoder
- [`tower`](https://docs.rs/tower): Service-based request handling library