esolang/ruby

Ruby 3.2.0 编程语言

• https://www.ruby-lang.org/

本镜像属于 https://github.com/hakatashi/esolang-box 项目的一部分。

关于

https://github.com/hakatashi/esolang-box 旨在通过 Docker 为多种（目前已支持 227 种！）编程语言提供简单且标准化的接口，尤其针对不常见的 深奥编程语言。

本镜像包含 Ruby 3.2.0 语言的实现和解释器，可通过简单命令 ruby 调用（该命令也是 script 命令的别名，两者可互换使用）。

该脚本接受标准输入作为程序输入，第一个参数作为程序代码文件。脚本的输出将打印到标准输出。此约定在 https://hub.docker.com/u/esolang/ 中通用，因此可轻松切换使用其他语言。

核心功能与特性

• 标准化接口：遵循 esolang-box 项目统一约定，输入输出方式一致，便于跨语言使用
• 灵活调用：支持通过 ruby 或 script 命令执行代码
• 多输入方式：接受标准输入或文件路径作为程序输入
• 调试支持：可通过 shell 环境调试代码
• 系统调用跟踪：支持通过 strace 跟踪 execve 和 execveat 系统调用

使用场景

• 运行 Ruby 3.2.0 脚本文件
• 处理标准输入数据的 Ruby 程序
• 调试 Ruby 代码
• 分析 Ruby 程序的系统调用行为

使用方法

运行单个 Ruby 3.2.0 脚本

假设当前目录下有 hello.rb 脚本文件，内容如下：

$ cat hello.rb
puts 'Hello, World!'

可通过以下命令执行：

$ docker run --rm -v "$PWD":/code:ro esolang/ruby ruby /code/hello.rb
Hello, World!

处理输入数据

通过标准输入为 Ruby 程序提供输入：

$ docker run -i --rm -v "$PWD":/code:ro esolang/ruby ruby /code/hello.rb < input.txt

通过 Shell 调试代码

进入容器 shell 环境调试 Ruby 代码：

$ docker run -it --rm -v "$PWD":/code:ro esolang/ruby sh
# ruby /code/hello.rb
Hello, World!

跟踪 exec 系统调用

esolang-box 2.4.0 支持通过 strace 命令跟踪 execve 和 execveat 系统调用。设置 STRACE_OUTPUT_PATH 环境变量并启用 ptrace 权限，可将 strace 日志输出到指定路径：

sh
$ docker run --cap-add=SYS_PTRACE --rm -v "$PWD":/code --env STRACE_OUTPUT_PATH=/code/strace.txt esolang/ruby ruby /code/hello.rb
Hello, World!

注意事项：

• https://bugs.chromium.org/p/project-zero/issues/detail?id=1718 使用 --cap-add=SYS_PTRACE 时需格外谨慎（尤其不应在 Xenial 系统中使用）。
• 使用 strace 会带来巨大的性能开销，系统调用速度可能会慢 10 倍。