process-metrics 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06e77d37339d28a6405332440e7049065b61defd68fb69c9b1e794f79aba8ac7
-  data.tar.gz: 6ac90b5a274be90958fb497fe2859807b21700dbd5a7a336278b5c7b2858e2d0
+  metadata.gz: 4692590f9565bbf61e0854c736a4225749d1e12021b0fa769fdc6cab6cee7002
+  data.tar.gz: 138b82d832444faa4eafe5137ae4f25ffd4652b5d2b313fd698b1a11c871cb09
 SHA512:
-  metadata.gz: 04a5adc405715e2406a8601a58a65885f9026d0c5009822e23eb4c739e727265787eb5ed32218c1316f75a50eba4ac6e3dc6518176d539028bf00a18f9ccbbb9
-  data.tar.gz: dd436625c1ee3a6b3a8cb6424fb05ad35e5243adc961477632acd3ab9e006cd54435c7b662cc2698b06b6e5f4a61c4082c6957d67cb84306ae62d9f075f743c2
+  metadata.gz: be2a880bd7a6285d5472425860ab1cdf1f031e0aca0e0565e849825e51449a9f1278646a34796f6b43f6e9c19cc7b120850e1470e1cc8bc86d9114e27709b779
+  data.tar.gz: 6c149bd8d92118add7f24d2a28d6c9b1ac22e97bd048fb5e30f3ed9e93f4b88bccf3be428255469e566d538ee81ebea72aaa82e7b7db0dce7841e89d8fcba5e0

data/bake/process/metrics.rb

