11 releases (6 breaking)

0.7.0 Sep 16, 2021
0.6.0 Mar 14, 2021
0.5.0 Dec 25, 2020
0.4.1 Sep 8, 2020
0.1.0 Apr 21, 2017

#1409 in Encoding

MIT/Apache

110KB
2.5K SLoC

CLI for generation of type definitions for Rust, Kotlin, TypeScript and JSON Schema from JSON

Note: There is also a web interface, and for Rust types there is also a procedural macro interface to this code, which uses the same underlying algorithm and code generation. See the repository for details and typegen.vestera.as for the web interface.

Installation

Install with cargo:

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

Or download precompiled binaries from the GitHub releases page.

Usage

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

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

Note: The output file (e.g. src/point.rs) will be overwritten if it exists.

For an online sample, run:

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

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

[dependencies]
serde = "1.0"
serde_derive = "1.0"
# Not required for the types themselves, but you probably also want:
serde_json = "1.0"

Options and configurations

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

Other languages

You can output code for other languages with the --output-mode option. From --help:

    -O, --output-mode <output-mode>    What to output. [possible values: rust, typescript, typescript/typealias, kotlin,
                                       kotlin/jackson, kotlin/kotlinx, json_schema, shape]

Dependencies

~6.5–10MB
~183K SLoC