CLI for generation of JSON/Serde type definitions for Rust

Note: The main intended interface for this code generation is a procedural macro. See its docs for details.

Installation

cargo install json_typegen_cli
# installed binary is called json_typegen
# make sure ~/.cargo/bin is on your PATH

Due to the fact that this tool uses rustfmt to make code look reasonable, compilation might take a while. If you are in a hurry, you can use the web interface in the meantime.

Usage

To generate the type Point in point.rs from a local sample, run:

json_typegen json_samples/point.json -o src/point.rs -n 'pub Point'

Note: src/point.rs will be overwritten if it exists.

For an online sample, run:

json_typegen 'http://vestera.as/json_typegen/examples/point.json' -o src/point.rs -n 'pub Point'

The generated code assumes the availability of serde and serde_derive, so make sure your Cargo.toml contains something like:

[dependencies]
serde = "0.9"
serde_derive = "0.9"
# Not required, but you probably also want:
serde_json = "0.9"

And your crate root (i.e. main.rs) should contain at least:

extern crate serde;
#[macro_use]
extern crate serde_derive;
// Again, not required, but you probably also want:
extern crate serde_json;

Options and configurations

For help with the CLI itself run json_typegen -h. To configure visibility and other options see the general configuration documentation.