process-metrics 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1dfdad473ae6b2f7680c1c62bf67144c0451014c61e6a4d9c38650d2b51dcc86
-  data.tar.gz: 5938c811e5b7cab7d849b9430236bd60712158fe744ee5b494e3d01f0ed49997
+  metadata.gz: cbfff6ee5c7b2f09e1872bfaf86b520d999c94295de8d2328140ffeb84baa228
+  data.tar.gz: 2318ca3ac6a699863015b0f4ac32d22ee8845466f7046feee0155e89b9c5c5a8
 SHA512:
-  metadata.gz: 2c607a0f1eb78abe097463ebd46784f2212b60b6bc5590dff646aecac131e5da59eb0e3a5ea082943c66d3fc0cb4425d19abb3596ed0350aec51718ac6fb4244
-  data.tar.gz: 420abffc1c85856674376cf95455972e58a18b18591ccc003be3e0d9bad6212d17587d93e10c0ec06691c60c187ba43e80af472c8c74be619f4e06f370780d3d
+  metadata.gz: b4a69c2cc8a4055fcb9cd3612459b4e1a1164b8a4ac4095dafc8e7b51126915c79673b6023bc09f87357d69ac0aaf71e0caae9c2d3dd6a4fd3a7f8482d368b00
+  data.tar.gz: 17363223b2c6858e5f2e0241267e6dbaf6e97f58631483ef95af6fd7ad349d59915a8e486a27011a259c64f290f4da8ced1ea96e47bb3d0eb193c877ffdf2591

checksums.yaml.gz.sig

@@ -1,2 +1,2 @@
-l���Ҫ�+n��VT��*�[��p5�-�Ǭ��췯����
���u�,�﫢�o1L̑��lH	��U�i�rE+�56��V���8�4*haM�[��6]���G
�	3L.N>�ڌ����|c<�LN�{S����ֻ:(�$�h�vN{���4�� ����KkA�����[wӢ�9�u9JE�m1�t�������v\_Li�`�ШY�;;�Q�8�ѿ[|����C�X�[~dz��?�5t-�S#0��K_�lL����B51V�`9��6�3,� p��w%1�?�-���4<ziY��Du�!"@ /e/J��(����U��[|��\��V���?QC��D�u�~D�q�(�!�]�������oj"$
-0T0��y4��z���
+�) ��w�RC
���*!�i&c��ը
�+#�]���?�-Z,:T&����~`
+�fõ9�mZߤx5$Юs��}��)�C̙}�6�X}�;q�u�����z�KB�<8��|��Ѻ�wg�"�0>�6��[ZRѦ�w?Al��O�i��n|�-�{� � �����o/�t2�1�vu�\��3�sgb��WcL/�5yoF��h+e�/T�ڧ3|;IV
EM��ۏ�r�Q�T�|�4�j_�:��=�����9�].�EN�Q�g��u�4�Ѵ�9\��_���

data/bin/process-metrics

@@ -21,7 +21,7 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 # THE SOFTWARE.
 
-require_relative '../lib/process/metrics/command'
+require_relative "../lib/process/metrics/command"
 
 begin
 	Process::Metrics::Command.call

data/lib/process/metrics/command/summary.rb

@@ -1,13 +1,13 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2020-2024, by Samuel Williams.
+# Copyright, 2020-2025, by Samuel Williams.
 
-require 'samovar'
+require "samovar"
 
-require_relative '../general'
+require_relative "../general"
 
-require 'console/terminal'
+require "console/terminal"
 
 module Process
 	module Metrics
@@ -42,10 +42,10 @@ module Process
 				self.description = "Display a summary of memory usage statistics."
 				
 				options do
-					option '--pid <integer>', "Report on a single process id.", type: Integer, required: true
-					option '-p/--ppid <integer>', "Report on all children of this process id.", type: Integer, required: true
+					option "--pid <integer>", "Report on a single process id.", type: Integer, required: true
+					option "-p/--ppid <integer>", "Report on all children of this process id.", type: Integer, required: true
 					
