https://github.com/colmugx/moonbit-zig-experimental
🧪 Experiments in calling Zig code from MoonBit (via C ABI bridge initially), aiming for direct interop.
https://github.com/colmugx/moonbit-zig-experimental
moonbit moonbit-lang ziglang
Last synced: about 2 months ago
JSON representation
🧪 Experiments in calling Zig code from MoonBit (via C ABI bridge initially), aiming for direct interop.
- Host: GitHub
- URL: https://github.com/colmugx/moonbit-zig-experimental
- Owner: colmugx
- License: wtfpl
- Created: 2025-04-03T14:01:31.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2025-04-06T10:52:38.000Z (about 2 months ago)
- Last Synced: 2025-04-06T11:28:21.586Z (about 2 months ago)
- Topics: moonbit, moonbit-lang, ziglang
- Language: Zig
- Homepage:
- Size: 7.81 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README-ja.md
- License: LICENSE
Awesome Lists containing this project
README
# MoonBit and Zig
> MoonBit とモダンなシステムプログラミング言語間の相互運用性を探る実験的なプロジェクトです。
## プロジェクトの目的
このプロジェクトは、MoonBit で HTTP クライアントを実装するというニーズから生まれました。従来の `libcurl` ベースのソリューションとは異なり、以下の目標のもと、探索的なアプローチを採用しています。
1. `libcurl` からの完全な独立
2. Zig 標準ライブラリを用いたHTTPクライアントの実装
3. MoonBit と C/Zig 間の統合パターンの探求
## 技術選定の理由
基盤となる実装にCではなく Zig を選択した主な理由は以下の通りです。
1. **依存関係管理**
* C言語のエコシステムでは、依存関係の管理が複雑になりがちです。
* 多くの場合、コンパイラ（gccなど）、ライブラリパス、リンク設定を手動で構成する必要があります。
* 一方、Zigはモダンなビルドシステムと包括的な標準ライブラリを提供します。
2. **標準ライブラリの機能**
* Zig の標準ライブラリには、HTTP クライアントの実装が組み込まれています。
* そのため、コアとなる HTTP 機能に外部ライブラリへの依存が必要ありません。
3. **相互運用性**
* C ABIを介して連携しています（フェーズ1）。
* MoonBit と Zig の直接的な相互運用 ~~（フェーズ2）~~ （実装済み）。
## アーキテクチャの変遷
主要なコンポーネントは以下の通りです。
* **MoonBit：** 主要なアプリケーション開発言語
* **Zig：** HTTP クライアントの基盤ロジックを実装
* ~~**C：** MoonBit - Zig 間の中間ブリッジ（フェーズ1）~~
### 過去のアーキテクチャ（フェーズ1）
[21e56bb](https://github.com/colmugx/moonbit-zig-experimental/commit/21e56bb)
```
MoonBit -> C ABI -> Zig
```
### 現在のアーキテクチャ（フェーズ2）
```
MoonBit -> Zig
```
## 使用例
```moonbit
fn main {
// GET リクエストを実行
println(@http.curl_get("https://api.example.com"))
// POST リクエストを実行
println(@http.curl_post("https://api.example.com", "{'data': 'test'}"))
}
```
### CLI
```bash
> ./zig-out/bin/moonbit_zig
No request url.
Usage:
moonbit_zig
> ./zig-out/bin/moonbit_zig https://jsonplaceholder.typicode.com/todos/1
It Works! You've requested: https://jsonplaceholder.typicode.com/todos/1
{
"userId": 1,
"id": 1,
"title": "delectus aut autem",
"completed": false
}
```
## ビルド方法
このプロジェクトは `zig build` システムを利用します。ビルドするには `moon` コマンドを使用してください。
```bash
moon build --target native
```
## 注意事項
1. Zig 0.11.0 以降が必要です。
2. MoonBit のランタイム環境が適切に設定されていることを確認してください。
3. 現在サポートされているプラットフォームは macOS/aarch64 のみです。
## 制限事項と既知の問題
現在の実装には重要な制限があります。例外処理の仕組みが未完成です。MoonBitからZigへの直接関数呼び出しは実装済みですが、Zig側で発生した例外の処理には問題が残っています。具体的には、現状、ZigのエラーをMoonBitの例外処理の仕組みに適切に変換することができません。