ソースからビルド

Lambda Prelude は OCaml ソースを dune でビルドする。

# 必要環境: OCaml 5.2+ (5.5 で検証) / dune 3.0+ / menhir 2.1+
git clone <repo-url> lambda_prelude
cd lambda_prelude
dune build

Windows では出力バイナリは真のネイティブ MinGW-w64 実行ファイル (実行時 Cygwin DLL 非依存)。ソース開示は NDA ベースのため、本番評価をご検討の際は事前に お問い合わせ ください。

Hello, Prelude

hello.lp を作成する。

'Hello, Lambda Prelude!' displayNl.

インタプリタで実行する。

lambda-prelude run hello.lp

ネイティブバイナリにビルドする。

lambda-prelude build hello.lp --out hello
./hello

インタプリタは反復開発用。意味の正典は AOT バイナリ — インタプリタと AOT が食い違ったら AOT バイナリが勝つ。

カウンタクラス

Lambda Prelude は関数型で、値は不変、クラスはインスタンス変数を持たない。各オブジェクトは fields: 上の不変レコード。

Object subclass: #Counter fields: (value).

Counter class >> of: n = Counter fields: { value: n }.
Counter >> value = value.
Counter >> inc   = Counter fields: { value: value + 1 }.

c := Counter of: 41.
c inc value displayNl.   "=> 42"

inc は新しい Counter を返す。ユーザコードに := 再代入はない — 束縛は let (トップレベルでは :=) のみ。

分岐は多態ディスパッチ

表層に if / match は存在しない。分岐はすべてメッセージ送信で書く。

(score > 90)
  ifTrue:  ['A' displayNl]
  ifFalse: ['B' displayNl].

name ifPresent: [:n | n displayNl]
     ifAbsent: ['anonymous' displayNl].

xs ifEmpty:    ['empty list' displayNl]
   ifNotEmpty: [:h :t | h displayNl].

これは伝統的な Smalltalk と同じ流儀を、条件分岐 / Option 分解 / リスト分解 / retry / timeout すべてに一貫して適用したもの。

プロトコルが継承の代替

クラスは継承しない。共通振る舞いは型クラスに相当する Protocol で表現し、クラスは protocols: 節で実装するプロトコルを宣言する。