-					option '--memory-scale <integer>', "Scale maximum memory usage to the specified amount (MiB).", type: Integer, default: 512
+					option "--total-memory <integer>", "Set the total memory relative to the usage (MiB).", type: Integer
 				end
 				
 				def terminal
@@ -89,18 +89,26 @@ module Process
 					return "#{value.round(unit)}#{units[unit]}"
 				end
 				
-				def format_memory_usage(value, terminal, scale: @options[:memory_scale])
-					if value > (1024.0 * scale * 0.8)
+				def format_memory(value, total, terminal)
+					if value > (total * 0.8)
 						intensity = :high
-					elsif value > (1024.0 * scale * 0.5)
+					elsif value > (total * 0.5)
 						intensity = :medium
 					else
 						intensity = :low
 					end
 					
-					formatted = (format_size(value) + ' ').rjust(10)
+					formatted = (format_size(value) + " ").rjust(10)
 					
-					terminal.print(formatted, intensity, "[", Bar.format(value / (1024.0 * scale), 60), "]", :reset)
+					terminal.print(formatted, intensity, "[", Bar.format(value / total.to_f, 60), "]", :reset)
+				end
+				
+				def total_memory
+					if total_memory = @options[:total_memory]
+						return total_memory * 1024
+					else
+						return Process::Metrics::Memory.total_size
+					end
 				end
 				
 				def call
@@ -108,9 +116,10 @@ module Process
 					
 					summary = Process::Metrics::General.capture(pid: @options[:pid], ppid: @options[:ppid])
 					
-					format_memory_usage = self.method(:format_memory_usage).curry
-					shared_memory_usage = 0
-					private_memory_usage = 0
+					format_memory = self.method(:format_memory).curry
+					shared_memory = 0
+					private_memory = 0
+					total_memory = self.total_memory
 					
 					proportional = true
 					
@@ -122,25 +131,25 @@ module Process
 						terminal.print_line
 						
 						if memory = general.memory
-							shared_memory_usage += memory.proportional_size
-							private_memory_usage += memory.unique_size
+							shared_memory += memory.proportional_size
+							private_memory += memory.unique_size
 							
 							terminal.print_line(
-								:key, "Memory (PSS): ".rjust(20), :reset,
-								format_memory_usage[memory.proportional_size]
+								:key, "Memory: ".rjust(20), :reset,
+								format_memory[memory.proportional_size, total_memory]
 							)
 							
 							terminal.print_line(
-								:key, "Private (USS): ".rjust(20), :reset,
-								format_memory_usage[memory.unique_size]
+								:key, "Private Memory: ".rjust(20), :reset,
+								format_memory[memory.unique_size, total_memory]
 							)
 						else
-							shared_memory_usage += general.rss
+							shared_memory += general.resident_size
 							proportional = false
 							
 							terminal.print_line(
-								:key, "Memory (RSS): ".rjust(20), :reset,
-								format_memory_usage[general.rss]
+								:key, "Memory: ".rjust(20), :reset,
+								format_memory[general.resident_size, total_memory]
 							)
 						end
 					end
@@ -149,24 +158,24 @@ module Process
 					
 					if proportional
 						terminal.print_line(
-							:key, "Memory (PSS): ".rjust(20), :reset,
-							format_memory_usage[shared_memory_usage]
+							:key, "Memory: ".rjust(20), :reset,
+							format_memory[shared_memory, total_memory]
 						)
 						
 						terminal.print_line(
-							:key, "Memory (USS): ".rjust(20), :reset,
-							format_memory_usage[private_memory_usage]
+							:key, "Private Memory: ".rjust(20), :reset,
+							format_memory[private_memory, total_memory]
 						)
 					else
 						terminal.print_line(
-							:key, "Memory (RSS): ".rjust(20), :reset,
-							format_memory_usage[memory_usage]
+							:key, "Memory: ".rjust(20), :reset,
+							format_memory[memory, total_memory]
 						)
 					end
 					
 					terminal.print_line(
 						:key, "Memory (Total): ".rjust(20), :reset,
-						format_memory_usage[shared_memory_usage + private_memory_usage]
+						format_memory[shared_memory + private_memory, total_memory]
 					)
 				end
 			end