@@ -0,0 +1,218 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2025-2026, by Samuel Williams.
+
+def capture(pid: nil, ppid: nil)
+	require "process/metrics/general"
+	
+	Process::Metrics::General.capture(pid: pid, ppid: ppid)
+end
+
+# Print metrics for a process or processes.
+#
+# @parameter pid [Integer] The process ID to capture.
+# @parameter ppid [Integer] The parent process ID to capture.
+def metrics(pid: nil, ppid: nil)
+	require "process/metrics/general"
+	require "process/metrics/host"
+	
+	terminal = self.terminal
+	format_memory = self.method(:format_memory).curry
+	
+	# Host name (uname -a) as first line
+	if host_name = Process::Metrics::Host.name
+		terminal.print_line(host_name, :reset)
+	end
+	
+	host = Process::Metrics::Host::Memory.capture
+	terminal.print_line(
+		:key, "Total Memory: ".rjust(20), :reset,
+		format_size(host.total_size).rjust(9)
+	)
+	
+	terminal.print_line(
+		:key, "Used Memory: ".rjust(20), :reset,
+		format_memory[host.used_size, host.total_size]
+	)
+	
+	summary = Process::Metrics::General.capture(pid: pid, ppid: ppid)
+	
+	shared_memory = 0
+	private_memory = 0
+	total_memory = host.total_size
+	
+	proportional = true
+	
+	summary.each do |pid, general|
+		terminal.print_line(:pid, pid, :reset, " ", :command, general[:command])
+		
+		terminal.print(:key, "Processor Usage: ".rjust(20), :reset)
+		format_processor_utilization(general.processor_utilization, terminal)
+		terminal.print_line
+		
+		if memory = general.memory
+			shared_memory += memory.proportional_size
+			private_memory += memory.unique_size
+			
+			terminal.print_line(
+				:key, "Memory: ".rjust(20), :reset,
+				format_memory[memory.proportional_size, total_memory]
+			)
+			
+			terminal.print_line(
+				:key, "Private Memory: ".rjust(20), :reset,
+				format_memory[memory.unique_size, total_memory]
+			)
+		else
+			shared_memory += general.resident_size
+			proportional = false
+			
+			terminal.print_line(
+				:key, "Memory: ".rjust(20), :reset,
+				format_memory[general.resident_size, total_memory]
+			)
+		end
+	end
+	
+	terminal.print_line("Summary")
+	
+	if proportional
+		terminal.print_line(
+			:key, "Memory: ".rjust(20), :reset,
+			format_memory[shared_memory, total_memory]
+		)
+		
+		terminal.print_line(
+			:key, "Private Memory: ".rjust(20), :reset,
+			format_memory[private_memory, total_memory]
+		)
+	else
+		terminal.print_line(
+			:key, "Memory: ".rjust(20), :reset,
+			format_memory[shared_memory, total_memory]
+		)
+	end
+	
+	terminal.print_line(
+		:key, "Memory (Total): ".rjust(20), :reset,
+		format_memory[shared_memory + private_memory, total_memory]
+	)
+end
+
+protected
+
+# Helper module for rendering horizontal progress bars using Unicode block characters.
+module Bar
+	BLOCK = [
+		" ",
+		"▏",
+		"▎",
+		"▍",
+		"▌",
+		"▋",
+		"▊",
+		"▉",
+		"█",
+	]
+	
+	# Format a fractional value as a horizontal bar.
+	# @parameter value [Float] A value between 0.0 and 1.0 representing the fill level.
+	# @parameter width [Integer] The width of the bar in characters.
+	# @returns [String] A string of Unicode block characters representing the filled bar.
+	def self.format(value, width)
+		blocks = width * value
+		full_blocks = blocks.floor
+		partial_block = ((blocks - full_blocks) * BLOCK.size).floor
+		
+		if partial_block.zero?
+			BLOCK.last * full_blocks
+		else
+			"#{BLOCK.last * full_blocks}#{BLOCK[partial_block]}"
+		end.ljust(width)
+	end
+end
+
+# Get the configured terminal for styled output.
+# @returns [Console::Terminal] A terminal object with color/style definitions.
+def terminal
+	terminal = Console::Terminal.for($stdout)
+	
+	# terminal[:pid] = terminal.style(:blue)
+	terminal[:command] = terminal.style(nil, nil, :bold)
+	terminal[:key] = terminal.style(:cyan)
+	
+	terminal[:low] = terminal.style(:green)
+	terminal[:medium] = terminal.style(:yellow)
+	terminal[:high] = terminal.style(:red)
+	
+	return terminal
+end
+
+# Width in characters for progress bars (label + value + " []" ≈ 33 chars).
+DEFAULT_BAR_WIDTH = 60
+
+def bar_width(terminal, prefix_width: 33)
+	if width = terminal.width
+		return width - prefix_width if width > prefix_width
+	end
+	
+	return DEFAULT_BAR_WIDTH
+end
+
+# Format a processor utilization percentage with color-coded bar.
+# @parameter value [Float] The CPU utilization percentage (0.0-100.0).
+# @parameter terminal [Console::Terminal] The terminal to output styled text.
+def format_processor_utilization(value, terminal)
+	if value > 80.0
+		intensity = :high
+	elsif value > 50.0
+		intensity = :medium
+	else
+		intensity = :low
+	end
+	
+	formatted = "%5.1f%% " % value
+	
+	terminal.print(formatted.rjust(10), intensity, "[", Bar.format(value / 100.0, bar_width(terminal)), "]", :reset)
+end
+
+UNITS = ["KiB", "MiB", "GiB"]
+
+# Format a memory size value in human-readable units.
+# @parameter value [Numeric] The size value in bytes.
+# @parameter units [Array(String)] The unit labels to use for scaling.
+# @returns [String] A formatted string with value and unit (e.g., "512KiB", "1.5MiB").
+def format_size(value, units: UNITS)
+	unit = -1
+	
+	while value >= 1024.0 && unit < units.size - 1
+		value /= 1024.0
+		unit += 1
+	end
+	
+	if unit < 0
+		# Value is less than 1 KiB, show in bytes
+		return "#{value.round(0)}B"
+	else
+		return "#{value.round(unit)}#{units[unit]}"
+	end
+end
+
+# Format a memory value with a horizontal bar showing utilization relative to total.
+# @parameter value [Numeric] The memory value in bytes.
+# @parameter total [Numeric] The total memory available in bytes.
+# @parameter terminal [Console::Terminal] The terminal to output styled text.
+def format_memory(value, total, terminal)
+	if value > (total * 0.8)
+		intensity = :high
+	elsif value > (total * 0.5)
+		intensity = :medium
+	else
+		intensity = :low
+	end
+	
+	formatted = (format_size(value) + " ").rjust(10)
+	
+	terminal.print(formatted, intensity, "[", Bar.format(value / total.to_f, bar_width(terminal)), "]", :reset)
+end

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

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2026, by Samuel Williams.
+# Copyright, 2026, by Samuel Williams.
 
 require "etc"
 
