async-pool 0.10.2 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e6e8dc07c2eb994f4dbf4080dee0fee32bd965cb10a103798673d05a6a71078
-  data.tar.gz: 551b810930f43923d32f7236f48922311fb99e14243408e79f7d8f5f28dd3f0b
+  metadata.gz: fced21c28680f832d46cd11769b97d5a1dfd7a46761c58a144a1ff5ce178c7ff
+  data.tar.gz: e23c00cb8b7d48be97f5df59b6f05ea3728b40edbca97cda347740140d77621c
 SHA512:
-  metadata.gz: 9f368abe8db1c8e04cba458cac6377d0dbd594dd78ceb1baf39f4ac8db6ca32e699525be155b828b0d8ff82e476c532548a83592bdfb7c169af749f5c06c5622
-  data.tar.gz: aa19bcf1f837e7c1c2472afae94ccb6f0af39ad6e7520b80d09d5f99756ff0adcbf81750b53a8934620d63cd64371f8c46640af18ba1e97c72f9c737d4fad34c
+  metadata.gz: a14bbfcb0c1dcd18f044de7caaf901c3ac17d80431342c0e584bd97d311d7d0acb12ec7004f5c0cf4942d406b90a2536ab9bb1297c393b03e3129572b082d342
+  data.tar.gz: b36b8d19bde4f2503781f828b2a8df3d871915dc852c942658c6779ffa51a0b7e4d29daab077e73a8967f9a2d3734df5437dd433d94aa8c7b9a9a38c4ef4d708

data/lib/async/pool/controller.rb

@@ -1,17 +1,17 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2024, by Samuel Williams.
+# Copyright, 2019-2025, by Samuel Williams.
 # Copyright, 2020, by Simon Perepelitsa.
 # Copyright, 2024, by Thomas Morgan.
+# Copyright, 2025, by Jean Boussier.
 
 require "console/logger"
 
 require "async"
-require "async/notification"
 require "async/semaphore"
 
-require "traces"
+require "thread"
 
 module Async
 	module Pool
@@ -48,7 +48,8 @@ module Async
 				@available = []
 				
 				# Used to signal when a resource has been released:
-				@notification = Async::Notification.new
+				@mutex = Thread::Mutex.new
+				@condition = Thread::ConditionVariable.new
 			end
 			
 			# @attribute [Proc] The constructor used to create new resources.
@@ -125,8 +126,23 @@ module Async
 			end
 			
 			# Wait until a pool resource has been freed.
+			# @deprecated Use {wait_until_free} instead.
 			def wait
-				@notification.wait
+				@mutex.synchronize do
+					@condition.wait(@mutex)
+				end
+			end
+			
+			# Wait until the pool is not busy (no resources in use).
+			def wait_until_free
+				@mutex.synchronize do
+					if busy?
+						yield self if block_given?
+						
+						# Wait until the pool is not busy:
+						@condition.wait(@mutex) while busy?
+					end
+				end
 			end
 			
 			# Whether the pool is empty.
@@ -161,6 +177,7 @@ module Async
 				retire(resource) unless processed
 			end
 			
+			# Drain the pool, closing all resources.
 			def drain
 				Console.debug(self, "Draining pool...", size: @resources.size)
 				
@@ -170,7 +187,7 @@ module Async
 				end
 			end
 			
-			# Close all resources in the pool.
+			# Drain the pool, clear all resources, and stop the gardener.
 			def close
 				self.drain
 				
@@ -221,7 +238,7 @@ module Async
 				
 				resource.close
 				
-				@notification.signal
+				@mutex.synchronize {@condition.broadcast}
 				
 				return true
 			end
@@ -285,7 +302,7 @@ module Async
 				
 				@resources[resource] = usage - 1
 				
-				@notification.signal
+				@mutex.synchronize {@condition.broadcast}
 				
 				return true
 			end
@@ -293,11 +310,9 @@ module Async
 			def wait_for_resource
 				# If we fail to create a resource (below), we will end up waiting for one to become resources.
 				until resource = available_resource
-					@notification.wait
+					@mutex.synchronize {@condition.wait(@mutex)}
 				end
-				
 				# Be careful not to context switch or fail here.
-				
 				return resource
 			end
 			
@@ -329,7 +344,7 @@ module Async
 				end
 				
 				return resource
-			rescue Exception => error
+			rescue Exception
 				reuse(resource) if resource
 				raise
 			end
@@ -345,10 +360,8 @@ module Async
 							return resource
 						end
 					end
-					
-					@notification.wait
+					@mutex.synchronize {@condition.wait(@mutex)}
 				end
-				
 				# Only when the pool has been completely drained, return nil:
 				return nil
 			end
@@ -381,59 +394,6 @@ module Async
 					return create_resource
 				end
 			end