data/lib/process/metrics/command/top.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2020-2024, by Samuel Williams.
+# Copyright, 2020-2025, by Samuel Williams.
 
-require 'samovar'
+require "samovar"
 
-require_relative 'summary'
-require_relative '../version'
+require_relative "summary"
+require_relative "../version"
 
 module Process
 	module Metrics
@@ -15,13 +15,13 @@ module Process
 				self.description = "Collect memory usage statistics."
 				
 				options do
-					option '-h/--help', "Print out help information."
-					option '-v/--version', "Print out the application version."
+					option "-h/--help", "Print out help information."
+					option "-v/--version", "Print out the application version."
 				end
 				
 				nested :command, {
-					'summary' => Summary,
-				}, default: 'summary'
+					"summary" => Summary,
+				}, default: "summary"
 				
 				def call
 					if @options[:version]

data/lib/process/metrics/command.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2020-2024, by Samuel Williams.
+# Copyright, 2020-2025, by Samuel Williams.
 
-require_relative 'command/top'
+require_relative "command/top"
 
 module Process
 	module Metrics

data/lib/process/metrics/general.rb

@@ -1,21 +1,38 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2024, by Samuel Williams.
+# Copyright, 2019-2025, by Samuel Williams.
 
-require_relative 'memory'
-require 'set'
-require 'json'
+require_relative "memory"
+require "set"
+require "json"
 
 module Process
 	module Metrics
 		PS = "ps"
 		
+		DURATION = /\A
+			(?:(?<days>\d+)-)?              # Optional days (e.g., '2-')
+			(?:(?<hours>\d+):)?             # Optional hours (e.g., '1:')
+			(?<minutes>\d{1,2}):            # Minutes (always present, 1 or 2 digits)
+			(?<seconds>\d{2})               # Seconds (exactly 2 digits)
+			(?:\.(?<fraction>\d{1,2}))?     # Optional fraction of a second (e.g., '.27')
+		\z/x
+		
+		
 		# Parse a duration string into seconds.
 		# According to the linux manual page specifications.
 		def self.duration(value)
-			if /((?<days>\d\d)\-)?((?<hours>\d\d):)?(?<minutes>\d\d):(?<seconds>\d\d)?/ =~ value
-				(((days&.to_i || 0) * 24 + (hours&.to_i || 0)) * 60 + (minutes&.to_i || 0)) * 60 + seconds&.to_i
+			if match = DURATION.match(value)
+				days = match[:days].to_i
+				hours = match[:hours].to_i
+				minutes = match[:minutes].to_i
+				seconds = match[:seconds].to_i
+				fraction = match[:fraction].to_i
+				
+				return days * 24 * 60 * 60 + hours * 60 * 60 + minutes * 60 + seconds + fraction / 100.0
+			else
+				return 0.0
 			end
 		end
 		
@@ -25,10 +42,10 @@ module Process
 			ppid: ->(value){value.to_i}, # Parent Process ID
 			pgid: ->(value){value.to_i}, # Process Group ID
 			pcpu: ->(value){value.to_f}, # Percentage CPU
-			time: self.method(:duration), # CPU Time
-			vsz: ->(value){value.to_i}, #	Virtual Size
-			rss: ->(value){value.to_i}, # Resident Size
-			etime: self.method(:duration), # Elapsed Time
+			vsz: ->(value){value.to_i}, # Virtual Size (KiB)
+			rss: ->(value){value.to_i}, # Resident Size (KiB)
+			time: self.method(:duration), # CPU Time (seconds)
+			etime: self.method(:duration), # Elapsed Time (seconds)
 			command: ->(value){value}, # Command (name of the process)
 		}
 		