@@ -18,9 +18,16 @@ module Process
 			# Page size in bytes for RSS (resident set size is in pages in /proc/pid/stat).
 			PAGE_SIZE = Etc.sysconf(Etc::SC_PAGESIZE) rescue 4096
 			
+			# The Unix timestamp when the system booted.
+			BOOT_TIME = if File.readable?("/proc/stat")
+				File.foreach("/proc/stat") do |line|
+					break line.split.last.to_f if line.start_with?("btime ")
+				end
+			end
+			
 			# Whether /proc is available so we can list processes without ps.
 			def self.supported?
-				File.directory?("/proc") && File.readable?("/proc/self/stat")
+				File.directory?("/proc") && File.readable?("/proc/self/stat") && File.readable?("/proc/uptime") && !BOOT_TIME.nil?
 			end
 			
 			# Capture process information from /proc. If given `pid`, captures only those process(es). If given `ppid`, captures that parent and all descendants. Both can be given to capture a process and its children.
@@ -38,7 +45,6 @@ module Process
 				end
 				
 				uptime_jiffies = nil
-				
 				processes = {}
 				pids_to_read.each do |pid|
 					stat_path = "/proc/#{pid}/stat"
@@ -56,7 +62,7 @@ module Process
 					process_group_id = fields[2].to_i
 					utime = fields[11].to_i
 					stime = fields[12].to_i
-					starttime = fields[19].to_i
+					start_time = fields[19].to_i
 					virtual_size = fields[20].to_i
 					resident_pages = fields[21].to_i
 					
@@ -65,9 +71,8 @@ module Process
 						uptime_seconds = File.read("/proc/uptime").split(/\s+/).first.to_f
 						(uptime_seconds * CLK_TCK).to_i
 					end
-					
 					processor_time = (utime + stime).to_f / CLK_TCK
-					elapsed_time = [(uptime_jiffies - starttime).to_f / CLK_TCK, 0.0].max
+					elapsed_time = [(uptime_jiffies - start_time).to_f / CLK_TCK, 0.0].max
 					
 					command = read_command(pid, executable_name)
 					
@@ -80,6 +85,7 @@ module Process
 						resident_pages * PAGE_SIZE,
 						processor_time,
 						elapsed_time,
+						BOOT_TIME + start_time.to_f / CLK_TCK,
 						command,
 						nil
 					)

data/lib/process/metrics/general/process_status.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2026, by Samuel Williams.
+# Copyright, 2026, by Samuel Williams.
+
+require "time"
 
 module Process
 	module Metrics
@@ -12,15 +14,16 @@ module Process
 			
 			# The fields that will be extracted from the `ps` command (order matches -o output).
 			FIELDS = {
-				pid: ->(value){value.to_i},
-				ppid: ->(value){value.to_i},
-				pgid: ->(value){value.to_i},
-				pcpu: ->(value){value.to_f},
-				vsz: ->(value){value.to_i * 1024},
-				rss: ->(value){value.to_i * 1024},
-				time: Process::Metrics.method(:duration),
-				etime: Process::Metrics.method(:duration),
-				command: ->(value){value},
+				pid: ->(values){values.shift.to_i},
+				ppid: ->(values){values.shift.to_i},
+				pgid: ->(values){values.shift.to_i},
+				pcpu: ->(values){values.shift.to_f},
+				vsz: ->(values){values.shift.to_i * 1024},
+				rss: ->(values){values.shift.to_i * 1024},
+				time: ->(values){Process::Metrics.duration(values.shift)},
+				etime: ->(values){Process::Metrics.duration(values.shift)},
+				lstart: ->(values){Time.strptime(values.shift(5).join(" "), "%a %b %e %H:%M:%S %Y").to_f},
+				command: ->(values){values.join(" ")},
 			}
 			
 			# Whether process listing via ps is available on this system.
@@ -48,7 +51,7 @@ module Process
 					
 					arguments.push("-o", FIELDS.keys.join(","))
 					
-					spawned_pid = Process.spawn(*arguments, out: output)
+					spawned_pid = Process.spawn({"LC_ALL" => "C"}, *arguments, out: output)
 					output.close
 					
 					input.readlines.map(&:strip)
