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.

Your issues and PRS are welcome!

Why do we need gents instead of 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 bazel as our building tool. 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 only specifies the file_name on structs or enums and specifies the dir on group, while ts-rs should specifies the path on every item.

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

Many thanks to ts-rs because it helps gents a lot.

How to use gents?

In your Rust code:

```rs use gents::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 you should make a binary to generate the files like below:

```rust use gents::FileGroup;

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

Run the binary and in the outdir, there are 2 files:

• person.ts
• group.ts

Check more cases and usage in the tests folder.