@@ -56,7 +73,7 @@ module Process
 				as_json.to_json(*arguments)
 			end
 			
-			# The general memory usage of the process using the best available information.
+			# The total size of the process in memory, in kilobytes.
 			def total_size
 				if memory = self.memory
 					memory.proportional_size
@@ -96,8 +113,10 @@ module Process
 			end
 			
 			def self.capture_memory(processes)
+				count = processes.size
+				
 				processes.each do |pid, process|
-					process.memory = Memory.capture(Array(pid))
+					process.memory = Memory.capture(pid, count: count)
 				end
 			end
 			
@@ -105,18 +124,18 @@ module Process
 			#
 			# @parameter pid [Integer] The process ID to capture.
 			# @parameter ppid [Integer] The parent process ID to capture.
-			def self.capture(pid: nil, ppid: nil, ps: PS)
+			def self.capture(pid: nil, ppid: nil, ps: PS, memory: Memory.supported?)
 				input, output = IO.pipe
 				
 				arguments = [ps]
 				
 				if pid && ppid.nil?
-					arguments.push("-p", Array(pid).join(','))
+					arguments.push("-p", Array(pid).join(","))
 				else
 					arguments.push("ax")
 				end
 				
-				arguments.push("-o", FIELDS.keys.join(','))
+				arguments.push("-o", FIELDS.keys.join(","))
 				
 				ps_pid = Process.spawn(*arguments, out: output, pgroup: true)
 				
@@ -130,7 +149,6 @@ module Process
 					record = FIELDS.
 						zip(line.split(/\s+/, FIELDS.size)).
 						map{|(key, type), value| type.call(value)}
-					
 					instance = self.new(*record)
 					
 					processes[instance.process_id] = instance
@@ -151,12 +169,8 @@ module Process
 					end
 				end
 				
-				if Memory.supported?
+				if memory
 					self.capture_memory(processes)
-					
-					# if pid
-					# 	self.compute_summary(pid, processes)
-					# end
 				end
 				
 				return processes