@@ -71,10 +74,9 @@ module Process
 				lines.each do |line|
 					next if line.empty?
 					
-					values = line.split(/\s+/, FIELDS.size)
-					next if values.size < FIELDS.size
+					values = line.split(/\s+/)
+					record = FIELDS.values.map{|parser| parser.call(values)}
 					
-					record = FIELDS.keys.map.with_index{|key, i| FIELDS[key].call(values[i])}
 					instance = General.new(*record, nil)
 					processes[instance.process_id] = instance
 				end

data/lib/process/metrics/general.rb

@@ -35,7 +35,7 @@ module Process
 		end
 		
 		# General process information.
-		class General < Struct.new(:process_id, :parent_process_id, :process_group_id, :processor_utilization, :virtual_size, :resident_size, :processor_time, :elapsed_time, :command, :memory)
+		class General < Struct.new(:process_id, :parent_process_id, :process_group_id, :processor_utilization, :virtual_size, :resident_size, :processor_time, :elapsed_time, :start_time, :command, :memory)
 			# Convert the object to a JSON serializable hash.
 			def as_json
 				{
@@ -48,6 +48,7 @@ module Process
 					resident_size: self.resident_size,
 					processor_time: self.processor_time,
 					elapsed_time: self.elapsed_time,
+					start_time: self.start_time,
 					command: self.command,
 					memory: self.memory&.as_json,
 				}

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

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025-2026, by Samuel Williams.
+# Copyright, 2026, by Samuel Williams.
 
 module Process
 	module Metrics

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

@@ -1,15 +1,19 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025-2026, by Samuel Williams.
+# Copyright, 2026, by Samuel Williams.
 
 module Process
 	module Metrics
 		module Host
+			# Captures host memory limits and usage from a cgroup v1 filesystem.
 			class Memory::Linux::CgroupV1
 				CGROUP_V1_UNLIMITED_THRESHOLD = 2**60
 				DEFAULT_CGROUP_ROOT = "/sys/fs/cgroup"
 				
+				# Whether cgroup v1 memory metrics are available.
+				# @parameter cgroup_root [String | Nil] The root of the cgroup filesystem.
+				# @returns [Boolean] Whether the required cgroup v1 files exist.
 				def self.supported?(cgroup_root = DEFAULT_CGROUP_ROOT)
 					root = (cgroup_root || DEFAULT_CGROUP_ROOT).to_s.chomp("/")
 					
@@ -20,10 +24,14 @@ module Process
 					return false
 				end
 				
+				# Initialize the cgroup v1 memory reader.
+				# @parameter cgroup_root [String | Nil] The root of the cgroup filesystem.
 				def initialize(cgroup_root: nil)
 					@cgroup_root = (cgroup_root || DEFAULT_CGROUP_ROOT).to_s.chomp("/")
 				end
 				
+				# Capture host memory from the cgroup v1 filesystem.
+				# @returns [Host::Memory | Nil] The captured host memory, if the cgroup has a finite limit.
 				def capture
 					total = read_total
 					return nil unless total && total.positive?

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

@@ -1,14 +1,18 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025-2026, by Samuel Williams.
+# Copyright, 2026, by Samuel Williams.
 
 module Process
 	module Metrics
 		module Host
+			# Captures host memory limits and usage from a cgroup v2 filesystem.
 			class Memory::Linux::CgroupV2
 				DEFAULT_CGROUP_ROOT = "/sys/fs/cgroup"
 				
+				# Whether cgroup v2 memory metrics are available.
+				# @parameter cgroup_root [String | Nil] The root of the cgroup filesystem.
+				# @returns [Boolean] Whether the required cgroup v2 files exist.
 				def self.supported?(cgroup_root = DEFAULT_CGROUP_ROOT)
 					root = (cgroup_root || DEFAULT_CGROUP_ROOT).to_s.chomp("/")
 					
@@ -19,10 +23,14 @@ module Process
 					return false
 				end
 				
+				# Initialize the cgroup v2 memory reader.
+				# @parameter cgroup_root [String | Nil] The root of the cgroup filesystem.
 				def initialize(cgroup_root: nil)
 					@cgroup_root = (cgroup_root || DEFAULT_CGROUP_ROOT).to_s.chomp("/")
 				end
 				
