#moonitest - MoonBit 集成测试框架

#为什么需要 moonitest

你的 MoonBit 项目
      |
      +-- moon test（单元测试，纯逻辑）
      |
      +-- moonitest（集成测试）
              |
              用 Docker 拉起真实的 PostgreSQL/Redis/MySQL
              等端口就绪 -> 跑业务逻辑 -> 断言结果
              测试结束 -> 自动销毁容器

#安装

moon add aspnmy/moonitest

#多架构交叉编译 & E2E 验证（推荐）

推荐镜像： ghcr.io/aspnmy/act-runner-ci:baseimage-v3.2.3.0-runner-v4

内置 gcc、Docker CLI、QEMU 多架构支持、MinGW 交叉编译器

#全量验证（类型检查 + native + wasm-gc + 测试）

docker run --rm -v $(pwd):/build \
  ghcr.io/aspnmy/act-runner-ci:baseimage-v3.2.3.0-runner-v4 \
  sh -c "curl -fsSL https://cli.moonbitlang.com/install.sh | bash
    && /home/agentuser1/.moon/bin/moon version --all
    && /home/agentuser1/.moon/bin/moon check /build
    && /home/agentuser1/.moon/bin/moon build --target native /build
    && /home/agentuser1/.moon/bin/moon build --target wasm-gc /build
    && /home/agentuser1/.moon/bin/moon test /build"

#分步编译

注意： 镜像自带的 /build 目录可能与卷挂载冲突，推荐使用绝对路径参数 /build 传递给 moon 命令。容器内 MoonBit CLI 安装在 /home/agentuser1/.moon/bin/。

#其他编译方式

docker run --rm -v $(pwd):/build debian:bullseye-slim sh -c \
  "apt update -qq && apt install -y -qq curl gcc > /dev/null 2>&1
  && curl -fsSL https://cli.moonbitlang.com/install.sh | bash > /dev/null 2>&1
  && export PATH=\$HOME/.moon/bin:\$PATH
  && moon check && moon build --target native && moon test"

#已验证的编译环境

完整编译指南见 docs/docker-cross-compile.md。

#快速开始

#场景：测试你的 MoonBit 项目需要 PostgreSQL

// test/integration_test.mbt
test "user repository integration" {
  let pg = DockerContainer::new("postgres:16-alpine")
    .with_port(15432, 5432)
    .with_env("POSTGRES_USER", "myapp")
    .with_env("POSTGRES_PASSWORD", "secret")
    .with_env("POSTGRES_DB", "mydb")
  match pg.start() {
    Ok(id) => {
      match wait_for_port("localhost", 15432, 30000) {
        Ok(_) => {
          println("pg ready at postgresql://myapp:secret@localhost:15432/mydb")
        }
        Err(e) => println("pg not ready: " + e)
      }
      let _ = stop(id)
    }
    Err(e) => println("start failed: " + e)
  }
}

#场景：测试依赖 Redis

test "redis cache integration" {
  let port = 16379
  let r = DockerContainer::new("redis:7-alpine").with_port(port, 6379)
  match r.start() {
    Ok(id) => {
      match wait_for_port("localhost", port, 15000) {
        Ok(_) => println("redis ready at localhost:" + port.to_string())
        Err(e) => println("redis timeout: " + e)
      }
      let _ = stop(id)
    }
    Err(e) => println("docker unavailable: " + e)
  }
}

#场景：多容器（PG + Redis）

test "multi-container integration" {
  let pg = DockerContainer::new("postgres:16-alpine").with_port(15432, 5432)
  let redis = DockerContainer::new("redis:7-alpine").with_port(16379, 6379)
  let pg_id = match pg.start() {
    Ok(id) => { let _ = wait_for_port("localhost", 15432, 30000); id }
    Err(e) => { println("pg: " + e); return }
  }
  let redis_id = match redis.start() {
    Ok(id) => { let _ = wait_for_port("localhost", 16379, 15000); id }
    Err(e) => { println("redis: " + e); return }
  }
  println("both containers ready")
  let _ = stop(pg_id)
  let _ = stop(redis_id)
}

#API 参考

#DockerContainer

#等待策略

#HTTP / 网络

#预设容器

let pg = postgres_container(15432)
let conn_str = postgres_connection_string("localhost", 15432)
// -> "postgresql://test_user:test_pass@localhost:15432/test_db"

#集成到 MoonBit 项目

#目录结构

your-moonbit-project/
+-- moon.mod
+-- moon.pkg
+-- src/
|   +-- lib.mbt
+-- test/
|   +-- integration_test.mbt
+-- README.md

#运行

moon check
moon build --target native
moon test
moon test -- --name "postgres"

#调试技巧

#容器日志

test "debug postgres" {
  let pg = postgres_container(15432)
  match pg.start() {
    Ok(id) => { println("container: " + id) }
    Err(e) => println("error: " + e)
  }
}

#端口冲突 / 超时

let port = match find_free_port() {
  Ok(p) => p
  Err(_) => 15432
}

#无 Docker 降级

match pg.start() {
  Ok(id) => { /* 集成测试 */ }
  Err(e) => println("skip: " + e)
}

#已知限制 (v0.1.6)

#当前可用 API

• DockerContainer::new() / .with_port() / .with_env() / .with_cmd()
• postgres_container() / redis_container() / mysql_container()
• postgres_connection_string() / redis_address() / mysql_connection_string()

#变更日志

#v0.1.6

#v0.1.5

#v0.1.4

#依赖

#构建

moon check
moon build --target native
moon test

#许可