data/lib/process/metrics/memory/darwin.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2025, by Samuel Williams.
+
+module Process
+	module Metrics
+		class Memory::Darwin
+			VMMAP = "/usr/bin/vmmap"
+			
+			# Whether the memory usage can be captured on this system.
+			def self.supported?
+				File.executable?(VMMAP)
+			end
+			
+			# @returns [Numeric] Total memory size in kilobytes.
+			def self.total_size
+				# sysctl hw.memsize
+				IO.popen(["sysctl", "hw.memsize"], "r") do |io|
+					io.each_line do |line|
+						if line =~ /hw.memsize: (\d+)/
+							return $1.to_i / 1024
+						end
+					end
+				end
+			end
+			
+			# Parse a size string into kilobytes.
+			def self.parse_size(string)
+				return 0 unless string
+				
+				case string.strip
+				when /([\d\.]+)K/i then ($1.to_f).round
+				when /([\d\.]+)M/i then ($1.to_f * 1024).round
+				when /([\d\.]+)G/i then ($1.to_f * 1024 * 1024).round
+				else (string.to_f / 1024).ceil
+				end
+			end
+			
+			LINE = /\A
+				\s*
+				(?<region_name>.+?)\s+
+				(?<start_address>[0-9a-fA-F]+)-(?<end_address>[0-9a-fA-F]+)\s+
+				\[\s*(?<virtual_size>[\d\.]+[KMG]?)\s+(?<resident_size>[\d\.]+[KMG]?)\s+(?<dirty_size>[\d\.]+[KMG]?)\s+(?<swap_size>[\d\.]+[KMG]?)\s*\]\s+
+				(?<permissions>[rwx\-\/]+)\s+
+				SM=(?<sharing_mode>\w+)
+			/x
+			
+			# Capture memory usage for the given process IDs.
+			def self.capture(pid, count: 1, **options)
+				usage = Memory.zero
+				
+				IO.popen(["vmmap", pid.to_s], "r") do |io|
+					io.each_line do |line|
+						if match = LINE.match(line)
+							virtual_size = parse_size(match[:virtual_size])
+							resident_size = parse_size(match[:resident_size])
+							dirty_size = parse_size(match[:dirty_size])
+							swap_size = parse_size(match[:swap_size])
+							
+							# Update counts
+							usage.map_count += 1
+							usage.resident_size += resident_size
+							usage.swap_size += swap_size
+							
+							# Private vs. Shared memory
+							# COW=copy_on_write PRV=private NUL=empty ALI=aliased 
+							# SHM=shared ZER=zero_filled S/A=shared_alias
+							case match[:sharing_mode]
+							when "PRV"
+								usage.private_clean_size += resident_size - dirty_size
+								usage.private_dirty_size += dirty_size
+							when "COW", "SHM"
+								usage.shared_clean_size += resident_size - dirty_size
+								usage.shared_dirty_size += dirty_size
+							end
+							
+							# Anonymous memory: no region detail path or special names
+							if match[:region_name] =~ /MALLOC|VM_ALLOCATE|Stack|STACK|anonymous/
+								usage.anonymous_size += resident_size
+							end
+						end
+					end
+				end
+				
+				# Darwin does not expose proportional memory usage, so we guess based on the number of processes. Yes, this is a terrible hack, but it's the most reasonable thing to do given the constraints:
+				usage.proportional_size = usage.resident_size / count
+				usage.proportional_swap_size = usage.swap_size / count
+				
+				return usage
+			end
+		end
+		
+		if Memory::Darwin.supported?
+			class << Memory
+				def supported?
+					return true
+				end
+				
+				def total_size
+					return Memory::Darwin.total_size
+				end
+				
+				def capture(...)
+					return Memory::Darwin.capture(...)
+				end
+			end
+		end
+	end
+end

data/lib/process/metrics/memory/linux.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2025, by Samuel Williams.
+
+module Process
+	module Metrics
+		class Memory::Linux
+			# @returns [Numeric] Total memory size in kilobytes.
+			def self.total_size
+				File.read("/proc/meminfo").each_line do |line|
+					if /MemTotal:\s+(?<total>\d+) kB/ =~ line
+						return total.to_i
+					end
+				end
+			end
+			
+			# The fields that will be extracted from the `smaps` data.
+			SMAP = {
+				"Rss" => :resident_size,
+				"Pss" => :proportional_size,
+				"Shared_Clean" => :shared_clean_size,
+				"Shared_Dirty" => :shared_dirty_size,
+				"Private_Clean" => :private_clean_size,
+				"Private_Dirty" => :private_dirty_size,
+				"Referenced" => :referenced_size,
+				"Anonymous" => :anonymous_size,
+				"Swap" => :swap_size,
+				"SwapPss" => :proportional_swap_size,
+			}
+			
+			if File.readable?("/proc/self/smaps_rollup")
+				# Whether the memory usage can be captured on this system.
+				def self.supported?
+					true
+				end
+			
+				# Capture memory usage for the given process IDs.
+				def self.capture(pids)
+					usage = Memory.zero
+					
+					pids.each do |pid|
+						File.foreach("/proc/#{pid}/smaps_rollup") do |line|
+							if /(?<name>.*?):\s+(?<value>\d+) kB/ =~ line
+								if key = SMAP[name]
+									usage[key] += value.to_i
+								end
+							end
+						end
+						
+						usage.map_count += File.readlines("/proc/#{pid}/maps").size
+					rescue Errno::ENOENT => error
+						# Ignore.
+					end
+					
+					return usage
+				end
+			elsif File.readable?("/proc/self/smaps")
+				# Whether the memory usage can be captured on this system.
+				def self.supported?
+					true
+				end
+				
+				# Capture memory usage for the given process IDs.
+				def self.capture(pid, **options)
+					usage = Memory.zero
+					
+					begin
+						File.foreach("/proc/#{pid}/smaps") do |line|
+							# The format of this is fixed according to:
+							# https://github.com/torvalds/linux/blob/351c8a09b00b5c51c8f58b016fffe51f87e2d820/fs/proc/task_mmu.c#L804-L814
+							if /(?<name>.*?):\s+(?<value>\d+) kB/ =~ line
+								if key = SMAP[name]
+									usage[key] += value.to_i
+								end
+							elsif /VmFlags:\s+(?<flags>.*)/ =~ line
+								# It should be possible to extract the number of fibers and each fiber's memory usage.
+								# flags = flags.split(/\s+/)
+								usage.map_count += 1
+							end
+						end
+					rescue Errno::ENOENT => error
+						# Ignore.
+					end
+					
+					return usage
+				end
+			else
+				def self.supported?
+					false
+				end
+			end
+		end
+		
+		if Memory::Linux.supported?
+			class << Memory
+				def supported?
+					return true
+				end
+				
+				def total_size
+					return Memory::Linux.total_size
+				end
+				
+				def capture(...)
+					return Memory::Linux.capture(...)
+				end
+			end
+		end
+	end
+end