+				# Capture host memory from the cgroup v2 filesystem.
+				# @returns [Host::Memory | Nil] The captured host memory, if the cgroup has a finite limit.
 				def capture
 					total = read_total
 					return nil unless total && total.positive?

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

@@ -1,16 +1,21 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025-2026, by Samuel Williams.
+# Copyright, 2026, by Samuel Williams.
 
 module Process
 	module Metrics
 		module Host
+			# Captures host memory from Linux `/proc/meminfo`.
 			class Memory::Linux::Meminfo
+				# Whether `/proc/meminfo` is available.
+				# @returns [Boolean] Whether the procfs memory information exists.
 				def self.supported?
 					File.exist?("/proc/meminfo")
 				end
 				
+				# Capture host memory from `/proc/meminfo`.
+				# @returns [Host::Memory | Nil] The captured host memory, if available.
 				def capture
 					content = File.read("/proc/meminfo") rescue nil
 					return nil unless content

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

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025-2026, by Samuel Williams.
+# Copyright, 2026, by Samuel Williams.
 
 module Process
 	module Metrics
@@ -10,6 +10,9 @@ module Process
 			module Memory::Linux
 				DEFAULT_CGROUP_ROOT = "/sys/fs/cgroup"
 				
+				# Capture host memory from the available Linux interface.
+				# @parameter cgroup_root [String] The root of the cgroup filesystem.
+				# @returns [Host::Memory | Nil] The captured host memory, if available.
 				def self.capture(cgroup_root: DEFAULT_CGROUP_ROOT)
 					if Memory::Linux::CgroupV2.supported?(cgroup_root)
 						if capture = Memory::Linux::CgroupV2.new(cgroup_root: cgroup_root).capture

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

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025-2026, by Samuel Williams.
+# Copyright, 2026, by Samuel Williams.
 
 module Process
 	module Metrics
@@ -15,12 +15,17 @@ module Process
 			# @attribute swap_used_size [Integer, nil] Swap in use, or nil if not available.
 			# @attribute reclaimable_size [Integer, nil] Reclaimable memory (e.g. page cache, slab), or nil. Included in used_size.
 			Memory = Struct.new(:total_size, :used_size, :swap_total_size, :swap_used_size, :reclaimable_size) do
+				# Convert the memory snapshot to a hash, including derived sizes.
+				# @returns [Hash(Symbol, Integer | Nil)] The memory snapshot fields.
 				def to_h
 					super.merge(free_size: free_size, available_size: available_size)
 				end
 				
 				alias as_json to_h
 				
+				# Convert the memory snapshot to JSON.
+				# @parameter arguments [Array] Additional arguments passed to the JSON encoder.
+				# @returns [String] The encoded memory snapshot.
 				def to_json(*arguments)
 					as_json.to_json(*arguments)
 				end

data/lib/process/metrics/host.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025-2026, by Samuel Williams.
+# Copyright, 2020-2026, by Samuel Williams.
 
 require_relative "host/memory"
 

