refactor: rename reload command to box_reload and mark as experimental

Author: ahogappa

lib/irb/command/reload.rb

@@ -4,17 +4,42 @@ module IRB
   # :stopdoc:
 
   module Command
-    class Reload < Base
+    class BoxReload < Base
       category "IRB"
-      description "Reload files that were loaded via require in IRB session."
+      description "[Experimental] Reload files that were loaded via require in IRB session (requires Ruby::Box)."
+
+      help_message <<~HELP
+        Usage: box_reload
+
+        Reloads all Ruby files that were loaded via `require` or `require_relative`
+        during the current IRB session. This allows you to pick up changes made to
+        source files without restarting IRB.
+
+        Setup:
+          1. Start Ruby with RUBY_BOX=1 environment variable
+          2. Set IRB.conf[:RELOADABLE_REQUIRE] = true in your .irbrc
+
+        Example:
+          # In .irbrc:
+          IRB.conf[:RELOADABLE_REQUIRE] = true
+
+          # In IRB session:
+          require 'my_lib'  # loaded and tracked
+          # ... edit my_lib.rb ...
+          box_reload         # reloads the file
+
+        Note: This feature is experimental and requires Ruby::Box (Ruby 4.0+).
+        Native extensions (.so/.bundle) cannot be reloaded.
+      HELP
 
       def execute(_arg)
         unless reloadable_require_available?
-          warn "The reload command requires IRB.conf[:RELOADABLE_REQUIRE] = true and Ruby::Box (Ruby 4.0+) with RUBY_BOX=1 environment variable."
+          warn "box_reload requires IRB.conf[:RELOADABLE_REQUIRE] = true and Ruby::Box (Ruby 4.0+) with RUBY_BOX=1 environment variable."
           return
         end
 
-        files = IRB.conf[:__RELOADABLE_FILES__]
+        ReloadableRequire.collect_autoloaded_files
+        files = ReloadableRequire.reloadable_files
         if files.empty?
           puts "No files to reload. Use require to load files first."
           return

lib/irb/default_commands.rb

@@ -253,7 +253,7 @@ def load_command(command)
 
     register(:cd, Command::CD)
     register(:copy, Command::Copy)
-    register(:reload, Command::Reload)
+    register(:box_reload, Command::BoxReload)
   end
 
   ExtendCommand = Command

test/irb/test_reloadable_require.rb

@@ -37,7 +37,7 @@ def test_require_enables_reload
         type "require 'nested_a'"
         type "NESTED_A_VALUE"
         type "NESTED_B_VALUE"
-        type "reload"
+        type "box_reload"
         type "exit!"
       end
 
@@ -56,7 +56,7 @@ def test_require_relative_from_irb_prompt_enables_reload
         type "require_relative 'require_relative_lib'"
         type "REQUIRE_RELATIVE_LIB_VALUE"
         type "REQUIRE_RELATIVE_DEP"
-        type "reload"
+        type "box_reload"
         type "exit!"
       end
 
@@ -75,7 +75,7 @@ def test_require_with_nested_require_relative_enables_reload
         type "require '#{@relative_nested_a_path}'"
         type "RELATIVE_NESTED_A"
         type "RELATIVE_NESTED_B"
-        type "reload"
+        type "box_reload"
         type "exit!"
       end
 
@@ -94,7 +94,7 @@ def test_autoload_enables_reload
         type "autoload :AutoloadMain, 'autoload_main'"
         type "AutoloadMain::VALUE"
         type "AUTOLOAD_DEP_VALUE"
-        type "reload"
+        type "box_reload"
         type "exit!"
       end
 
@@ -110,7 +110,7 @@ def test_reload_without_any_loaded_files
       RUBY
 
       output = run_ruby_file do
-        type "reload"
+        type "box_reload"
         type "exit!"
       end
 
@@ -126,7 +126,7 @@ def test_reload_reflects_file_changes
         type "require '#{@changeable_lib_path}'"
         type "CHANGEABLE_VALUE"
         type "File.write('#{@changeable_lib_path}', \"CHANGEABLE_VALUE = 'modified'\\n\")"
-        type "reload"
+        type "box_reload"
         type "CHANGEABLE_VALUE"
         type "exit!"
       end
@@ -146,7 +146,7 @@ def test_reload_command_without_reloadable_require_enabled
       RUBY
 
       output = run_ruby_file do
-        type "reload"
+        type "box_reload"
         type "exit!"
       end
 
@@ -194,7 +194,7 @@ def test_reload_preserves_loaded_features
       output = run_ruby_file do
         type "require 'nested_a'"
         type "$LOADED_FEATURES.include?('#{@nested_a_path}')"
-        type "reload"
+        type "box_reload"
         type "$LOADED_FEATURES.include?('#{@nested_a_path}')"
         type "exit!"
       end
@@ -363,7 +363,7 @@ def test_reload_command_shows_error_without_ruby_box
       RUBY
 
       output = run_ruby_file do
-        type "reload"
+        type "box_reload"
         type "exit!"
       end