async-utilization 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5ddd4fc21308eeba6b47fbd44df20d4694ee4bd5b78488a44395d0ab5e2da500
-  data.tar.gz: 8699da59ebaa0497ca112cf4f1ca65805935d11061b9ed6e1475a56f05a58795
+  metadata.gz: bae4a631b828e8a236bcee48919460731116a2a521031f16ae8f11ed03234407
+  data.tar.gz: 3ca70a5a98f4ba4515d3f30271561e0764912cf1f7983d602307bf6ba869b296
 SHA512:
-  metadata.gz: '079cbc3d3a93cda55ebcce48f93c23e5460db7ae8019336b442d0a24ffd783ec6e614cd2d36fc7c937f388cf729ce7d4d6944c5aefae754c4165560a4f353a98'
-  data.tar.gz: '049b0ea1ae9d8bc15c12aa69c3d595e32424d1d200003425067f70111f804079fda1f23ef21cc3ed0a0a0d698b36e3b00cbe0cb9ce3803dde197c8e03c8599b1'
+  metadata.gz: 0ae6db6c1108dcc43ef14a38b6fb88de1c882deeeac95df60c843bac006a4de88c6d6344128f0cd9e53344572391ab6833b4a2f36ebbea741fceb1b22e26ecef
+  data.tar.gz: 664e8d90bee5423e467aa01a502d043838d2a139fbd53bda712c27422839abe501e1a250cb760492f95b79f0e9245dde2cf09d33fcfba85a11435bc97be23f16

data/lib/async/utilization/registry.rb

@@ -3,8 +3,6 @@
 # Released under the MIT License.
 # Copyright, 2026, by Samuel Williams.
 
-require "thread/local"
-
 module Async
 	module Utilization
 		# Registry for emitting utilization metrics.
@@ -12,8 +10,9 @@ module Async
 		# The registry tracks values directly and notifies a registered observer
 		# when values change. The observer (like Observer) can write to its backend.
 		#
-		# Each thread gets its own instance of the registry, providing
-		# thread-local behavior through the thread-local gem.
+		# Registries should be explicitly created and passed to components that need them.
+		# In service contexts, registries are typically created via the evaluator and
+		# shared across components within the same service instance.
 		#
 		# When an observer is added, it is immediately notified of all current values
 		# so it can sync its state. When values change, the observer is notified.
@@ -36,7 +35,6 @@ module Async
 		# 	observer = Async::Utilization::Observer.open(schema, "/path/to/shm", 4096, 0)
 		# 	registry.observer = observer
 		class Registry
-			extend Thread::Local
 			
 			# Initialize a new registry.
 			def initialize

data/lib/async/utilization/version.rb

@@ -7,6 +7,6 @@
 module Async
 	# @namespace
 	module Utilization
-		VERSION = "0.1.0"
+		VERSION = "0.2.0"
 	end
 end

data/lib/async/utilization.rb

@@ -15,42 +15,9 @@ module Async
 	#
 	# This module provides a convenient interface for tracking utilization metrics
 	# that can be synchronized to shared memory for inter-process communication.
-	# Each thread gets its own instance of the underlying {Registry}, providing
-	# thread-local behavior.
+	# Registries should be explicitly created and passed to components that need them.
 	#
 	# See the {file:guides/getting-started/readme.md Getting Started} guide for usage examples.
 	module Utilization
-		# Set the observer for utilization metrics.
-		#
-		# When an observer is set, it is notified of all current metric values
-		# so it can sync its state. The observer must implement `set(field, value)`.
-		#
-		# Delegates to the thread-local {Registry} instance.
-		#
-		# @parameter observer [#set] The observer to set.
-		def self.observer=(observer)
-			Registry.instance.observer = observer
-		end
-		
-		# Get a cached metric reference for a field.
-		#
-		# Returns a {Metric} instance that caches all details needed for fast writes
-		# to shared memory, avoiding hash lookups on the fast path.
-		#
-		# This is the recommended way to access metrics for optimal performance.
-		#
-		# Delegates to the thread-local {Registry} instance.
-		#
-		# @parameter field [Symbol] The field name to get a metric for.
-		# @returns [Metric] A metric instance for the given field.
-		# @example Get a metric and increment it:
-		# 	current_requests = Async::Utilization.metric(:current_requests)
-		# 	current_requests.increment
-		# 	current_requests.increment do
-		# 		# Handle request - auto-decrements when block completes
-		# 	end
-		def self.metric(field)
-			Registry.instance.metric(field)
-		end
 	end
 end

data/test/async/utilization/metric.rb

@@ -29,28 +29,24 @@ describe Async::Utilization::Metric do
 		Async::Utilization::Observer.open(schema, shm_path, segment_size, offset)
 	end
 	
+	let(:registry) {Async::Utilization::Registry.new}
+	
 	before do
 		File.open(shm_path, "w+b") do |file|
 			file.truncate(file_size)
 		end
