# Codegen

Provides an builder API to assist in generating Rust code.

[![Build Status](https://app.travis-ci.com/GothAck/codegen2.svg?branch=master)](https://app.travis-ci.com/github/GothAck/codegen2)

More information about this crate can be found in the [crate documentation][dox]

[dox]: https://docs.rs/codegen2/0.1.4/codegen2/

## Installation

To use `codegen2`, first add this to your `Cargo.toml`:

```toml
[dependencies]
codegen2 = "0.1.4"
```

Next, add this to your crate:

```rust
extern crate codegen2;
```

## Usage

1) Create a `Scope` instance.
2) Use the builder API to add elements to the scope.
3) Call `Scope::to_string()` to get the generated code.

For example:

```rust
use codegen2::Scope;

let mut scope = Scope::new();

scope.new_struct("Foo")
    .derive("Debug")
    .field("one", "usize")
    .field("two", "String");

println!("{}", scope.to_string());
```

## Non-goals

`codegen2` will not attempt to perform anything beyond basic formatting. For
improved formatting, the generated code can be passed to `rustfmt`.

## License

This project is licensed under the [MIT license](LICENSE).

### Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in `codegen2` by you, shall be licensed as MIT, without any
additional terms or conditions.