Refactor.

Author: samuel-williams-shopify

context/fiber-debugging.md

@@ -161,7 +161,7 @@ After switching to a fiber with `rb-fiber-scan-switch`, you can use standard GDB
 (gdb) bt                    # Show C backtrace
 (gdb) frame <n>             # Switch to specific frame
 (gdb) info locals           # Show local variables
-(gdb) rb-inspect $errinfo  # Print exception if present
+(gdb) rb-print $errinfo  # Print exception if present
 ~~~
 
 The fiber switch command sets up several convenience variables:

context/getting-started.md

@@ -63,7 +63,7 @@ Status: ✓ Installed
 Test that extensions load automatically:
 
 ~~~ bash
-$ gdb --batch -ex "help rb-inspect"
+$ gdb --batch -ex "help rb-print"
 Recursively print Ruby hash and array structures...
 ~~~
 
@@ -88,7 +88,7 @@ This removes the source line from your `~/.gdbinit` or `~/.lldbinit`.
 Ruby GDB provides specialized commands for debugging Ruby at multiple levels:
 
 - **Context Setup** (`rb-context`) - Get current execution context and set up convenience variables
-- **Object Inspection** (`rb-inspect`) - View Ruby objects, hashes, arrays, and structs with proper formatting
+- **Object Inspection** (`rb-print`) - View Ruby objects, hashes, arrays, and structs with proper formatting
 - **Fiber Debugging** (`rb-fiber-*`) - Scan heap for fibers, inspect state, and switch contexts
 - **Stack Analysis** (`rb-stack-trace`) - Examine combined VM (Ruby) and C (native) stack frames
 - **Heap Navigation** (`rb-heap-scan`) - Scan the Ruby heap to find objects by type
@@ -132,7 +132,7 @@ Diagnose the issue (extensions load automatically if installed):
 (gdb) rb-fiber-scan-heap                 # Scan heap for all fibers
 (gdb) rb-fiber-scan-stack-trace-all      # Show backtraces for all fibers
 (gdb) rb-fiber-scan-switch 0             # Switch to main fiber
-(gdb) rb-inspect $errinfo --depth 2 # Print exception (now $errinfo is set)
+(gdb) rb-print $errinfo --depth 2 # Print exception (now $errinfo is set)
 (gdb) rb-heap-scan --type RUBY_T_HASH --limit 10  # Find hashes
 ~~~
 
@@ -146,7 +146,7 @@ When a Ruby exception occurs, you can inspect it in detail:
 (gdb) break rb_exc_raise
 (gdb) run
 (gdb) rb-context
-(gdb) rb-inspect $errinfo --depth 2
+(gdb) rb-print $errinfo --depth 2
 ~~~
 
 This shows the exception class, message, and any nested structures. The `rb-context` command displays the current execution context and sets up `$ec`, `$cfp`, and `$errinfo` convenience variables.
@@ -167,7 +167,7 @@ When working with fibers, you often need to see what each fiber is doing:
 Ruby hashes and arrays can contain nested structures:
 
 ~~~
-(gdb) rb-inspect $some_hash --depth 2
+(gdb) rb-print $some_hash --depth 2
 <T_HASH@...>
 [   0] K: <T_SYMBOL> :name
        V: <T_STRING@...> "Alice"
