SuperAPI AI 工具集

gleam-practice

办公与效率

查看项目

更新于 10-15 23:23

技能介绍

用途:在新建或改进 Gleam(Erlang 目标)项目时提供工程实践,重点是 wisp + mist + gleam_otp + just 组成的 Web 服务与其评审。

主要能力与约定:用 gleam new 和 gleam add 让依赖由 solver 决定;按 TDD(探索→Red→Green→Refactor)推进;分离纯逻辑与状态管理,domain 模块与 actor/server 模块分开;公开 API 保持小,优先 pub opaque type;@external 仅作最后手段并封装在薄 adapter 模块;web 层做薄,wisp handler 只承担 decode、调用 service、encode 响应;任务集中在 justfile,CI 调用 just ci。

使用方式:新项目以 gleam new my_app --template erlang 起步,再 gleam add wisp mist gleam_otp gleam_erlang、gleam add gleam_json envoy、gleam add --dev gleeunit,可按需补充 HTTP client、file I/O、snapshot、property test 等依赖。gleam.toml 需填写元数据,并用 internal_modules 隐藏包内模块;CI 固定 lockfile。推荐布局将 entrypoint、app、web、domain、domain_server、http_json 与 test、bench、justfile 分列。OTP 部分说明 pure state 与 actor 两层模式、Subject 消息传递、static/factory/dynamic 三类 supervisor 及 restart 策略。JSON 使用 gleam/dynamic/decode 与 gleam/json,LSP v1.2+ 可生成 encoder/decoder。测试建议先用 wisp/simulate 固定 HTTP,可用 birdie、qcheck 等;质量以 format --check、check、build --warnings-as-errors、test 为主;性能分 micro、integration、HTTP 负载三层,后者可用 k6。

限制:API 名称可能随版本变化,需查阅 gleam_otp 官方 hex docs;@external 不受编译器验证;具体价格、平台与效果资料未提供。