# frozen_string_literal: true require 'objspace.so' module ObjectSpace class << self private :_dump private :_dump_all end module_function # call-seq: # ObjectSpace.dump(obj[, output: :string]) # => "{ ... }" # ObjectSpace.dump(obj, output: :file) # => # # ObjectSpace.dump(obj, output: :stdout) # => nil # # Dump the contents of a ruby object as JSON. # # This method is only expected to work with C Ruby. # This is an experimental method and is subject to change. # In particular, the function signature and output format are # not guaranteed to be compatible in future versions of ruby. def dump(obj, output: :string) out = case output when :file, nil require 'tempfile' Tempfile.create(%w(rubyobj .json)) when :stdout STDOUT when :string +'' when IO output else raise ArgumentError, "wrong output option: #{output.inspect}" end _dump(obj, out) end # call-seq: # ObjectSpace.dump_all([output: :file]) # => # # ObjectSpace.dump_all(output: :stdout) # => nil # ObjectSpace.dump_all(output: :string) # => "{...}\n{...}\n..." # ObjectSpace.dump_all(output: # File.open('heap.json','w')) # => # # ObjectSpace.dump_all(output: :string, # since: 42) # => "{...}\n{...}\n..." # # Dump the contents of the ruby heap as JSON. # # _since_ must be a non-negative integer or +nil+. # # If _since_ is a positive integer, only objects of that generation and # newer generations are dumped. The current generation can be accessed using # GC::count. # # Objects that were allocated without object allocation tracing enabled # are ignored. See ::trace_object_allocations for more information and # examples. # # If _since_ is omitted or is +nil+, all objects are dumped. # # This method is only expected to work with C Ruby. # This is an experimental method and is subject to change. # In particular, the function signature and output format are # not guaranteed to be compatible in future versions of ruby. def dump_all(output: :file, full: false, since: nil) out = case output when :file, nil require 'tempfile' Tempfile.create(%w(rubyheap .json)) when :stdout STDOUT when :string +'' when IO output else raise ArgumentError, "wrong output option: #{output.inspect}" end _dump_all(out, full, since) end end