qrdl/regexped

镜像概述

Regexped是RE2正则表达式转WebAssembly编译器，兼容不同执行环境和编程语言。本镜像包含regexped CLI工具及Binaryen的wasm-merge，旨在作为命令行工具处理挂载为卷的项目目录。

核心功能

1. 将RE2正则表达式编译为WebAssembly（WASM）文件
2. 生成Rust、Go、C、JS、TS、AS语言的存根文件
3. 合并主机WASM与正则WASM模块为单一二进制文件

使用场景

适用于需要在多语言项目中高效处理正则表达式的场景，如Rust、Go项目的WASM构建流程，或JS/TS项目直接加载正则WASM模块。

配置说明

所有regexped.yaml中的路径均相对于配置文件（容器内相对于/work目录），输入输出文件需放在挂载目录内。

通用使用方法

将项目目录挂载到/work，并传递regexped命令作为参数：

bash
docker run --rm -v /path/to/your/project:/work -w /work --user $(id -u):$(id -g) docker.xuanyuan.run/qrdl/regexped \
  <命令> [参数]

生成存根

bash
docker run --rm -v /path/to/your/project:/work -w /work --user $(id -u):$(id -g) docker.xuanyuan.run/qrdl/regexped \
  generate --config=regexped.yaml

读取regexped.yaml，将存根文件写入配置中stub_file指定的路径（如src/stubs.rs、stubs.js等），存根类型由文件扩展名或stub_type配置字段推断。

若要将存根输出到标准输出：

bash
docker run --rm -v /path/to/your/project:/work -w /work docker.xuanyuan.run/qrdl/regexped \
  generate --config=regexped.yaml --output=-

编译正则到WASM

bash
docker run --rm -v /path/to/your/project:/work -w /work --user $(id -u):$(id -g) docker.xuanyuan.run/qrdl/regexped \
  compile --config=regexped.yaml

将配置中的所有正则模式编译为单个WASM文件，路径由wasm_file指定：

• 若配置无output字段，模块为独立模式（自有内存，可直接在JS/TS中加载）
• 若配置有output字段，模块为嵌入模式（从"main"导入内存，需与主机二进制文件合并）

合并WASM模块

bash
docker run --rm -v /path/to/your/project:/work -w /work --user $(id -u):$(id -g) docker.xuanyuan.run/qrdl/regexped \
  merge --config=regexped.yaml --main=target/wasm32-wasip1/release/app.wasm regexps.wasm

将主机主WASM与一个或多个正则WASM模块合并为单一二进制文件，输出路径来自配置的output字段，或通过--output覆盖。容器内wasm-merge已在$PATH中，无需额外配置。

典型工作流

Rust

bash
# 1. 生成Rust存根
docker run --rm -v $(pwd):/work -w /work --user $(id -u):$(id -g) docker.xuanyuan.run/qrdl/regexped \
  generate --config=regexped.yaml

# 2. 构建Rust项目到WASM（容器外，需cargo）
cargo build --target wasm32-wasip1 --release

# 3. 编译正则到WASM
docker run --rm -v $(pwd):/work -w /work --user $(id -u):$(id -g) docker.xuanyuan.run/qrdl/regexped \
  compile --config=regexped.yaml

# 4. 合并为单一二进制文件
docker run --rm -v $(pwd):/work -w /work --user $(id -u):$(id -g) docker.xuanyuan.run/qrdl/regexped \
  merge --config=regexped.yaml --main=target/wasm32-wasip1/release/app.wasm regexps.wasm

Go

bash
# 1. 生成Go存根
docker run --rm -v $(pwd):/work -w /work --user $(id -u):$(id -g) docker.xuanyuan.run/qrdl/regexped \
  generate --config=regexped.yaml

# 2. 编译正则到WASM
docker run --rm -v $(pwd):/work -w /work --user $(id -u):$(id -g) docker.xuanyuan.run/qrdl/regexped \
  compile --config=regexped.yaml

# 3. 构建Go项目到WASM（容器外，需Go）
GOOS=wasip1 GOARCH=wasm go build -o app.wasm .

# 4. 合并为单一二进制文件
docker run --rm -v $(pwd):/work -w /work --user $(id -u):$(id -g) docker.xuanyuan.run/qrdl/regexped \
  merge --config=regexped.yaml --main=app.wasm regexps.wasm

JavaScript / TypeScript（无需合并）

bash
# 1. 编译正则到WASM（独立模式，配置无output字段）
docker run --rm -v $(pwd):/work -w /work --user $(id -u):$(id -g) docker.xuanyuan.run/qrdl/regexped \
  compile --config=regexped.yaml

# 2. 生成JS/TS存根
docker run --rm -v $(pwd):/work -w /work --user $(id -u):$(id -g) docker.xuanyuan.run/qrdl/regexped \
  generate --config=regexped.yaml

直接在JS/TS代码中加载编译后的WASM：

js
await init(await fetch('./regexps.wasm').then(r => r.arrayBuffer()));