@@ -197,4 +197,4 @@ On macOS with LLDB and Ruby <= 3.4.x, some commands including `rb-fiber-scan-hea
 **Workarounds:**
 - Use Ruby head: `ruby-install ruby-head -- CFLAGS="-g -O0"`
 - Use GDB instead of LLDB (works with Ruby 3.4.x)
-- Other commands like `rb-inspect`, `rb-stack-trace`, `rb-context` work fine
+- Other commands like `rb-print`, `rb-stack-trace`, `rb-context` work fine

context/object-inspection.md

@@ -1,12 +1,12 @@
 # Object Inspection
 
-This guide explains how to use `rb-inspect` to inspect Ruby objects, hashes, arrays, and structs in GDB.
+This guide explains how to use `rb-print` to inspect Ruby objects, hashes, arrays, and structs in GDB.
 
 ## Why Object Inspection Matters
 
 When debugging Ruby programs or analyzing core dumps, you often need to inspect complex data structures that are difficult to read in their raw memory representation. Standard GDB commands show pointer addresses and raw memory, but not the logical structure of Ruby objects.
 
-Use `rb-inspect` when you need:
+Use `rb-print` when you need:
 
 - **Understand exception objects**: See the full exception hierarchy, message, and backtrace data
 - **Inspect fiber storage**: View thread-local data and fiber-specific variables
@@ -15,12 +15,12 @@ Use `rb-inspect` when you need:
 
 ## Basic Usage
 
-The `rb-inspect` command recursively prints Ruby objects in a human-readable format.
+The `rb-print` command recursively prints Ruby objects in a human-readable format.
 
 ### Syntax
 
 ~~~
-rb-inspect <expression> [--depth N] [--debug]
+rb-print <expression> [--depth N] [--debug]
 ~~~
 
 Where:
@@ -33,10 +33,10 @@ Where:
 Print immediate values and special constants:
 
 ~~~
-(gdb) rb-inspect 0        # <T_FALSE>
-(gdb) rb-inspect 8        # <T_NIL>
-(gdb) rb-inspect 20       # <T_TRUE>
-(gdb) rb-inspect 85       # <T_FIXNUM> 42
+(gdb) rb-print 0        # <T_FALSE>
+(gdb) rb-print 8        # <T_NIL>
+(gdb) rb-print 20       # <T_TRUE>
+(gdb) rb-print 85       # <T_FIXNUM> 42
 ~~~
 
 These work without any Ruby process running, making them useful for learning and testing.
@@ -46,10 +46,10 @@ These work without any Ruby process running, making them useful for learning and
 Use any valid GDB expression:
 
 ~~~
-(gdb) rb-inspect $ec->errinfo                    # Exception object
-(gdb) rb-inspect $ec->cfp->sp[-1]                # Top of VM stack
-(gdb) rb-inspect $ec->storage                    # Fiber storage hash
-(gdb) rb-inspect (VALUE)0x00007f8a12345678      # Object at specific address
+(gdb) rb-print $ec->errinfo                    # Exception object
+(gdb) rb-print $ec->cfp->sp[-1]                # Top of VM stack
+(gdb) rb-print $ec->storage                    # Fiber storage hash
+(gdb) rb-print (VALUE)0x00007f8a12345678      # Object at specific address
 ~~~
 
 ## Inspecting Hashes
@@ -61,7 +61,7 @@ Ruby hashes have two internal representations (ST table and AR table). The comma
 For hashes with fewer than 8 entries, Ruby uses an array-based implementation:
 
 ~~~
-(gdb) rb-inspect $some_hash
+(gdb) rb-print $some_hash
 <T_HASH@...>
 [   0] K: <T_SYMBOL> :name
        V: <T_STRING@...> "Alice"
@@ -76,7 +76,7 @@ For hashes with fewer than 8 entries, Ruby uses an array-based implementation:
 For larger hashes, Ruby uses a hash table (output format is similar):
 
 ~~~
-(gdb) rb-inspect $large_hash
+(gdb) rb-print $large_hash
 <T_HASH@...>
 [   0] K: <T_SYMBOL> :user_id
        V: <T_FIXNUM> 12345
@@ -90,12 +90,12 @@ For larger hashes, Ruby uses a hash table (output format is similar):
 Prevent overwhelming output from deeply nested structures:
 
 ~~~
-(gdb) rb-inspect $nested_hash --depth 1   # Only top level
+(gdb) rb-print $nested_hash --depth 1   # Only top level
 <T_HASH@...>
 [   0] K: <T_SYMBOL> :data
        V: <T_HASH@...>  # Nested hash not expanded
 
-(gdb) rb-inspect $nested_hash --depth 2   # Expand one level
+(gdb) rb-print $nested_hash --depth 2   # Expand one level
 <T_HASH@...>
 [   0] K: <T_SYMBOL> :data
        V: <T_HASH@...>
@@ -114,7 +114,7 @@ Arrays also have two representations based on size:
 Arrays display their elements with type information:
 
 ~~~
-(gdb) rb-inspect $array
+(gdb) rb-print $array
 <T_ARRAY@...>
 [   0] <T_FIXNUM> 1
 [   1] <T_FIXNUM> 2
@@ -124,7 +124,7 @@ Arrays display their elements with type information:
 For arrays with nested objects:
 
 ~~~
-(gdb) rb-inspect $array --depth 2
+(gdb) rb-print $array --depth 2
 <T_ARRAY@...>
 [   0] <T_STRING@...> "first item"
 [   1] <T_HASH@...>
@@ -138,7 +138,7 @@ For arrays with nested objects:
 Ruby Struct objects work similarly to arrays:
 
 ~~~
-(gdb) rb-inspect $struct_instance
+(gdb) rb-print $struct_instance
 <T_STRUCT@...>
 [   0] <T_STRING@...> "John"
 [   1] <T_FIXNUM> 25
@@ -155,7 +155,7 @@ When a fiber has an exception, inspect it:
 ~~~
 (gdb) rb-fiber-scan-heap
 (gdb) rb-fiber-scan-switch 5  # Switch to fiber #5
-(gdb) rb-inspect $errinfo --depth 3
+(gdb) rb-print $errinfo --depth 3
 ~~~
 
 This reveals the full exception structure including any nested causes. After switching to a fiber, `$errinfo` and `$ec` convenience variables are automatically set.
@@ -167,8 +167,8 @@ Break at a method and examine arguments on the stack:
 ~~~
 (gdb) break some_method
 (gdb) run
-(gdb) rb-inspect $ec->cfp->sp[-1]  # Last argument
-(gdb) rb-inspect $ec->cfp->sp[-2]  # Second-to-last argument
+(gdb) rb-print $ec->cfp->sp[-1]  # Last argument
+(gdb) rb-print $ec->cfp->sp[-2]  # Second-to-last argument
 ~~~
 
 ### Examining Fiber Storage
@@ -178,17 +178,17 @@ Thread-local variables are stored in fiber storage:
 ~~~
 (gdb) rb-fiber-scan-heap
 (gdb) rb-fiber-scan-switch 0
-(gdb) rb-inspect $ec->storage --depth 2
+(gdb) rb-print $ec->storage --depth 2
 ~~~
 
 This shows all thread-local variables and their values.
 
 ## Debugging with --debug Flag
 
-When `rb-inspect` doesn't show what you expect, use `--debug`:
+When `rb-print` doesn't show what you expect, use `--debug`:
 
 ~~~
-(gdb) rb-inspect $suspicious_value --debug
+(gdb) rb-print $suspicious_value --debug
 DEBUG: Evaluated '$suspicious_value' to 0x7f8a1c567890
 DEBUG: Loaded constant RUBY_T_MASK = 31
 DEBUG: Object at 0x7f8a1c567890 with flags=0x20040005, type=0x5

context/stack-inspection.md

@@ -140,9 +140,9 @@ See what values are on the current frame's stack:
 (gdb) set $sp = $ec->cfp->sp
 
 # Print values on stack
-(gdb) rb-inspect *(VALUE*)($sp - 1)  # Top of stack
-(gdb) rb-inspect *(VALUE*)($sp - 2)  # Second value
-(gdb) rb-inspect *(VALUE*)($sp - 3)  # Third value
+(gdb) rb-print *(VALUE*)($sp - 1)  # Top of stack
+(gdb) rb-print *(VALUE*)($sp - 2)  # Second value
+(gdb) rb-print *(VALUE*)($sp - 3)  # Third value
 ~~~
 
 ### Tracking Fiber Switches

data/toolbox/init.py

@@ -24,7 +24,7 @@
 
 # Try to load each extension individually
 extensions_to_load = [
-	('print', 'rb-inspect'),
+	('print', 'rb-print'),
 	('context', 'rb-context, rb-context-storage'),
 	('fiber', 'rb-fiber-scan-heap, rb-fiber-switch'),
 	('stack', 'rb-stack-trace'),
@@ -33,10 +33,8 @@
 
 for module_name, commands in extensions_to_load:
 	try:
-		print(f"DEBUG: Loading module {module_name}", file=sys.stderr)
 		if module_name == 'print':
 			import print as print_module
-			print(f"DEBUG: print module loaded successfully", file=sys.stderr)
 		elif module_name == 'context':
 			import context
 		elif module_name == 'fiber':
@@ -47,7 +45,7 @@
 			import heap
 		loaded_extensions.append((module_name, commands))
 	except Exception as e:
-		# Catch all exceptions, not just ImportError
+		# Catch all exceptions during module load
 		failed_extensions.append((module_name, str(e)))
 		import traceback
 		print(f"Failed to load {module_name}: {e}", file=sys.stderr)
@@ -60,9 +58,6 @@
 if debugger.DEBUGGER_NAME == 'lldb':
 	import lldb
 
-	# Debug: Show what commands are in the registry
-	print(f"DEBUG: Commands in registry: {list(debugger.Command._commands.keys())}", file=sys.stderr)
-	
 	# Get all registered commands
 	for cmd_name, cmd_obj in debugger.Command._commands.items():
 		# Create a wrapper function in this module's namespace

data/toolbox/print.py

@@ -1,10 +1,8 @@
-"""Object inspection command for Ruby values."""
+"""Print command for Ruby values."""
 
 import debugger
 import sys
 
-print("DEBUG: inspect.py is being loaded", file=sys.stderr)
-
 # Import utilities
 import command
 import constants
@@ -19,8 +17,6 @@
 import rbasic
 import format
 
-print("DEBUG: All imports done in inspect.py", file=sys.stderr)
-
 
 class RubyObjectPrinter:
 	"""Print Ruby objects with recursive descent into nested structures."""
@@ -79,16 +75,6 @@ def invoke(self, arguments, terminal, from_tty):
 					traceback.print_exc(file=sys.stderr)
 
 
-print("DEBUG: RubyObjectPrinter class defined", file=sys.stderr)
-
 # Register command using new interface
-print("DEBUG: About to register rb-inspect", file=sys.stderr)
-try:
-	print(f"DEBUG: Registering rb-inspect, debugger.register = {debugger.register}", file=sys.stderr)
-	result = debugger.register("rb-inspect", RubyObjectPrinter, usage=RubyObjectPrinter.USAGE)
-	print(f"DEBUG: Registration result = {result}", file=sys.stderr)
-except Exception as e:
-	print(f"ERROR: Failed to register rb-inspect: {e}", file=sys.stderr)
-	import traceback
-	traceback.print_exc(file=sys.stderr)
+debugger.register("rb-print", RubyObjectPrinter, usage=RubyObjectPrinter.USAGE)
 

data/toolbox/readme.md

@@ -14,7 +14,7 @@ data/toolbox/
 │   └── *.md                # Documentation
 │
 # Ruby debugging extensions (currently GDB-specific, migrating to abstraction)
-├── object.py               # Object inspection (rb-inspect)
+├── object.py               # Object inspection (rb-print)
 ├── fiber.py                # Fiber debugging (rb-fiber-scan-heap, rb-fiber-switch)
 ├── heap.py                 # Heap scanning (rb-heap-scan)
 ├── stack.py                # Stack inspection
@@ -113,7 +113,7 @@ command script import /path/to/gem/data/toolbox/init.py
 ## Available Commands
 
 ### Object Inspection
-- `rb-inspect <expression> [--depth N]` - Print Ruby objects with recursion
+- `rb-print <expression> [--depth N]` - Print Ruby objects with recursion
 
 ### Fiber Debugging
 - `rb-fiber-scan-heap [--limit N]` - Scan heap for fiber objects
@@ -151,14 +151,14 @@ command script import /path/to/gem/data/toolbox/init.py
 Test with GDB:
 ```bash
 gdb -q ruby
-(gdb) help rb-inspect
+(gdb) help rb-print
 (gdb) help rb-fiber-scan-heap
 ```
 
 Test with LLDB (once migrated):
 ```bash
 lldb ruby
-(lldb) help rb-inspect
+(lldb) help rb-print
 (lldb) help rb-fiber-scan-heap
 ```
 

fixtures/toolbox/gdb/object/can_handle_bignum.gdb

@@ -8,6 +8,6 @@ break ruby_process_options
 run
 set $value = rb_eval_string("[123456789012345678901234567890, -999999999999999999999999999999]")
 echo ===TOOLBOX-OUTPUT-START===\n
-rb-inspect $value
+rb-print $value
 echo ===TOOLBOX-OUTPUT-END===\n
 quit

fixtures/toolbox/gdb/object/can_handle_debug_flag.gdb

@@ -2,6 +2,6 @@
 
 source data/toolbox/init.py
 
-rb-inspect 85 --debug
+rb-print 85 --debug
 quit
 

fixtures/toolbox/gdb/object/can_handle_depth_flag.gdb

@@ -2,6 +2,6 @@
 
 source data/toolbox/init.py
 
-rb-inspect 85 --depth 3
+rb-print 85 --depth 3
 quit