async-pool 0.8.0 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb369c01748a2f2c555a8549a2280c1e39b30a3c7f7918e4e426a79d7eec41ce
-  data.tar.gz: 5b8d9ac62de382ce06753d04512708cca9c969c7eaf368a1f7b88fa12b6d1eae
+  metadata.gz: 8d877fb908af8482011de394630982c4c593e36a5efd9ef19a885bba5774f6e8
+  data.tar.gz: be2d7efd8c65a9eec5237acc4f432e76a3f401da0b13e7e10b089f9849382f2a
 SHA512:
-  metadata.gz: b18bfe389d25644da07f2e8f85bd92891f7066e1c9b67d6ed91e9a9de1e8d47bcaf4e612c7388619a8693c2f6ee2fc85a09f0cada7647f53a2de5714dbaac30a
-  data.tar.gz: 0bb8ca350d3942057cfcc91ff957382512ee0e1e012e20344ba71b6bf09df7a353c65d4996341fc8407d99629a8286346a6412a4e6bc6a0199dcaf67e11d069f
+  metadata.gz: 3e472af40018c10b2a8d726fc31b04ea96557d790c55e4fe6449a891b048c96da66794926eb7ca726195f778d0bea1e6c9d762b274a06a0922f382d5a8794ab7
+  data.tar.gz: 8abacfdcb4b32eb573e0108aecdbdd7ff385386e8a8de2710550b976a81467286e73fa8f36292162e801d5f000fc2a222aabf99f7cf334a35d7e22e47833ded1

data/lib/async/pool/controller.rb

@@ -11,6 +11,9 @@ require 'async'
 require 'async/notification'
 require 'async/semaphore'
 
+require 'traces'
+require 'metrics'
+
 module Async
 	module Pool
 		# A resource pool controller.
@@ -154,7 +157,9 @@ module Async
 				retire(resource) unless processed
 			end
 			
-			private def drain
+			def drain
+				Console.debug(self, "Draining pool...", size: @resources.size)
+				
 				# Enumerate all existing resources and retire them:
 				while resource = acquire_existing_resource
 					retire(resource)
@@ -262,6 +267,7 @@ module Async
 			
 			def reuse(resource)
 				Console.debug(self) {"Reuse #{resource}"}
+				
 				usage = @resources[resource]
 				
 				if usage.nil? || usage.zero?
@@ -286,11 +292,7 @@ module Async
 					@notification.wait
 				end
 				
-				Console.debug(self) {"Wait for resource -> #{resource}"}
-				
-				# if resource.concurrency > 1
-				# 	@notification.signal
-				# end
+				# Be careful not to context switch or fail here.
 				
 				return resource
 			end
@@ -318,12 +320,16 @@ module Async
 			def available_resource
 				resource = nil
 				
+				Console.debug(self, "Acquiring concurrency guard...", blocking: @guard.blocking?)
+				
 				@guard.acquire do
+					Console.debug(self, "Acquired concurrency guard.")
+					
 					resource = acquire_or_create_resource
 				end
 				
 				return resource
-			rescue Exception
+			rescue Exception => error
 				reuse(resource) if resource
 				raise
 			end
@@ -375,6 +381,50 @@ module Async
 					return create_resource
 				end
 			end
+			
+			Traces::Provider(self) do
+				def create_resource(...)
+					attributes = {
+						concurrency: @guard.limit,
+						size: @resources.size,
+						limit: @limit,
+					}
+					
+					Traces.trace('async.pool.create', attributes: attributes) {super}
+				end
+				
+				def drain(...)
+					attributes = {
+						size: @resources.size,
+					}
+					
+					Traces.trace('async.pool.drain', attributes: attributes) {super}
+				end
+			end
+			
+			Metrics::Provider(self) do
+				ACQUIRE_COUNT = Metrics.metric('async.pool.acquire', :counter, description: 'Number of times a resource was invoked.')
+				RELEASE_COUNT = Metrics.metric('async.pool.release', :counter, description: 'Number of times a resource was released.')
+				RETIRE_COUNT = Metrics.metric('async.pool.retire', :counter, description: 'Number of times a resource was retired.')
+				
+				def acquire(...)
+					ACQUIRE_COUNT.emit(1)
+					
+					super
+				end
+				
+				def release(...)
+					super.tap do
+						RELEASE_COUNT.emit(1)
+					end
+				end
+				
+				def retire(...)
+					super.tap do
+						RETIRE_COUNT.emit(1)
+					end
+				end
+			end
 		end
 	end
 end

data/lib/async/pool/version.rb

@@ -5,6 +5,6 @@
 
 module Async
 	module Pool
-		VERSION = "0.8.0"
+		VERSION = "0.8.1"
 	end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-pool
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.8.1
 platform: ruby
 authors:
 - Samuel Williams
@@ -40,7 +40,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-08-07 00:00:00.000000000 Z
+date: 2024-08-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -56,6 +56,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.25'
+- !ruby/object:Gem::Dependency
+  name: metrics
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: traces
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description:
 email:
 executables: []