data/lib/process/metrics/memory.rb

@@ -1,12 +1,13 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2024, by Samuel Williams.
+# Copyright, 2019-2025, by Samuel Williams.
 
-require 'json'
+require "json"
 
 module Process
 	module Metrics
+		# Represents memory usage for a process, sizes are in kilobytes.
 		class Memory < Struct.new(:map_count, :resident_size, :proportional_size, :shared_clean_size, :shared_dirty_size, :private_clean_size, :private_dirty_size, :referenced_size, :anonymous_size, :swap_size, :proportional_swap_size)
 			
 			alias as_json to_h
@@ -26,87 +27,22 @@ module Process
 				self.private_clean_size + self.private_dirty_size
 			end
 			
-			# The fields that will be extracted from the `smaps` data.
-			MAP = {
-				"Rss" => :resident_size,
-				"Pss" => :proportional_size,
-				"Shared_Clean" => :shared_clean_size,
-				"Shared_Dirty" => :shared_dirty_size,
-				"Private_Clean" => :private_clean_size,
-				"Private_Dirty" => :private_dirty_size,
-				"Referenced" => :referenced_size,
-				"Anonymous" => :anonymous_size,
-				"Swap" => :swap_size,
-				"SwapPss" => :proportional_swap_size,
-			}
+			def self.zero
+				self.new(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0)
+			end
+			
+			# Whether the memory usage can be captured on this system.
+			def self.supported?
+				false
+			end
 			
