feat(ruby): Ruby language bindings

Author: Omar Qureshi

.github/workflows/main.yml

@@ -52,6 +52,10 @@ jobs:
           cache: pip
       - name: Install python3-venv
         run: sudo apt install -y python3-venv
+      - name: Set up Ruby 3.3
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
       - name: Cache
         uses: actions/cache@v5
         with:
@@ -136,6 +140,10 @@ jobs:
           cache: pip
       - name: Install python3-venv
         run: sudo apt install -y python3-venv
+      - name: Set up Ruby 3.3
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
       - name: Cache
         uses: actions/cache@v5
         with:
@@ -368,6 +376,10 @@ jobs:
       - name: "Linux: Install python3-venv"
         if: runner.os == 'Linux'
         run: sudo apt install -y python3-venv
+      - name: Set up Ruby 3.3
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
       - if: runner.os == 'Windows'
         name: Windows performance improvements
         run: |-

.yarn/patches/jsii-npm-5.9.28-797cbf1229.patch

@@ -0,0 +1,12 @@
+diff --git a/lib/project-info.js b/lib/project-info.js
+index 62630bf1c76effac44081479b31f762ece4697e0..f7e0ca309a0940998d7cb2e2a7c2e5509f627cfe 100644
+--- a/lib/project-info.js
++++ b/lib/project-info.js
+@@ -124,6 +124,7 @@ function validateTargets(targets) {
+         python: ['module', 'distName', 'classifiers'],
+         dotnet: ['namespace', 'packageId', 'iconUrl', 'versionSuffix'],
+         go: ['moduleName', 'packageName', 'versionSuffix'],
++        ruby: ['gem', 'module'],
+     };
+     for (const [language, config] of Object.entries(targets)) {
+         if (!(language in VALID_TARGET_KEYS)) {

.yarn/patches/jsii-rosetta-npm-5.9.42-077551f982.patch

@@ -0,0 +1,24 @@
+diff --git a/lib/languages/index.js b/lib/languages/index.js
+index 1abc03b0e0df5ff9f1af10560c87a76efaf09a79..ad7e175d147cb24248f9c92eae6d04c9351fea2e 100644
+--- a/lib/languages/index.js
++++ b/lib/languages/index.js
+@@ -29,6 +29,7 @@ exports.TARGET_LANGUAGES = {
+ };
+ function getVisitorFromLanguage(language) {
+     if (language !== undefined) {
++        if (language === 'ruby') return new visualize_1.VisualizeAstVisitor();
+         const target = Object.values(target_language_1.TargetLanguage).find((t) => t === language);
+         if (target === undefined) {
+             throw new Error(`Unknown target language: ${language}. Expected one of ${Object.values(target_language_1.TargetLanguage).join(', ')}`);
+diff --git a/lib/main.js b/lib/main.js
+index 07339c7c8c43e4603c76282dcf6833a43f533845..367d73c12173fb44260d2c2efc741a91ce2c9891 100644
+--- a/lib/main.js
++++ b/lib/main.js
+@@ -310,6 +310,7 @@ async function main() {
+         const languages = args.language.length > 0
+             ? args.language
+                 .map((lang) => lang.toUpperCase())
++                .filter((lang) => lang !== 'RUBY')
+                 .map((lang) => {
+                 const target = Object.entries(languages_1.TargetLanguage).find(([k]) => k === lang)?.[1];
+                 if (target == null) {

buildspec.yaml

@@ -2,6 +2,8 @@ version: 0.2
 
 phases:
   install:
+    runtime-versions:
+      ruby: 3.3
     commands:
       - corepack enable
       - yarn install --immutable

package.json

@@ -33,6 +33,7 @@
     "jest-circus": "^30.3.0",
     "jest-config": "^30.3.0",
     "jest-expect-message": "^1.1.3",
+    "jsii-pacmak": "^0.0.0",
     "lerna": "^9.0.7",
     "npm-check-updates": "^22.1.0",
     "prettier": "^3.8.3",
@@ -51,5 +52,8 @@
     "packages/@scope/*",
     "tools/*"
   ],
-  "packageManager": "yarn@4.13.0"
+  "packageManager": "yarn@4.13.0",
+  "resolutions": {
+    "jsii@npm:~5.9.1": "patch:jsii@npm%3A5.9.28#~/.yarn/patches/jsii-npm-5.9.28-797cbf1229.patch"
+  }
 }

packages/@jsii/kernel/src/kernel.test.ts

@@ -417,6 +417,10 @@ defineTest(
         module: 'jsii_calc',
         classifiers: ['Test :: Classifier :: Is Dummy'],
       },
+      ruby: {
+        gem: 'jsii-calc',
+        module: 'JsiiCalc',
+      },
     });
     expect(sandbox.naming({ assembly: '@scope/jsii-calc-lib' }).naming).toEqual(
       {
@@ -442,6 +446,10 @@ defineTest(
           distName: 'scope.jsii-calc-lib',
           module: 'scope.jsii_calc_lib',
         },
+        ruby: {
+          gem: 'scope-jsii-calc-lib',
+          module: 'Scope::JsiiCalcLib',
+        },
       },
     );
   },

packages/@jsii/ruby-runtime-test/.gitignore

@@ -0,0 +1 @@
+lib/

packages/@jsii/ruby-runtime-test/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+gem 'jsii-ruby-runtime', path: '../ruby-runtime'
+gem 'rspec', '~> 3.12'

packages/@jsii/ruby-runtime-test/Gemfile.lock

@@ -0,0 +1,43 @@
+PATH
+  remote: ../ruby-runtime
+  specs:
+    jsii-ruby-runtime (0.0.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.6.2)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.8)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+
+PLATFORMS
+  ruby
+  x86_64-linux-gnu
+
+DEPENDENCIES
+  jsii-ruby-runtime!
+  rspec (~> 3.12)
+
+CHECKSUMS
+  bundler (4.0.11) sha256=5bcec0fb78302e48d02ee46f10ee6e6942be647ba5b44a6d1ddfda9a240ce785
+  diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
+  jsii-ruby-runtime (0.0.0)
+  rspec (3.13.2) sha256=206284a08ad798e61f86d7ca3e376718d52c0bc944626b2349266f239f820587
+  rspec-core (3.13.6) sha256=a8823c6411667b60a8bca135364351dda34cd55e44ff94c4be4633b37d828b2d
+  rspec-expectations (3.13.5) sha256=33a4d3a1d95060aea4c94e9f237030a8f9eae5615e9bd85718fe3a09e4b58836
+  rspec-mocks (3.13.8) sha256=086ad3d3d17533f4237643de0b5c42f04b66348c28bf6b9c2d3f4a3b01af1d47
+  rspec-support (3.13.7) sha256=0640e5570872aafefd79867901deeeeb40b0c9875a36b983d85f54fb7381c47c
+
+BUNDLED WITH
+  4.0.11

packages/@jsii/ruby-runtime-test/generate.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+# Generate the Ruby bindings for the jsii-calc fixture assemblies into ./lib,
+# where spec/spec_helper.rb expects to find them.  Invoked by `yarn build`.
+set -euo pipefail
+
+genRoot="./lib"
+
+# Clean up any previously-generated bindings so stale types don't linger when
+# an assembly is removed or renamed upstream.
+rm -rf "${genRoot}"
+
+# `--code-only` skips `gem build`, which would require Ruby + RubyGems to be
+# present in every environment that runs `yarn build`.  The runtime tests do
+# not consume a built .gem — they load the generated sources under lib/
+# directly via $LOAD_PATH (see spec/spec_helper.rb).
+#
+# `--recurse` pacmaks jsii-calc *and* the whole dependency closure
+# (@scope/jsii-calc-{lib,base,base-of-base}), so we only need to pass the
+# top-level assembly here.
+yarn jsii-pacmak -t ruby --code-only --recurse -o "${genRoot}" ../../jsii-calc