data/lib/process/metrics/processor.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+module Process
+	module Metrics
+		# Computes interval CPU utilization from cumulative process metrics.
+		class Processor
+			# An immutable measurement of process CPU usage over an interval.
+			# @attribute [Integer] The process ID.
+			# @attribute [Float] The elapsed monotonic time in seconds.
+			# @attribute [Float] The CPU time consumed during the interval in seconds.
+			# @attribute [Float] The CPU utilization, where one fully occupied core is `1.0`.
+			class Sample < Struct.new(:process_id, :duration, :processor_time, :utilization)
+			end
+			
+			# @private
+			Snapshot = Struct.new(:start_time, :processor_time, :timestamp)
+			
+			# Initialize a process metrics sampler.
+			# @parameter capture [Interface(:call)] The process snapshot capture callable.
+			def initialize(capture: General.method(:capture))
+				@capture = capture
+				@snapshots = {}
+			end
+			
+			# Sample CPU utilization for the given processes.
+			# The first observation of each process establishes a baseline and does not produce a sample.
+			# @parameter process_ids [Integer | Array(Integer)] The process IDs to sample.
+			# @returns [Hash(Integer, Processor::Sample)] The valid interval samples keyed by process ID.
+			def sample(process_ids)
+				processes = @capture.call(pid: process_ids, memory: false)
+				timestamp = now
+				return {} unless finite?(timestamp)
+				
+				samples = {}
+				snapshots = {}
+				
+				processes.each do |process_id, process|
+					start_time = process.start_time
+					processor_time = process.processor_time
+					next unless finite?(start_time) && finite?(processor_time)
+					
+					current = Snapshot.new(start_time, processor_time, timestamp)
+					snapshots[process_id] = current
+					
+					if previous = @snapshots[process_id]
+						next unless previous.start_time == current.start_time
+						
+						duration = current.timestamp - previous.timestamp
+						processor_time = current.processor_time - previous.processor_time
+						next unless finite?(duration) && duration > 0.0
+						next unless finite?(processor_time) && processor_time >= 0.0
+						
+						utilization = processor_time / duration
+						next unless finite?(utilization)
+						
+						samples[process_id] = Sample.new(process_id, duration, processor_time, utilization).freeze
+					end
+				end
+				
+				@snapshots = snapshots
+				
+				return samples
+			end
+			
+			private
+			
+			# Get the current monotonic time.
+			def now
+				Process.clock_gettime(Process::CLOCK_MONOTONIC)
+			end
+			
+			# Whether the value is a finite number.
+			def finite?(value)
+				value.is_a?(Numeric) && value.finite?
+			end
+		end
+	end
+end

data/lib/process/metrics/version.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2025, by Samuel Williams.
+# Copyright, 2019-2026, by Samuel Williams.
 
 # @namespace
 module Process
 	# @namespace
 	module Metrics
-		VERSION = "0.11.0"
+		VERSION = "0.12.0"
 	end
 end

data/lib/process/metrics.rb

@@ -1,7 +1,8 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2024, by Samuel Williams.
+# Copyright, 2019-2026, by Samuel Williams.
 
 require_relative "metrics/version"
 require_relative "metrics/general"
+require_relative "metrics/processor"

data/readme.md

@@ -16,6 +16,10 @@ Please see the [project documentation](https://socketry.github.io/process-metric
 
 Please see the [project releases](https://socketry.github.io/process-metrics/releases/index) for all releases.
 
+### v0.12.0
+
+  - Add `Process::Metrics::Processor` for measuring per-process CPU utilization over an interval.
+
 ### v0.11.0
 
   - `process-metrics` command is removed, replaced with `bake process:metrics`.
@@ -56,10 +60,6 @@ Please see the [project releases](https://socketry.github.io/process-metrics/rel
 
   - Add support for major and minor page faults on Linux: `Process::Metrics::Memory#major_faults` and `#minor_faults`. Unfortunately these metrics are not available on Darwin (macOS).
 
-### v0.5.1
-
-  - Fixed Linux memory usage capture to correctly read memory statistics.
-
 ## Contributing
 
 We welcome contributions to this project.
@@ -70,6 +70,22 @@ We welcome contributions to this project.
 4.  Push to the branch (`git push origin my-new-feature`).
 5.  Create new Pull Request.
 
+### Running Tests
+
+To run the test suite:
+
+``` shell
+bundle exec sus
+```
+
+### Making Releases
+
+To make a new release:
+
+``` shell
+bundle exec bake gem:release:patch # or minor or major
+```
+
 ### Developer Certificate of Origin
 
 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.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.12.0
+
+  - Add `Process::Metrics::Processor` for measuring per-process CPU utilization over an interval.
+
 ## v0.11.0
 
   - `process-metrics` command is removed, replaced with `bake process:metrics`.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: process-metrics
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -71,6 +71,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- bake/process/metrics.rb
 - context/getting-started.md
 - context/index.yaml
 - lib/process/metrics.rb
@@ -87,6 +88,7 @@ files:
 - lib/process/metrics/memory.rb
 - lib/process/metrics/memory/darwin.rb
 - lib/process/metrics/memory/linux.rb
+- lib/process/metrics/processor.rb
 - lib/process/metrics/version.rb
 - license.md
 - readme.md
@@ -105,14 +107,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.2'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Provide detailed OS-specific process metrics.
 test_files: []