-			
-			Traces::Provider(self) do
-				def create_resource(...)
-					attributes = {
-						concurrency: @guard.limit,
-					}
-					
-					attributes.merge!(@tags) if @tags
-					
-					Traces.trace('async.pool.create', attributes: attributes) {super}
-				end
-				
-				def drain(...)
-					attributes = {
-						size: @resources.size,
-					}
-					
-					attributes.merge!(@tags) if @tags
-					
-					Traces.trace('async.pool.drain', attributes: attributes) {super}
-				end
-				
-				def acquire(...)
-					attributes = {
-						size: @resources.size,
-						limit: @limit,
-					}
-					
-					attributes.merge!(@tags) if @tags
-					
-					Traces.trace('async.pool.acquire', attributes: attributes) {super}
-				end
-				
-				def release(...)
-					attributes = {
-						size: @resources.size,
-					}
-					
-					attributes.merge!(@tags) if @tags
-					
-					Traces.trace('async.pool.release', attributes: attributes) {super}
-				end
-				
-				def retire(...)
-					attributes = {
-						size: @resources.size,
-					}
-					
-					attributes.merge!(@tags) if @tags
-					
-					Traces.trace('async.pool.retire', attributes: attributes) {super}
-				end
-			end
 		end
 	end
 end

data/lib/async/pool/version.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2024, by Samuel Williams.
+# Copyright, 2019-2025, by Samuel Williams.
 
 module Async
 	module Pool
-		VERSION = "0.10.2"
+		VERSION = "0.11.0"
 	end
 end

data/lib/traces/provider/async/pool/controller.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2025, by Samuel Williams.
+
+require_relative "../../../../async/pool/controller"
+
+Traces::Provider(Async::Pool::Controller) do
+	def create_resource(...)
+		attributes = {
+			concurrency: @guard.limit,
+		}
+		
+		attributes.merge!(@tags) if @tags
+		
+		Traces.trace("async.pool.create", attributes: attributes) {super}
+	end
+	
+	def drain(...)
+		attributes = {
+			size: @resources.size,
+		}
+		
+		attributes.merge!(@tags) if @tags
+		
+		Traces.trace("async.pool.drain", attributes: attributes) {super}
+	end
+	
+	def acquire(...)
+		attributes = {
+			size: @resources.size,
+			limit: @limit,
+		}
+		
+		attributes.merge!(@tags) if @tags
+		
+		Traces.trace("async.pool.acquire", attributes: attributes) {super}
+	end
+	
+	def release(...)
+		attributes = {
+			size: @resources.size,
+		}
+		
+		attributes.merge!(@tags) if @tags
+		
+		Traces.trace("async.pool.release", attributes: attributes) {super}
+	end
+	
+	def retire(...)
+		attributes = {
+			size: @resources.size,
+		}
+		
+		attributes.merge!(@tags) if @tags
+		
+		Traces.trace("async.pool.retire", attributes: attributes) {super}
+	end
+end

data/license.md

@@ -1,9 +1,10 @@
 # MIT License
 
-Copyright, 2019-2024, by Samuel Williams.  
+Copyright, 2019-2025, by Samuel Williams.  
 Copyright, 2020, by Simon Perepelitsa.  
 Copyright, 2021, by Olle Jonsson.  
 Copyright, 2024, by Thomas Morgan.  
+Copyright, 2025, by Jean Boussier.  
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/readme.md

@@ -10,6 +10,12 @@ Please see the [project documentation](https://socketry.github.io/async-pool/) f
 
   - [Getting Started](https://socketry.github.io/async-pool/guides/getting-started/index) - This guide explains how to use the `async-pool` gem to manage connection pooling.
 
+## Releases
+
+Please see the [project releases](https://socketry.github.io/async-pool/releases/index) for all releases.
+
+### v0.11.0
+
 ## Contributing
 
 We welcome contributions to this project.

data/releases.md

@@ -0,0 +1,3 @@
+# Releases
+
+## v0.11.0

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: async-pool
 version: !ruby/object:Gem::Version
-  version: 0.10.2
+  version: 0.11.0
 platform: ruby
 authors:
 - Samuel Williams
+- Jean Boussier
 - Olle Jonsson
 - Simon Perepelitsa
 - Thomas Morgan
-autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -40,7 +40,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-11-13 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -48,30 +48,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.25'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.25'
-- !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:
+        version: '2.0'
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -80,8 +64,10 @@ files:
 - lib/async/pool/controller.rb
 - lib/async/pool/resource.rb
 - lib/async/pool/version.rb
+- lib/traces/provider/async/pool/controller.rb
 - license.md
 - readme.md
+- releases.md
 homepage: https://github.com/socketry/async-pool
 licenses:
 - MIT
@@ -89,7 +75,6 @@ metadata:
   documentation_uri: https://socketry.github.io/async-pool/
   funding_uri: https://github.com/sponsors/ioquatix/
   source_code_uri: https://github.com/socketry/async-pool.git
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -97,15 +82,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.7
 specification_version: 4
 summary: A singleplex and multiplex resource pool for implementing robust clients.
 test_files: []