memory 0.6.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8ab40ebc992286597b6a01b5157fca5393b29563c7131483d2e7839f15172541
-  data.tar.gz: d5b9b73ea305840435c242a6e34bf755d94e77350846f6618467fef4fa7561ff
+  metadata.gz: 266bdfec74c35392a9c086c366df9bb6ab4fb5e1b162b98d3757f690fff09ded
+  data.tar.gz: dffe8472314144b5786b5c445c6e01973114e9c3915d08aae0352fc1be76d329
 SHA512:
-  metadata.gz: 5a10c287ab778c7deb2e12b5a04e7214107ae7afbdf12e57af3423128fe0dc9c233735892ae97ec18d90f47ba46856f08ab5624389a1cb61dbdc4d9af3733bf3
-  data.tar.gz: db0d83a8c69a4bdf37e058d6a9e304a7b0608791f8a1f89ad1f2864f2d4119aa8c61c9726b813800e4b45506e1cfa2eec7227ca8eeed99170b931927878e4efb
+  metadata.gz: 4dcf3e65b4a7dee68b55919dc44004149a6febe80fde00d539d2b0361eea62dd47ab742006ef7ed75a2980829f0f58cbf1c341098ae394ac4ac3b7a4d816752b
+  data.tar.gz: '038621f8d88603eb8b0b2a89fe13e4007bc100ce0c16c53febd9d02a6cf4fa3a00c6c3e967bfa8a6aa6507e3611266cae774dc016d330fe5b22d5322beee12e3'

checksums.yaml.gz.sig

