# Rust Codegen
Rust Codegen aims to help you generate Rust code programmatically with a simple builder API.
## Installation
To use `rust-codegen`, add the following to your `Cargo.toml` file:
```toml
[dependencies]
rust-codegen
```
## Usage
While usage can vary based on what you need, a basic flow is creating a `Scope` and then adding what you need onto it. Below is a simple example of creating a struct with a couple of fields.
```rust
use rust_codegen::Scope;
// A `Scope` is the root of the builder. Everything should be added on to it.
let mut scope = Scope::new();
// Creates a new struct named Foo that derives from `Debug` and have two fields.
scope.new_struct("Foo")
.derive("Debug")
.field("one", "usize")
.field("two", "String");
// Once turned into a string, the above looks like:
// #[derive(Debug)]
// struct Foo {
// one: usize,
// two: String,
// }
println!("{}", scope.to_string());
```
Make sure to check out the documentation for all of the available features with examples.
## Acknowledgements
This was originally a fork of [carllerche's codegen repo](https://github.com/carllerche/codegen) with some updates. However, due to the amount of updates and the fact that I needed to publish it on crates.io for other projects, I made it its own thing.
## License
[MIT](./LICENSE)
## 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:
**Note:** You should not rely on the formatted output as it's very basic. You should instead run the generated code through `rustfmt`.