Gleam Practice

Gleam を新規作成するとき、既存プロジェクトを改善するとき、wisp + mist + gleam_otp + just 構成で実装するときに使う。

Default Workflow

• まず gleam new と gleam add を使う。依存は手書きより solver に決めさせる。
• TDD で進める。探索 -> Red -> Green -> Refactor。
• 純粋ロジックと状態管理を分ける。domain module と actor/server module を分離する。
• 公開 API は小さく保つ。pub opaque type を優先し、内部 constructor や protocol 型をむやみに公開しない。
• @external は最後の手段。使う場合は薄い adapter module に閉じ込める。
• web 層は薄くする。wisp handler は decode, call service, encode response に寄せる。
• タスク実行は justfile に集約し、CI も just ci を叩く。

Project Setup

Erlang target の新規 project はこれを起点にする。