Gecko [ naturenectar.co.uk ]

Name	Size	Permission	Date
bigdecimal	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
cgi	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
csv	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
did_you_mean	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
digest	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
drb	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
erb	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
error_highlight	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
fiddle	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
forwardable	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
io	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
json	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
logger	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
net	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
objspace	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
open3	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
openssl	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
optparse	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
prism	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
psych	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
random	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
reline	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
rinda	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
ripper	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
ruby_vm	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
set	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
syntax_suggest	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
syslog	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
unicode_normalize	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
uri	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
vendor_ruby	[ DIR ]	drwxr-xr-x	2025-04-24 08:18
yaml	[ DIR ]	drwxr-xr-x	2025-08-15 19:34
English.rb	5.54 KB	-rw-r--r--	2025-04-24 08:18
abbrev.rb	3.47 KB	-rw-r--r--	2025-04-24 08:18
base64.rb	13.22 KB	-rw-r--r--	2025-04-24 08:18
benchmark.rb	18.42 KB	-rw-r--r--	2025-04-24 08:18
bigdecimal.rb	130 B	-rw-r--r--	2025-04-24 08:18
bundled_gems.rb	6.86 KB	-rw-r--r--	2025-04-24 08:18
cgi.rb	9.83 KB	-rw-r--r--	2025-04-24 08:18
coverage.rb	368 B	-rw-r--r--	2025-04-24 08:18
csv.rb	92.46 KB	-rw-r--r--	2025-04-24 08:18
date.rb	1.17 KB	-rw-r--r--	2025-04-24 08:18
delegate.rb	11.68 KB	-rw-r--r--	2025-04-24 08:18
did_you_mean.rb	5.36 KB	-rw-r--r--	2025-04-24 08:18
digest.rb	3.3 KB	-rw-r--r--	2025-04-24 08:18
drb.rb	50 B	-rw-r--r--	2025-04-24 08:18
erb.rb	14.53 KB	-rw-r--r--	2025-04-24 08:18
error_highlight.rb	84 B	-rw-r--r--	2025-04-24 08:18
expect.rb	2.19 KB	-rw-r--r--	2025-04-24 08:18
fiddle.rb	2.88 KB	-rw-r--r--	2025-04-24 08:18
fileutils.rb	78.69 KB	-rw-r--r--	2025-04-24 08:18
find.rb	2.52 KB	-rw-r--r--	2025-04-24 08:18
forwardable.rb	9.03 KB	-rw-r--r--	2025-04-24 08:18
getoptlong.rb	20.26 KB	-rw-r--r--	2025-04-24 08:18
ipaddr.rb	20.93 KB	-rw-r--r--	2025-04-24 08:18
json.rb	19.62 KB	-rw-r--r--	2025-04-24 08:18
kconv.rb	5.72 KB	-rw-r--r--	2025-04-24 08:18
logger.rb	22.03 KB	-rw-r--r--	2025-04-24 08:18
mkmf.rb	88.69 KB	-rw-r--r--	2025-04-24 08:18
monitor.rb	6.75 KB	-rw-r--r--	2025-04-24 08:18
mutex_m.rb	2.36 KB	-rw-r--r--	2025-04-24 08:18
objspace.rb	4.14 KB	-rw-r--r--	2025-04-24 08:18
observer.rb	6.38 KB	-rw-r--r--	2025-04-24 08:18
open-uri.rb	25.84 KB	-rw-r--r--	2025-04-24 08:18
open3.rb	47.51 KB	-rw-r--r--	2025-04-24 08:18
openssl.rb	1.03 KB	-rw-r--r--	2025-04-24 08:18
optionparser.rb	59 B	-rw-r--r--	2025-04-24 08:18
optparse.rb	61.82 KB	-rw-r--r--	2025-04-24 08:18
ostruct.rb	14.22 KB	-rw-r--r--	2025-04-24 08:18
pathname.rb	16.85 KB	-rw-r--r--	2025-04-24 08:18
pp.rb	17.24 KB	-rw-r--r--	2025-04-24 08:18
prettyprint.rb	15.93 KB	-rw-r--r--	2025-04-24 08:18
prism.rb	3.17 KB	-rw-r--r--	2025-04-24 08:18
pstore.rb	20.36 KB	-rw-r--r--	2025-04-24 08:18
psych.rb	24.44 KB	-rw-r--r--	2025-04-24 08:18
readline.rb	215 B	-rw-r--r--	2025-04-24 08:18
reline.rb	14.7 KB	-rw-r--r--	2025-04-24 08:18
resolv-replace.rb	1.76 KB	-rw-r--r--	2025-04-24 08:18
resolv.rb	85.03 KB	-rw-r--r--	2025-04-24 08:18
ripper.rb	2.44 KB	-rw-r--r--	2025-04-24 08:18
securerandom.rb	2.06 KB	-rw-r--r--	2025-04-24 08:18
set.rb	24.94 KB	-rw-r--r--	2025-04-24 08:18
shellwords.rb	7.11 KB	-rw-r--r--	2025-04-24 08:18
singleton.rb	3.94 KB	-rw-r--r--	2025-04-24 08:18
socket.rb	44.04 KB	-rw-r--r--	2025-04-24 08:18
syntax_suggest.rb	74 B	-rw-r--r--	2025-04-24 08:18
tempfile.rb	14.73 KB	-rw-r--r--	2025-04-24 08:18
time.rb	23.74 KB	-rw-r--r--	2025-04-24 08:18
timeout.rb	5.69 KB	-rw-r--r--	2025-04-24 08:18
tmpdir.rb	4.93 KB	-rw-r--r--	2025-04-24 08:18
tsort.rb	14.29 KB	-rw-r--r--	2025-04-24 08:18
un.rb	11.17 KB	-rw-r--r--	2025-04-24 08:18
uri.rb	3.06 KB	-rw-r--r--	2025-04-24 08:18
weakref.rb	1.36 KB	-rw-r--r--	2025-04-24 08:18
yaml.rb	2.13 KB	-rw-r--r--	2025-04-24 08:18