-			if File.readable?('/proc/self/smaps_rollup')
-				# Whether the memory usage can be captured on this system.
-				def self.supported?
-					true
-				end
-				
-				# Capture memory usage for the given process IDs.
-				def self.capture(pids)
-					usage = self.new(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0)
-					
-					pids.each do |pid|
-						File.foreach("/proc/#{pid}/smaps_rollup") do |line|
-							if /(?<name>.*?):\s+(?<value>\d+) kB/ =~ line
-								if key = MAP[name]
-									usage[key] += value.to_i
-								end
-							end
-						end
-						
-						usage.map_count += File.readlines("/proc/#{pid}/maps").size
-					rescue Errno::ENOENT => error
-						# Ignore.
-					end
-					
-					return usage
-				end
-			elsif File.readable?('/proc/self/smaps')
-				# Whether the memory usage can be captured on this system.
-				def self.supported?
-					true
-				end
-				
-				# Capture memory usage for the given process IDs.
-				def self.capture(pids)
-					usage = self.new(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0)
-					
-					pids.each do |pid|
-						File.foreach("/proc/#{pid}/smaps") do |line|
-							# The format of this is fixed according to:
-							# https://github.com/torvalds/linux/blob/351c8a09b00b5c51c8f58b016fffe51f87e2d820/fs/proc/task_mmu.c#L804-L814
-							if /(?<name>.*?):\s+(?<value>\d+) kB/ =~ line
-								if key = MAP[name]
-									usage[key] += value.to_i
-								end
-							elsif /VmFlags:\s+(?<flags>.*)/ =~ line
-								# It should be possible to extract the number of fibers and each fiber's memory usage.
-								# flags = flags.split(/\s+/)
-								usage.map_count += 1
-							end
-						end
-					rescue Errno::ENOENT => error
-						# Ignore.
-					end
-					
-					return usage
-				end
-			else
-				# Whether the memory usage can be captured on this system.
-				def self.supported?
-					false
-				end
-				
-				# Capture memory usage for the given process IDs.
-				def self.capture(pids)
-					return self.new
-				end
+			# Capture memory usage for the given process IDs.
+			def self.capture(pid, **options)
+				return nil
 			end
 		end
 	end
 end
+
+require_relative "memory/linux"
+require_relative "memory/darwin"

data/lib/process/metrics/version.rb

@@ -5,6 +5,6 @@
 
 module Process
 	module Metrics
-		VERSION = "0.3.0"
+		VERSION = "0.5.0"
 	end
 end

data/license.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright, 2019-2024, by Samuel Williams.  
+Copyright, 2019-2025, by Samuel Williams.  
 Copyright, 2024, by Adam Daniels.  
 
 Permission is hereby granted, free of charge, to any person obtaining a copy

data/readme.md

@@ -24,8 +24,8 @@ We welcome contributions to this project.
 
 ### Developer Certificate of Origin
 
-This project uses the [Developer Certificate of Origin](https://developercertificate.org/). All contributors to this project must agree to this document to have their contributions accepted.
+In order to protect users of this project, we require all contributors to comply with the [Developer Certificate of Origin](https://developercertificate.org/). This ensures that all contributions are properly licensed and attributed.
 
-### Contributor Covenant
+### Community Guidelines
 
-This project is governed by the [Contributor Covenant](https://www.contributor-covenant.org/). All contributors and participants agree to abide by its terms.
+This project is best served by a collaborative and respectful environment. Treat each other professionally, respect differing viewpoints, and engage constructively. Harassment, discrimination, or harmful behavior is not tolerated. Communicate clearly, listen actively, and support one another. If any issues arise, please inform the project maintainers.

metadata

@@ -1,12 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: process-metrics
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Samuel Williams
 - Adam Daniels
-autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -38,7 +37,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-04-06 00:00:00.000000000 Z
+date: 2025-02-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: console
@@ -55,35 +54,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.8'
 - !ruby/object:Gem::Dependency
-  name: samovar
+  name: json
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '2'
 - !ruby/object:Gem::Dependency
-  name: json
+  name: samovar
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2'
+        version: '2.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2'
-description:
-email:
+        version: '2.1'
 executables:
 - process-metrics
 extensions: []
@@ -96,6 +93,8 @@ files:
 - lib/process/metrics/command/top.rb
 - lib/process/metrics/general.rb
 - lib/process/metrics/memory.rb
+- lib/process/metrics/memory/darwin.rb
+- lib/process/metrics/memory/linux.rb
 - lib/process/metrics/version.rb
 - license.md
 - readme.md
@@ -106,7 +105,6 @@ metadata:
   documentation_uri: https://socketry.github.io/process-metrics/
   funding_uri: https://github.com/sponsors/ioquatix
   source_code_uri: https://github.com/socketry/process-metrics.git
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -114,15 +112,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Provide detailed OS-specific process metrics.
 test_files: []