Support ruby-build ruby-X.Y.Z DIR

README.md

@@ -42,6 +42,7 @@ PREFIX=/usr/local ./ruby-build-*/install.sh
 # As a standalone program
 $ ruby-build --list                        # lists available versions of Ruby
 $ ruby-build 3.2.2 /opt/rubies/ruby-3.2.2  # installs Ruby 3.2.2
+$ ruby-build -d ruby-3.2.2 /opt/rubies     # alternate form for the previous example
 
 # As an rbenv plugin
 $ rbenv install 3.2.2  # installs Ruby 3.2.2 to ~/.rbenv/versions/3.2.2

bin/ruby-build

@@ -1465,6 +1465,17 @@ if [ ! -f "$DEFINITION_PATH" ]; then
     fi
   done
 
+  # If the given definition is like ruby-X.Y.Z, search again with X.Y.Z
+  if [[ "$DEFINITION_PATH" =~ ^ruby-[0-9] ]]; then
+    DEFINITION_PATH="${DEFINITION_PATH#ruby-}"
+    for DEFINITION_DIR in "${RUBY_BUILD_DEFINITIONS[@]}"; do
+      if [ -f "${DEFINITION_DIR}/${DEFINITION_PATH}" ]; then
+        DEFINITION_PATH="${DEFINITION_DIR}/${DEFINITION_PATH}"
+        break
+      fi
+    done
+  fi
+
   if [ ! -f "$DEFINITION_PATH" ]; then
     echo "ruby-build: definition not found: ${DEFINITION_PATH}" >&2
     exit 2

share/man/man1/ruby-build.1.adoc

@@ -20,6 +20,9 @@ ruby-build --version
 ruby-build downloads, compiles, and installs a Ruby version named by the
 _definition_ argument into the location specified by _prefix_.
 
+The _definition_ argument can optionally start with "ruby-", in which case
+it resolves to a CRuby that matches the version number that follows.
+
 The _definition_ argument can be a path to a file on disk, in which case
 it is sourced into ruby-build as a bash script.
 
@@ -61,20 +64,24 @@ and print everything to standard streams.
 
 == Examples
 
-Install Ruby version 3.2.2 under `/opt/rubies` while tweaking some
-configuration options:
+Install a Ruby version while tweaking some configuration options:
+----
+$ ruby-build 3.2.2 /path/to/destination -- --disable-install-doc --with-openssl-dir=/opt/openssl
+----
+
+Install a Ruby version to `~/.rubies/ruby-3.2.2`:
 ----
-$ ruby-build 3.2.2 /opt/rubies/ruby-3.2.2 -- --disable-install-doc --with-openssl-dir=/opt/openssl
+$ ruby-build --dir ruby-3.2.2 ~/.rubies
 ----
 
-Install Ruby version 3.3.5 under `~/.rbenv/versions`:
+Install a Ruby version to `~/.rbenv/versions/3.3.5`:
 ----
 $ ruby-build --dir 3.3.5 ~/.rbenv/versions
 ----
 
-Usage as rbenv plugin:
+Usage as rbenv plugin, accomplishes the same as the previous example:
 ----
-$ rbenv install 3.2.2
+$ rbenv install 3.3.5
 ----
 
 == Environment Variables

test/build.bats

@@ -629,6 +629,43 @@ OUT
   assert [ -x "$INSTALL_ROOT"/without-checksum/bin/package ]
 }
 
+@test "nested install destination with ruby prefix" {
+  cached_tarball "ruby-3.2.0" configure
+
+  stub_repeated brew false
+  stub_make_install
+
+  mkdir -p "$TMP"/definitions
+  cat > "$TMP"/definitions/3.2.0 <<DEF
+install_package "ruby-3.2.0" "http://ruby-lang.org/ruby/2.0/ruby-3.2.0.tar.gz"
+DEF
+
+  RUBY_BUILD_DEFINITIONS="$TMP"/definitions run ruby-build --dir ruby-3.2.0 "$INSTALL_ROOT"
+  assert_success
+
+  unstub brew
+  unstub make
+
+  assert_build_log <<OUT
+ruby-3.2.0: [--prefix=$INSTALL_ROOT/ruby-3.2.0,--with-ext=openssl,psych,+]
+make -j 2
+make install
+OUT
+}
+
+@test "definition file with ruby prefix" {
+  export RUBY_BUILD_CACHE_PATH="$FIXTURE_ROOT"
+
+  cd "$TMP"
+  cat > ruby-123-internal <<DEF
+install_package "package-1.0.0" "http://example.com/packages/package-1.0.0.tar.gz" copy
+DEF
+
+  run ruby-build ruby-123-internal "$INSTALL_ROOT"
+  assert_success
+  assert [ -x "$INSTALL_ROOT"/bin/package ]
+}
+
 @test "custom relative install destination" {
   export RUBY_BUILD_CACHE_PATH="$FIXTURE_ROOT"