memory 0.8.3 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b83713d537a03a16799ac6f3cde42daad364061ac4baeadaced28a1ebf3206f
-  data.tar.gz: cde6c17579def23346ad980303d1d2cb57a7574ca59eec2656ae62ca132ff8d9
+  metadata.gz: 535ecdd0c6181d94b31384e4f71b4b4ce52d499d43daa647120fb22cf3dc244b
+  data.tar.gz: bfc66be86d65f7065ebc6a4193420ccbe50a98ad5e581ba6cf613484d1846012
 SHA512:
-  metadata.gz: c4ded3952cdb38c6f9e0d15e9f98a0da1267da1bd85b9f0810b0d16385fa16246d40925e2ffb58942cd73a20ca7038d1b49d99e6a9b9292d27fe75ec57b0e65e
-  data.tar.gz: 16eef76d5864170493759bed3c39aec78a4696b5ccd4ba91d2cc8caad13d0578c89e1d2f37dabc9713b21e9ee0a4f6d6a4fceea233cdfefe32ca3c8185bda4c2
+  metadata.gz: e2df82be2210853cdc3ede7d47d450d1a38bc14291ee4fdaa3bece83809ce78ffb73ae714d52da9843dbd43d2659e6a97b17005ecbf3abe1f81fe8a687b0cbc5
+  data.tar.gz: de6c8972b60a489e7f62834fe926674ed55103fae47a401ef81674b43a8a79b271a8b21051948c56b094a0372abb5493c78739265686b4c4591272ffd70b8f4b

data/lib/memory/aggregate.rb

@@ -36,7 +36,7 @@ module Memory
 		end
 		
 		# Sort totals by a given key.
-		# @parameter key [Symbol] The key to sort by (e.g., :memory or :count).
+		# @parameter key [Symbol] The key to sort by (e.g., :size or :count).
 		# @returns [Array] Sorted array of [metric, total] pairs.
 		def totals_by(key)
 			@totals.sort_by{|metric, total| [total[key], metric]}
@@ -50,7 +50,7 @@ module Memory
 		def print(io = $stderr, limit: 10, title: @title, level: 2)
 			io.puts "#{'#' * level} #{title} #{@total}", nil
 			
-			totals_by(:memory).last(limit).reverse_each do |metric, total|
+			totals_by(:size).last(limit).reverse_each do |metric, total|
 				io.puts "- #{total}\t#{metric}"
 			end
 			

data/lib/memory/usage.rb

@@ -19,10 +19,17 @@ module Memory
 		attr_accessor :size
 		
 		alias memsize size
+		alias memory size
 		
 		# @attribute count [Integer] The total count of the usage in object instances.
 		attr_accessor :count
 		
+		# Access usage attributes by key.
+		# @parameter key [Symbol] The attribute name (:size, :count, :memory, :memsize).
+		def [](key)
+			public_send(key)
+		end
+		
 		# Add an allocation to this usage.
 		# @parameter allocation [Allocation] The allocation to add.
 		def << allocation
@@ -32,12 +39,27 @@ module Memory
 			return self
 		end
 		
+		IGNORE = [
+			# Skip modules and symbols, they are usually "global":
+			Module,
+			# Note that `reachable_objects_from` does not include symbols, numbers, or other value types, AFAICT.
+			
+			Proc,
+			Method,
+			UnboundMethod,
+			Binding,
+			TracePoint,
+			
+			# We don't want to traverse into shared state:
+			Ractor,
+			Thread,
+			Fiber
+		]
+		
 		# Compute the usage of an object and all reachable objects from it.
 		# @parameter root [Object] The root object to start traversal from.
 		# @returns [Usage] The usage of the object and all reachable objects from it.
-		def self.of(root)
-			seen = Set.new.compare_by_identity
-			
+		def self.of(root, seen: Set.new.compare_by_identity, ignore: IGNORE)
 			count = 0
 			size = 0
 			
@@ -45,9 +67,8 @@ module Memory
 			while queue.any?
 				object = queue.shift
 				
-				# Skip modules and symbols, they are usually "global":
-				next if object.is_a?(Module)
-				# Note that `reachable_objects_from` does not include symbols, numbers, or other value types, AFAICT.
+				# Skip ignored types:
+				next if ignore.any?{|type| object.is_a?(type)}
 				
 				# Skip internal objects - they don't behave correctly when added to `seen` and create unbounded recursion:
 				next if object.is_a?(ObjectSpace::InternalObjectWrapper)

data/lib/memory/version.rb

@@ -7,5 +7,5 @@
 # Copyright, 2020-2025, by Samuel Williams.
 
 module Memory
-	VERSION = "0.8.3"
+	VERSION = "0.9.0"
 end

data/readme.md

@@ -94,6 +94,14 @@ end
 
 Please see the [project releases](https://socketry.github.io/memory/releases/index) for all releases.
 
+### v0.9.0
+
+  - Explicit `ignore:` and `seen:` parameters for `Memory::Usage.of` to allow customization of ignored types and tracking of seen objects.
+
+### v0.8.4
+
+  - Fix bugs when printing reports due to interface mismatch with `Memory::Usage`.
+
 ### v0.8.3
 
   - Handle `Memory::Usage.of(number)` without error.

data/releases.md

@@ -1,5 +1,13 @@
 # Releases
 
+## v0.9.0
+
+  - Explicit `ignore:` and `seen:` parameters for `Memory::Usage.of` to allow customization of ignored types and tracking of seen objects.
+
+## v0.8.4
+
+  - Fix bugs when printing reports due to interface mismatch with `Memory::Usage`.
+
 ## v0.8.3
 
   - Handle `Memory::Usage.of(number)` without error.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: memory
 version: !ruby/object:Gem::Version
-  version: 0.8.3
+  version: 0.9.0
 platform: ruby
 authors:
 - Sam Saffron
@@ -29,7 +29,6 @@ authors:
 - Olle Jonsson
 - Vasily Kolesnikov
 - William Tabi
-autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -61,7 +60,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2025-10-29 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bake
@@ -105,8 +104,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description:
-email:
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -133,7 +130,6 @@ licenses:
 metadata:
   documentation_uri: https://socketry.github.io/memory/
   source_code_uri: https://github.com/socketry/memory.git
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -148,8 +144,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 3.7.2
 specification_version: 4
 summary: Memory profiling routines for Ruby 2.3+
 test_files: []

metadata.gz.sig

@@ -1,4 +1,3 @@
-�G;�
-��d3�u�(�Q�9q�X��
-�:�L�@�3\��5K�F����@G�6[�%�g�p��To�y�m�xo��M�}Q��Y5k5�ݚ����H�]_��e��鬁E�\�k�w1s��h!��~0#2��B �P���/ȗ�4��Diw�c�Qj���~��r3y�:���&j��R�9M�ޖ�
-��Fx�Z��t_�\])c�}7�j}O��v�ܺ�����|ӈ��\i������dʺ�N����8K���v��9@rC1	1<p�[?R��:^���m
%��E*D?J��x؄v�=to�����jٖ,\P�냢�$Ņ�
+R�,դ�J=�o����(��vI�9M�&��̾
+DP�`Z�#$�i���y�j;��Z�k0�L82��������o�uND�%B�W��U�a�Wiܛ��Cr1�y|�nq7��)���k�>|�6�'i-�X��5�G8\�E��p�ڶ~�{q���q��ތ����l=��F"�(�0�@���ؓ���q!߅k)m���2���|�[F`�*����C��������[��Cl���]��i����|u`tK����;�x1o�
p�
+�񨵶o����c))IZ&�P���`$q�hgo