Protocol subclass: #Comparable
  requires: (#<).

Comparable >> > other  = other < self.
Comparable >> min: o   = (self < o) ifTrue: [self] ifFalse: [o].
Comparable >> max: o   = (self < o) ifTrue: [o]    ifFalse: [self].

Object subclass: #Score
  fields:    (points)
  protocols: (Comparable).

Score class >> of: n   = Score fields: { points: n }.
Score >> points        = points.
Score >> < other       = points < other points.

((Score of: 10) max: (Score of: 3)) displayNl.

Score は < だけを実装すれば > / min: / max: が Comparable 経由で自動的に手に入る。

2 つの実行モード

同じソースを 2 通りに実行できる。標準ライブラリ・型システム・アクターモデルは共有される。

機能インタプリタAOT
ツリーウォークによる反復開発あり—
静的に解決できる送信を OCaml 直接呼び出しに—あり
動的送信用ランタイムディスパッチャありあり
マルチドメインワークスティーリングスケジューラありあり
Dynlink プラグイン (PostgreSQL / MariaDB / MySQL / Redis)ありあり

反復開発は run、本番は build — AOT バイナリは静的に解決できる送信を直接 OCaml 呼び出しに落とし、それ以外は実行時のメソッドディスパッチを通す。

CLI リファレンス

lambda-prelude run    script.lp                     # ツリーウォークインタプリタ
lambda-prelude build  script.lp --out binary        # AOT ネイティブ
lambda-prelude test   tests                         # Test API のテスト実行
lambda-prelude new    my-service                    # プロジェクト雛形

デバッグツールは次のとおり。

lambda-prelude run   script.lp --trace-mailbox   # メールボックス投入 / 受信を逐次ログ
lambda-prelude run   script.lp --quiet           # 未マッチメッセージ警告とアクター異常死の報告を抑止
lambda-prelude run   script.lp --scheduler multi 4  # N ワーカードメインプール + 自動分散
lambda-prelude build script.lp --deferred        # レシーバの型が決まらず実行時に回る送信を一覧
lambda-prelude build script.lp --emit            # 生成された OCaml を標準出力に
lambda-prelude build script.lp --out script.ml   # 生成された OCaml をファイルに

モジュールとファイル

1 ファイルが 1 モジュール。ファイルは自分の名前を宣言せず、パスが名前を決める — プログラム自身のファイルは Main、mylib.lp は MyLib、stdlib/terios/rpc.lp は Terios::Rpc。先頭に置けるヘッダは 2 行だけ。

imports: (Http, MyLib).
exports: (Server, opaque Session).

imports: の名前は、そのファイル自身のディレクトリ → LAMBDA_PRELUDE_PATH に並べたディレクトリ → stdlib の順に探す。区切りは PATH と同じ (Windows は ;、POSIX は :)。同名の .lp が無い単一セグメントの名前 (Torm など) はプラグインに解決される。import する側は、見つかるファイルのパスが与える名前をそのまま書く。

LAMBDA_PRELUDE_PATH=src lambda-prelude run tests/my_test.lp   # tests/ から src/ のモジュールを読む

run / build / 言語サーバ / デバッグアダプタが同じローダを共有しているので、run で解決する名前は build でも編集中でも解決する。解決に失敗した時のエラーは、実際に辿ったディレクトリを列挙する。

クラスはモジュールと名前の組 (Shapes::Square) で同一になるので、裸の名前が 2 つの import 先に当たる時は Shapes::Square と書いて指す。exports: に挙げていないクラスは外から名指せない — 詳しくは 設計 を参照。

メソッド本体は 1 式

メソッド本体は 1 つの式。順番に走らせたい処理は ( a. b. c ) と書く — 連続式で、文を順に評価し、値は最後の文のもの。

Service >> handle: req = (
  Log info: 'start'.
  res := self compute: req.
  Log info: 'done'.
  res
).

パーサはこれを「それらの文を持つブロックに value を送る」形に読むだけなので、型推論から AOT まで下流は何も変わらない。中で := した名前はその連続式の中だけで見える。式 1 つを囲む ( e ) は今までどおり単なるグループ化。

エディタ

VS Code 拡張 (lambda-prelude) がシンタックスハイライト、言語サーバ (構文エラーと型エラーの診断、推論型の hover、補完、定義へ移動、参照検索、改名)、デバッグアダプタ (ブレークポイント、ステップ実行、変数の表示 — インタプリタ上で動く) を提供する。hover はカーソルを含む最も内側の式に答え、型変数は推論器の連番ではなく出現順に 'a, 'b, ... と名前が付く。位置は LSP の規定どおり UTF-16 で数えるので、日本語を含む行でも指す場所と改名がずれない。

定義 / 参照 / 改名は、名前の綴りではなくそれが何を指しているかに従う — 局所名はそのスコープで、メソッドは型チェッカが記録した解決を通じて。プロトコルのセレクタとその実装は 1 つのグループとして一緒に改名され、override と override 元も同じ扱い。範囲は編集中のファイルを import している他のファイルにも及び、保存していないバッファはディスクの代わりに読まれる。

完全にできない改名は、部分的に実行せず、妨げている場所を挙げて拒否する — 実行時に回った送信、perform: のセレクタかもしれない symbol、builtin や標準ライブラリや合成されたメソッド、型検査を通らないファイル、他の名前と衝突する新しい名前。書き換えた後のファイルは答える前にもう一度解析される。

拡張は言語サーバ・デバッグアダプタ・stdlib・プラグインを同梱しているので、ワークスペースにビルド成果物が無くても imports: と dao: を解決して診断できる。設定は lambdaPrelude.importPath (LAMBDA_PRELUDE_PATH に相当。ワークスペースルートからの相対で書け、言語サーバ・デバッグアダプタ・Run コマンドの全部に渡る) と、同梱バイナリの代わりを指す serverPath / cliPath / debugAdapterPath。

次のステップ