Camo

文档 | 仓库 | 版本

Camo 是一个将 Rust 类型定义转换为其他语言相应定义的库。

• 抽象语法树 - Camo 提供了一组数据结构来描述 Rust 语法的子集。语法树以 core::Container 为根，该类型通过 core::Camo 特性提供。

• 派生宏 - derive::Camo 派生宏自动化创建您类型语法树的工作。该宏考虑了 serde 属性，确保生成的类型准确描述 serde 将生成的值。

• TypeScript 后端 - typescript 模块提供了一个现成的 TypeScript 后端。将 core::Container 转换为 typescript::Definition，并将其写入文件。

入门

将 Camo 添加为依赖项

# `derive` is included by default
cargo add camo
# optionally add the typescript backend
cargo add camo --features typescript

将 Camo 派生宏添加到您的类型

use camo::Camo;

#[derive(Camo)]
struct Book {
    title: String,
    author: String,
    page_count: usize,
    chapters: Vec<String>,
}

使用生成的 Camo::camo() 实现

fn main() {
    let book = Book::camo();
    println!("{:?}", book);
}

启用 typescript 功能后，创建 TypeScript 定义

use camo::{
    /* ... */
    typescript::Definition,
};

/* ... */

fn main() {

    /* ... */

    let ty: Definition = book.into();

    println!("{}", ty);
    // interface Book {
    //     title: string;
    //     author: string;
    //     page_count: number;
    //     chapters: string[];
    // }
}

查看更多示例 这里。

特性

软件包

该项目由多个软件包组成，以组织特性。

注意，只有camo适用于通用用途。

许可证

camo在MIT许可证的条款下分发。有关详细信息，请参阅LICENSE。