async-pool 0.8.1 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8d877fb908af8482011de394630982c4c593e36a5efd9ef19a885bba5774f6e8
-  data.tar.gz: be2d7efd8c65a9eec5237acc4f432e76a3f401da0b13e7e10b089f9849382f2a
+  metadata.gz: 958468bc2e159bc6304f603d522ccc08fe967469bd463a992484f237e880ddf3
+  data.tar.gz: 2fcd90d3589cb71a9395b0e9b9810dc860bda4971c538e754d7a4113e1628ff0
 SHA512:
-  metadata.gz: 3e472af40018c10b2a8d726fc31b04ea96557d790c55e4fe6449a891b048c96da66794926eb7ca726195f778d0bea1e6c9d762b274a06a0922f382d5a8794ab7
-  data.tar.gz: 8abacfdcb4b32eb573e0108aecdbdd7ff385386e8a8de2710550b976a81467286e73fa8f36292162e801d5f000fc2a222aabf99f7cf334a35d7e22e47833ded1
+  metadata.gz: 5a03eb3421cd11bc52ec995ddadd67c9e717763a69dbed5d8d27248f0b93ec9e824765eef5a8d02719968fc20f974d4b7690ec8a1e66fa6cc5d103f95f56ce0d
+  data.tar.gz: f4f19064995d171e013e5d80c90343387c733e9f13a4acd846c1534aee573ff7f75c5d3d41907919bdd83ff09bd1112e6a9d7f063ed66e4e072e91648220ae2b

data/lib/async/pool/controller.rb

@@ -5,14 +5,14 @@
 # Copyright, 2020, by Simon Perepelitsa.
 # Copyright, 2024, by Thomas Morgan.
 
-require 'console/logger'
+require "console/logger"
 
-require 'async'
-require 'async/notification'
-require 'async/semaphore'
+require "async"
+require "async/notification"
+require "async/semaphore"
 
-require 'traces'
-require 'metrics'
+require "traces"
+require "metrics"
 
 module Async
 	module Pool
@@ -29,7 +29,7 @@ module Async
 			# @parameter limit [Integer | Nil] The maximum number of resources that this pool can have at any given time. If nil, the pool can have an unlimited number of resources.
 			# @parameter concurrency [Integer] The maximum number of concurrent tasks that can be creating a new resource.
 			# @parameter policy [Policy] The pool policy.
-			def initialize(constructor, limit: nil, concurrency: (limit || 1), policy: nil)
+			def initialize(constructor, limit: nil, concurrency: (limit || 1), policy: nil, tags: nil)
 				@constructor = constructor
 				@limit = limit
 				
@@ -39,6 +39,8 @@ module Async
 				@policy = policy
 				@gardener = nil
 				
+				@tags = Metrics::Tags.normalize(tags)
+				
 				# All available resources:
 				@resources = {}
 				
@@ -96,6 +98,9 @@ module Async
 			# @attribute [Hash(Resource, Integer)] all allocated resources, and their associated usage.
 			attr :resources
 			
+			# @attribute [Array(String)] The name of the pool.
+			attr_accessor :tags
+			
 			# The number of resources in the pool.
 			def size
 				@resources.size
@@ -388,40 +393,42 @@ module Async
 						concurrency: @guard.limit,
 						size: @resources.size,
 						limit: @limit,
+						tags: @tags,
 					}
 					
-					Traces.trace('async.pool.create', attributes: attributes) {super}
+					Traces.trace("async.pool.create", attributes: attributes) {super}
 				end
 				
 				def drain(...)
 					attributes = {
 						size: @resources.size,
+						tags: @tags,
 					}
 					
-					Traces.trace('async.pool.drain', attributes: attributes) {super}
+					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.')
+				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)
+					ACQUIRE_COUNT.emit(1, tags: @tags)
 					
 					super
 				end
 				
 				def release(...)
 					super.tap do
-						RELEASE_COUNT.emit(1)
+						RELEASE_COUNT.emit(1, tags: @tags)
 					end
 				end
 				
 				def retire(...)
 					super.tap do
-						RETIRE_COUNT.emit(1)
+						RETIRE_COUNT.emit(1, tags: @tags)
 					end
 				end
 			end

data/lib/async/pool/resource.rb

@@ -3,10 +3,10 @@
 # Released under the MIT License.
 # Copyright, 2019-2024, by Samuel Williams.
 
-require 'console/logger'
+require "console/logger"
 
-require 'async/notification'
-require 'async/semaphore'
+require "async/notification"
+require "async/semaphore"
 
 module Async
 	module Pool

data/lib/async/pool/version.rb

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

data/lib/async/pool.rb

@@ -3,8 +3,8 @@
 # Released under the MIT License.
 # Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'pool/version'
-require_relative 'pool/controller'
+require_relative "pool/version"
+require_relative "pool/controller"
 
 # @namespace
 module Async

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-pool
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.9.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -40,7 +40,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-08-26 00:00:00.000000000 Z
+date: 2024-10-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -60,16 +60,16 @@ dependencies:
   name: metrics
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.11'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.11'
 - !ruby/object:Gem::Dependency
   name: traces
   requirement: !ruby/object:Gem::Requirement