@@ -1,2 +1,2 @@
-5�^�R�M�(�KD��n����^�z<~�"�i�yAP����Qt��p�<D��2jlyIe�xf	���W�bS��:L�n��@
-g��A]�%��Pn�fG>b��?x�#�ն�h�	���D�&y
+=��z�6�r��g9��j�V�,��$�$0�����SP��.��?֋�Yb
+�F�$��}����rM�|H�n���U�̮�T��q��`�i0� q��zA=b:���@)��������3�;p������-N�����6.$Zc��] �d��
�O�{@"���M���?���SWQ�-�

data/bake/memory/report.rb

@@ -5,7 +5,7 @@
 
 def initialize(...)
 	super
-
+	
 	require_relative "../../lib/memory"
 end
 
@@ -26,6 +26,6 @@ def print(input:)
 	end
 	
 	report.print($stderr)
-
+	
 	return report
 end

data/bake/memory/sampler.rb

@@ -6,7 +6,7 @@
 def initialize(...)
 	super
 	
-	require_relative '../../lib/memory'
+	require_relative "../../lib/memory"
 end
 
 # Load a sampler from one or more .mprof files.
@@ -27,7 +27,7 @@ def load(paths:)
 	paths.each do |path|
 		Console.logger.info(sampler, "Loading #{path}, #{Memory.formatted_bytes File.size(path)}")
 		
-		File.open(path, 'r', encoding: Encoding::BINARY) do |io|
+		File.open(path, "r", encoding: Encoding::BINARY) do |io|
 			unpacker = wrapper.unpacker(io)
 			count = unpacker.read_array_header
 			
@@ -56,7 +56,7 @@ end
 # @parameter output [String] Path to write the .mprof file.
 # @returns [Memory::Sampler] The input sampler.
 def dump(path, input:)
-	File.open(path, 'w', encoding: Encoding::BINARY) do |io|
+	File.open(path, "w", encoding: Encoding::BINARY) do |io|
 		input.dump(io)
 	end
 	
@@ -76,7 +76,7 @@ def load_object_space_dump(path)
 	Console.logger.info(self, "Loading heap dump from #{path} (#{Memory.formatted_bytes(file_size)})")
 	
 	sampler = nil
-	File.open(path, 'r') do |io|
+	File.open(path, "r") do |io|
 		sampler = Memory::Sampler.load_object_space_dump(io) do |line_count, object_count|
 			# Update progress based on bytes read:
 			progress.increment(io.pos - progress.current)

data/lib/memory/report.rb

@@ -90,16 +90,16 @@ module Memory
 			}
 		end
 		
-	# Convert this report to a JSON string.
-	# @returns [String] JSON representation of this report.
-	def to_json(...)
-		as_json.to_json(...)
-	end
-
-	# Generate a human-readable representation of this report.
-	# @returns [String] Summary showing allocated and retained totals.
-	def inspect
-		"#<#{self.class}: #{@total_allocated} allocated, #{@total_retained} retained>"
+		# Convert this report to a JSON string.
+		# @returns [String] JSON representation of this report.
+		def to_json(...)
+			as_json.to_json(...)
+		end
+		
+		# Generate a human-readable representation of this report.
+		# @returns [String] Summary showing allocated and retained totals.
+		def inspect
+			"#<#{self.class}: #{@total_allocated} allocated, #{@total_retained} retained>"
+		end
 	end
 end
-end

data/lib/memory/sampler.rb

@@ -66,72 +66,72 @@ module Memory
 	# end
 	# ~~~
 	class Sampler
-	# Load allocations from an ObjectSpace heap dump.
-	#
-	# If a block is given, it will be called periodically with progress information.
-	#
-	# @parameter io [IO] The IO stream containing the heap dump JSON.
-	# @yields [line_count, object_count] Progress callback with current line and object counts.
-	# @returns [Sampler] A new sampler populated with allocations from the heap dump.
-	def self.load_object_space_dump(io, &block)
-		sampler = new
-		cache = sampler.cache
-		
-		line_count = 0
-		object_count = 0
-		report_interval = 10000
-		
-		io.each_line do |line|
-			line_count += 1
-			
-			begin
-				object = JSON.parse(line)
-			rescue JSON::ParserError
-				# Skip invalid JSON lines
-				next
-			end
-			
-			# Skip non-object entries (ROOT, SHAPE, etc.)
-			next unless object['address']
+		# Load allocations from an ObjectSpace heap dump.
+		#
+		# If a block is given, it will be called periodically with progress information.
+		#
+		# @parameter io [IO] The IO stream containing the heap dump JSON.
+		# @yields [line_count, object_count] Progress callback with current line and object counts.
+		# @returns [Sampler] A new sampler populated with allocations from the heap dump.
+		def self.load_object_space_dump(io, &block)
+			sampler = new
+			cache = sampler.cache
 			
-			# Get allocation information (may be nil if tracing wasn't enabled)
-			file = object['file'] || '(unknown)'
-			line_number = object['line'] || 0
+			line_count = 0
+			object_count = 0
+			report_interval = 10000
 			
-			# Get object type/class
-			type = object['type'] || 'unknown'
-			
-			# Get memory size
-			memsize = object['memsize'] || 0
-			
-			# Get value for strings
-			value = object['value']
-			
-			allocation = Allocation.new(
-				cache,
-				type,           # class_name
-				file,           # file
-				line_number,    # line
-				memsize,        # memsize
-				value,          # value (for strings)
-				true            # retained (all objects in heap dump are live)
-			)
+			io.each_line do |line|
+				line_count += 1
+				
+				begin
+					object = JSON.parse(line)
+				rescue JSON::ParserError
+					# Skip invalid JSON lines
+					next
+				end
+				
+				# Skip non-object entries (ROOT, SHAPE, etc.)
+				next unless object["address"]
+				
+				# Get allocation information (may be nil if tracing wasn't enabled)
+				file = object["file"] || "(unknown)"
+				line_number = object["line"] || 0
+				
+				# Get object type/class
+				type = object["type"] || "unknown"
+				
+				# Get memory size
+				memsize = object["memsize"] || 0
+				
+				# Get value for strings
+				value = object["value"]
+				
+				allocation = Allocation.new(
+					cache,
+					type,           # class_name
+					file,           # file
+					line_number,    # line
+					memsize,        # memsize
+					value,          # value (for strings)
+					true            # retained (all objects in heap dump are live)
+				)
+				
+				sampler.allocated << allocation
+				object_count += 1
+				
+				# Report progress periodically
+				if block && (object_count % report_interval == 0)
+					block.call(line_count, object_count)
+				end
+			end
 			
-			sampler.allocated << allocation
-			object_count += 1
+			# Final progress report
+			block.call(line_count, object_count) if block
 			
-			# Report progress periodically
-			if block && (object_count % report_interval == 0)
-				block.call(line_count, object_count)
-			end
+			return sampler
 		end
 		
-		# Final progress report
-		block.call(line_count, object_count) if block
-					
-		return sampler
-	end
-		
 		# Initialize a new sampler.
 		# @parameter filter [Block | Nil] Optional filter block to select which allocations to track.
 		def initialize(&filter)
@@ -231,6 +231,22 @@ module Memory
 			return report
 		end
 		
+		# Convert this sampler to a JSON-compatible summary.
+		# Returns the allocation count without iterating through all allocations.
+		# @parameter options [Hash | Nil] Optional JSON serialization options.
+		# @returns [Hash] JSON-compatible summary of sampler data.
+		def as_json(options = nil)
+			{
+				allocations: @allocated.size
+			}
+		end
+		
+		# Convert this sampler to a JSON string.
+		# @returns [String] JSON representation of this sampler summary.
+		def to_json(...)
+			as_json.to_json(...)
+		end
+		
 		# Collects object allocation and memory of ruby code inside of passed block.
 		def run(&block)
 			start

data/lib/memory/version.rb

@@ -4,8 +4,8 @@
 # Copyright, 2013-2019, by Sam Saffron.
 # Copyright, 2015-2016, by Dave Gynn.
 # Copyright, 2018, by Jonas Peschla.
-# Copyright, 2020-2024, by Samuel Williams.
+# Copyright, 2020-2025, by Samuel Williams.
 
 module Memory
-	VERSION = "0.6.1"
+	VERSION = "0.7.0"
 end

data/readme.md

@@ -94,6 +94,10 @@ end
 
 Please see the [project releases](https://socketry.github.io/memory/releases/index) for all releases.
 
+### v0.7.0
+
+  - Add `Memory::Sampler#as_json` and `#to_json`.
+
 ### v0.6.0
 
   - Add agent context.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.7.0
+
+  - Add `Memory::Sampler#as_json` and `#to_json`.
+
 ## v0.6.0
 
   - Add agent context.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: memory
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Sam Saffron