-		
-		# Reset the registry to ensure clean state between tests
-		registry = Async::Utilization::Registry.instance
-		registry.instance_variable_set(:@values, Hash.new(0))
-		registry.instance_variable_set(:@metrics, {})
-		registry.instance_variable_set(:@observer, nil)
 	end
 	
 	it "can create a metric from a field name" do
-		metric = Async::Utilization.metric(:total_requests)
+		metric = registry.metric(:total_requests)
 		
 		expect(metric).to be_a(Async::Utilization::Metric)
 		expect(metric.name).to be == :total_requests
 	end
 	
 	it "can increment a metric" do
-		Async::Utilization.observer = observer
-		metric = Async::Utilization.metric(:total_requests)
+		registry.observer = observer
+		metric = registry.metric(:total_requests)
 		
 		value = metric.increment
 		expect(value).to be == 1
@@ -62,8 +58,8 @@ describe Async::Utilization::Metric do
 	end
 	
 	it "can decrement a metric" do
-		Async::Utilization.observer = observer
-		metric = Async::Utilization.metric(:total_requests)
+		registry.observer = observer
+		metric = registry.metric(:total_requests)
 		
 		metric.increment
 		metric.increment
@@ -74,8 +70,8 @@ describe Async::Utilization::Metric do
 	end
 	
 	it "can set a metric value" do
-		Async::Utilization.observer = observer
-		metric = Async::Utilization.metric(:total_requests)
+		registry.observer = observer
+		metric = registry.metric(:total_requests)
 		
 		metric.set(42)
 		expect(metric.value).to be == 42
@@ -85,8 +81,8 @@ describe Async::Utilization::Metric do
 	end
 	
 	it "can increment with auto-decrement block" do
-		Async::Utilization.observer = observer
-		metric = Async::Utilization.metric(:active_requests)
+		registry.observer = observer
+		metric = registry.metric(:active_requests)
 		
 		metric.increment do
 			expect(metric.value).to be == 1
@@ -96,8 +92,8 @@ describe Async::Utilization::Metric do
 	end
 	
 	it "decrements even if block raises an error" do
-		Async::Utilization.observer = observer
-		metric = Async::Utilization.metric(:active_requests)
+		registry.observer = observer
+		metric = registry.metric(:active_requests)
 		
 		begin
 			metric.increment do
@@ -111,8 +107,8 @@ describe Async::Utilization::Metric do
 	end
 	
 	it "writes directly to shared memory when observer is set" do
-		Async::Utilization.observer = observer
-		metric = Async::Utilization.metric(:total_requests)
+		registry.observer = observer
+		metric = registry.metric(:total_requests)
 		
 		metric.set(42)
 		
@@ -122,8 +118,8 @@ describe Async::Utilization::Metric do
 	end
 	
 	it "invalidates cache when observer changes" do
-		Async::Utilization.observer = observer
-		metric = Async::Utilization.metric(:total_requests)
+		registry.observer = observer
+		metric = registry.metric(:total_requests)
 		
 		# Set a value - cache should be built
 		metric.set(10)
@@ -139,7 +135,7 @@ describe Async::Utilization::Metric do
 		new_observer = Async::Utilization::Observer.open(new_schema, new_shm_path, segment_size, 0)
 		
 		# Change observer - cache should be invalidated
-		Async::Utilization.observer = new_observer
+		registry.observer = new_observer
 		
 		# Set a new value - cache should be rebuilt
 		metric.set(20)
@@ -151,7 +147,7 @@ describe Async::Utilization::Metric do
 	end
 	
 	it "works without an observer" do
-		metric = Async::Utilization.metric(:total_requests)
+		metric = registry.metric(:total_requests)
 		
 		# Should work fine without observer (uses fallback path)
 		metric.increment
@@ -161,21 +157,21 @@ describe Async::Utilization::Metric do
 		expect(metric.value).to be == 5
 		
 		# Set observer and verify it works with fast path
-		Async::Utilization.observer = observer
+		registry.observer = observer
 		metric.set(10)
 		expect(metric.value).to be == 10
 	end
 	
 	it "returns the same metric instance for the same field" do
-		metric1 = Async::Utilization.metric(:total_requests)
-		metric2 = Async::Utilization.metric(:total_requests)
+		metric1 = registry.metric(:total_requests)
+		metric2 = registry.metric(:total_requests)
 		
 		expect(metric1).to be == metric2
 	end
 	
 	it "falls back to observer.set when write_direct fails" do
-		Async::Utilization.observer = observer
-		metric = Async::Utilization.metric(:total_requests)
+		registry.observer = observer
+		metric = registry.metric(:total_requests)
 		
 		# Force cache to be invalid by invalidating it
 		metric.invalidate
@@ -190,8 +186,8 @@ describe Async::Utilization::Metric do
 	end
 	
 	it "handles write errors gracefully" do
-		Async::Utilization.observer = observer
-		metric = Async::Utilization.metric(:total_requests)
+		registry.observer = observer
+		metric = registry.metric(:total_requests)
 		
 		# Set a value first to build the cache
 		metric.set(10)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-utilization
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Samuel Williams