这个项目能做什么
## 仓库简介
`flowscripter/template-bun-rust-library` 在其 README 中被描述为“带有 Bun FFI 绑定的 Rust 库项目模板”。它的定位是起点而非最终用户应用程序:开发者通过它搭建新项目,然后将示例代码替换为自己的 Rust 实现和 TypeScript 绑定。
## 脚手架使用
README 记录了直接从模板创建新 Bun 项目的方法:
`bun create @flowscripter/template-bun-rust-library`
## 使用生成的模块
通过 `bun add @flowscripter/template-bun-rust-library` 添加发布的模块,README 的示例导入了一个导出的函数并调用它:
```typescript
import { world } from "@flowscripter/template-bun-rust-library";
world();
```
这展示了该模板的预期结构:一个通过 Bun 的 FFI 支持向 TypeScript 消费者开放的 Rust 库,并以 `index.ts` 作为 TypeScript 入口点。
## 开发工作流
README 列出了以下命令:
- `bun install` — 安装依赖。
- `bun run build` — 构建输出;根据 README,它为 Node.js 和 TypeScript 消费者生成 `dist/`,而 Bun 直接使用原始源码。
- `cargo test` — 运行 Rust 测试。
- `cargo build --release && bun test` — 构建 Rust 发布产物并运行 Bun 测试套件。
- `bunx oxfmt` — 格式化。
- `cargo fmt && bunx oxlint index.ts src/ tests/` — 对 Rust 和 TypeScript 源码进行 Lint 检查。
- `bunx typedoc index.ts` — 生成 HTML API 文档。
## 文档
README 包含一个示例 Mermaid 类图 (`Foo <|-- Bar`) 以验证 Markdown 渲染,并提供了指向托管在 GitHub Pages 上的自动生成 API 文档的链接。其他文档链接包括 docs.rs 上的 Rust 文档。
## 项目元数据
该仓库带有发布版本、构建状态、API 文档、Rust 文档、覆盖率和 MIT 许可证的徽章。许可证声明为 MIT © Flowscripter。
## 给潜在用户的提示
由于这是一个模板,`world()` 导出和示例图表仅为占位符。其实际价值在于它在 Rust crate 和 Bun/TypeScript 包之间提供的连接,以及随附的构建、测试、Lint、格式化、文档命令和 CI 配置。
评论
0 评分人数达到10人后显示
登录后参与讨论。