gents

gents is a tool for generating Typescript interfaces from Rust code. We can easily use serde-json to communicate between Rust and Typescript, without writing Typescript stubs trivially. It is designed for LogiSheets and is inspired by ts-rs. Many thanks to them!

Your issues and PRs are welcome!

Why do you need gents?

• Writing a easy web server in Rust and you hate things like grpc-web
• Writing a wasm project

Why not ts-rs?

• ts-rs generates the files when running cargo test and in this way we must commit those generated files into our repo. It is not necessary and is even an obstacle when we use other build tools like bazel. gents acts as a binary to generate Typescript files.

• gents introduces a concept Group that from all the members in this group files generated will be placed in the same directory. Group is seperate from the others even though they can share some dependecies. Therefore, gents requires you specify the file_name on structs or enums and specify the dir on group, while ts-rs requires specifing the path on every item.

• gents helps you manage the export files. And it gathers all the dependencies automatically.

• Code generated by ts-rs is not match our coding style.

How to use gents?

In your Rust code:

You should import gents in your Cargo.toml.

toml [dev-dependencies] gents = "0.4" gents_derives = "0.4"

```rust use gents_derives::TS;

[derive(TS)]

[ts(filename = "person.ts", renameall = "camelCase")]

pub struct Person { pub age: u16, pub en_name: String, }

[derive(TS)]

[ts(filename = "group.ts", renameall = "camelCase")]

pub struct Group { pub name: String, pub capacity: u16, pub members: Vec, pub leader: Option, } ```

And then you can write a unit test to generate the files like below:

```rust

[ignore]

[test]

fn gents() { use gents::FileGroup; let mut group = FileGroup::new(); group.add::(); // If you need to generate the index.ts file, set true. group.gen_files("outdir", false); } ```

After running the binary, there are 2 files generated in outdir:

• person.ts
• group.ts

Check more cases and usage in the tests folder.