# ingraph-codegen
The emission engine behind [`ingraph-derive`](https://crates.io/crates/ingraph-derive). Model in,
tokens out.
**You almost certainly do not want to depend on this crate.** It is an implementation detail of
`ingraph-derive`, published because it is a dependency of one. The door is
[`ingraph`](https://crates.io/crates/ingraph).
## 0.1 is a first cut
**Everything here may change or disappear in a later `0.x`.** The model types are public structs
with public fields precisely so a second front end can build one, and that surface is still being
shaped by the first. No API is settled, no migration is promised, and there is no deprecation cycle
to rely on.
## What it is, and what it is not
Nothing here parses. `model::RecordModel` is a plain struct with public fields, so the front ends
that build one — the derive today, a manifest compiler later — reach the **same** emitter without
either of them being this crate's concern. Validation belongs with those front ends, which hold the
source spans to report at.
It is not manifest-driven, despite what this crate's own description said before 0.1. Under the
settled architecture a manifest and a GraphQL schema are compiled by a separate front end into the
decorated declarations the macros expand; this crate is the last step of that pipeline, and the
whole of it for a hand-written record.
## Installation
```toml
[dependencies]
ingraph = "0.1" # the door you want
# ingraph-codegen = "0.1" # only if you are writing a front end of your own
```
#### License
`ingraph-codegen` is under the terms of both the MIT license and the Apache License (Version 2.0).
See [LICENSE-APACHE](https://github.com/findit-studio/ingraph/blob/main/LICENSE-APACHE) and
[LICENSE-MIT](https://github.com/findit-studio/ingraph/blob/main/LICENSE-MIT) for details.