このプロジェクトについて
## このリポジトリについて
`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ソースのリンティング。
- `bunx typedoc index.ts` — HTML形式のAPIドキュメントを生成。
## ドキュメント
READMEには、Markdownのレンダリングを確認するためのサンプルMermaidクラス図 (`Foo <|-- Bar`) が含まれており、GitHub Pagesでホストされている自動生成APIドキュメントへのリンクがあります。また、docs.rs上のRustドキュメントへのリンクも含まれています。
## プロジェクトメタデータ
リポジトリには、リリースバージョン、ビルドステータス、APIドキュメント、Rustドキュメント、カバレッジ、およびMITライセンスのバッジが付いています。ライセンスは MIT © Flowscripter と明記されています。
## 利用検討者への注意点
これはテンプレートであるため、`world()` エクスポートや例示された図はプレースホルダーです。実用的な価値は、RustクレートとBun/TypeScriptパッケージ間の連携設定、およびそれに付随するビルド、テスト、リンティング、フォーマット、ドキュメント作成コマンド、およびCI設定にあります。
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.