Rename

# frozen_string_literal: true

require 'objspace.so'

module ObjectSpace
  class << self
    private :_dump
    private :_dump_all
    private :_dump_shapes
  end

module_function

# Dump the contents of a ruby object as JSON.
  #
  # _output_ can be one of: +:stdout+, +:file+, +:string+, or IO object.
  #
  # * +:file+ means dumping to a tempfile and returning corresponding File object;
  # * +:stdout+ means printing the dump and returning +nil+;
  # * +:string+ means returning a string with the dump;
  # * if an instance of IO object is provided, the output goes there, and the object
  #   is returned.
  #
  # 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

ret = _dump(obj, out)
    return nil if output == :stdout
    ret
  end

# Dump the contents of the ruby heap as JSON.
  #
  # _output_ argument is the same as for #dump.
  #
  # _full_ must be a boolean. If true, all heap slots are dumped including the empty ones (+T_NONE+).
  #
  # _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.
  #
  # _shapes_ must be a boolean or a non-negative integer.
  #
  # If _shapes_ is a positive integer, only shapes newer than the provided
  # shape id are dumped. The current shape_id can be accessed using <tt>RubyVM.stat(:next_shape_id)</tt>.
  #
  # If _shapes_ is +false+, no shapes are dumped.
  #
  # To only dump objects allocated past a certain point you can combine _since_ and _shapes_:
  #   ObjectSpace.trace_object_allocations
  #   GC.start
  #   gc_generation = GC.count
  #   shape_generation = RubyVM.stat(:next_shape_id)
  #   call_method_to_instrument
  #   ObjectSpace.dump_all(since: gc_generation, shapes: shape_generation)
  #
  # 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, shapes: true)
    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

shapes = 0 if shapes == true
    ret = _dump_all(out, full, since, shapes)
    return nil if output == :stdout
    ret
  end

#  Dump the contents of the ruby shape tree as JSON.
  #
  #  _output_ argument is the same as for #dump.
  #
  #  If _since_ is a positive integer, only shapes newer than the provided
  #  shape id are dumped. The current shape_id can be accessed using <tt>RubyVM.stat(:next_shape_id)</tt>.
  #
  #  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_shapes(output: :file, since: 0)
    out = case output
    when :file, nil
      require 'tempfile'
      Tempfile.create(%w(rubyshapes .json))
    when :stdout
      STDOUT
    when :string
      +''
    when IO
      output
    else
      raise ArgumentError, "wrong output option: #{output.inspect}"
    end

ret = _dump_shapes(out, since)
    return nil if output == :stdout
    ret
  end
end