# Sous
**Work with culinary recipes in Rust**

> **NOTE:** Sous is still in early development, and the API should be
> considered unstable at this time.

Sous provides structs for representing culinary recipes in Rust, along with an
API for loading and converting them between formats. This package also includes
a reference command-line utility demonstrating the library's capabilities.

# Installing

Sous is available on [crates.io](https://crates.io/crates/sous):

```
$ cargo add sous
```

# Command Line Usage

The Sous CLI can ingest recipes in YAML format, and output them as Markdown:

```
$ sous test.yml
```

If a directory is passed to Sous as input, it will operate in Cookbook mode,
converting any YAML files within. If the `--output` directory is not set, Sous
will output to a directory called `render` in the current working directory.