async-pool 0.11.2 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e4fe0a9bc65859c5bcb987643f591473236e1fdb2b296c9d73dc9750c01b44ff
-  data.tar.gz: 116b1ec100edce9d7bbf85fe57a41d7f7059ed495eca17c8d96940a6c10e7724
+  metadata.gz: 8261d789df6f1e5666e9994a6b977a9a51f7c196701fffebe2f26eca28aab213
+  data.tar.gz: 9db4443e7e225ed235c8700c2a89292bced23af536abf5d5a625520ccc470c5f
 SHA512:
-  metadata.gz: c17cc32005753a5f3141aa4a198c5a1b826a212c44f05a382951561bd3b274aaa66e6f0d8f77e21bd613b42f4ab1a6a0d51f9463abd4ecc33f42a5b1e46642b8
-  data.tar.gz: 326fdcd55c875d840d02d1d9fe73082edb70d83361a4a2e1cde34331ded7b3bb184a436ec8907e3c0065c3444554a56eaa89817dd25ceb2936fbf3ff96b23ada
+  metadata.gz: e570ea6d402c540b87f604e84b5df47744a69d6eb99f423069b5cae560e6f8e8cd75102dc7e6c9c8514671099a00cd7596a6c2f4a0ab551857684b3cf27f2c02
+  data.tar.gz: 34c158ab5216a2c6a8c9fc930f6f0042fc19b05a71fe3659e4ebd06dc91094effb18c8c36c1c01c160d32d2cc306a6957496c6bf9d3f78553e8cfe5dbf939a0d

data/lib/async/pool/controller.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2025, by Samuel Williams.
+# Copyright, 2019-2026, by Samuel Williams.
 # Copyright, 2020, by Simon Perepelitsa.
 # Copyright, 2024, by Thomas Morgan.
 # Copyright, 2025, by Jean Boussier.
@@ -12,6 +12,7 @@ require "console/logger"
 require "async"
 require "async/semaphore"
 
+require "set"
 require "thread"
 
 module Async
@@ -41,12 +42,12 @@ module Async
 				
 				@tags = tags
 				
-				# All available resources:
-				@resources = {}
+				# All allocated resources. Each resource is tracked by identity, irrespective of any value equality it may define:
+				@resources = {}.compare_by_identity
 				
-				# Resources which may be available to be acquired:
-				# This list may contain false positives, or resources which were okay but have since entered a state which is unusuable.
-				@available = []
+				# Resources which may be available to be acquired. Resources are compared by identity and acquired in insertion order. Adding an existing resource preserves its position; a fully utilized resource is removed and reinserted at the end when capacity becomes available again.
+				# This set may contain false positives, or resources which were okay but have since entered a state which is unusable.
+				@available = Set.new.compare_by_identity
 				
 				# Used to signal when a resource has been released:
 				@mutex = Thread::Mutex.new
@@ -166,16 +167,31 @@ module Async
 			
 			# Make the resource resources and let waiting tasks know that there is something resources.
 			def release(resource)
-				processed = false
+				unless usage = decrement_usage(resource)
+					return false
+				end
 				
-				# A resource that is not good should also not be reusable.
 				if resource.reusable?
-					processed = reuse(resource)
+					@available.add(resource)
+				else
+					# The resource must not be acquired again, but it cannot be retired until all existing users have released it:
+					@available.delete(resource)
+					
+					if usage.zero?
+						retire(resource)
+						resource = nil
+						return true
+					end
 				end
 				
+				@mutex.synchronize{@condition.broadcast}
+				
 				# @policy.released(self, resource)
+				
+				resource = nil
+				return true
 			ensure
-				retire(resource) unless processed
+				retire(resource) if resource
 			end
 			
 			# Drain the pool, closing all resources.
@@ -282,31 +298,6 @@ module Async
 			# 	@resources.count{|resource, usage| usage == 0}
 			# end
 			
-			def reuse(resource)
-				Console.debug(self){"Reuse #{resource}"}
-				
-				usage = @resources[resource]
-				
-				if usage.nil?
-					return false
-				end
-				
-				if usage.zero?
-					raise "Trying to reuse unacquired resource: #{resource}!"
-				end
-				
-				# If the resource was fully utilized, it now becomes available:
-				if usage == resource.concurrency
-					@available.push(resource)
-				end
-				
-				@resources[resource] = usage - 1
-				
-				@mutex.synchronize{@condition.broadcast}
-				
-				return true
-			end
-			
 			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
@@ -326,7 +317,7 @@ module Async
 					
 					# Make the resource available if it can be used multiple times:
 					if resource.concurrency > 1
-						@available.push(resource)
+						@available.add(resource)
 					end
 				end
 				
@@ -345,12 +336,23 @@ module Async
 				
 				return resource
 			rescue Exception
-				reuse(resource) if resource
+				release(resource) if resource
 				raise
 			end
 			
 			private
 			
+			def decrement_usage(resource)
+				usage = @resources[resource]
+				return unless usage
+				
+				if usage.zero?
+					raise "Trying to reuse unacquired resource: #{resource}!"
+				end
+				
+				return @resources[resource] = usage - 1
+			end
+			
 			# Acquire an existing resource with zero usage.
 			# If there are resources that are in use, wait until they are released.
 			def acquire_existing_resource
@@ -367,24 +369,24 @@ module Async
 			end
 			
 			def acquire_or_create_resource
-				while resource = @available.last
+				while resource = @available.first
 					if usage = @resources[resource] and usage < resource.concurrency
 						if resource.viable?
 							usage = (@resources[resource] += 1)
 							
 							if usage == resource.concurrency
 								# The resource is used up to it's limit:
-								@available.pop
+								@available.delete(resource)
 							end
 							
 							return resource
 						else
-							retire(resource)
-							@available.pop
+							@available.delete(resource)
+							retire(resource) if usage.zero?
 						end
 					else
 						# The resource has been removed already, so skip it and remove it from the availability list.
-						@available.pop
+						@available.delete(resource)
 					end
 				end
 				

data/lib/async/pool/version.rb

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

data/readme.md

@@ -14,17 +14,37 @@ Please see the [project documentation](https://socketry.github.io/async-pool/) f
 
 Please see the [project releases](https://socketry.github.io/async-pool/releases/index) for all releases.
 
+### v0.12.0
+
+  - Use identity-based tracking for pooled resources and preserve insertion order when selecting available resources.
+
 ### v0.11.2
 
 ## Contributing
 
 We welcome contributions to this project.
 
-1.  Fork it.
+1.  Fork the repository.
 2.  Create your feature branch (`git checkout -b my-new-feature`).
-3.  Commit your changes (`git commit -am 'Add some feature'`).
+3.  Commit your changes (`git commit -am 'Add some feature.'`).
 4.  Push to the branch (`git push origin my-new-feature`).
-5.  Create new Pull Request.
+5.  Create a new pull request.
+
+### Running Tests
+
+To run the test suite:
+
+``` bash
+$ bundle exec sus
+```
+
+### Making Releases
+
+To make a new release:
+
+``` bash
+$ bundle exec bake gem:release:patch # or minor or major
+```
 
 ### Developer Certificate of Origin
 

data/releases.md

@@ -1,3 +1,7 @@
 # Releases
 
+## v0.12.0
+
+  - Use identity-based tracking for pooled resources and preserve insertion order when selecting available resources.
+
 ## v0.11.2

data.tar.gz.sig

@@ -1,4 +1,4 @@
-_�
-�!_�	�����/b���S�+v����H��m>���)�[p/븇]�=2}׍�)5N��{yH���N���;�.�{+�	S֛'���i���(h_�����(�n���j�����o�g�.��1�5�>��^��ёu{�ĺ2�<@�:Zڙ��4��(u1{F�2��*
-r�U�|6
-�X��0�
+g�_r=GUwx:��]�<r1��W��ef4p�#׫
+�B�UE b��6�ϵ_�!n�!�K0��X�x�W��
��
��|�����u�1�U�p�LL�����'[��,�$�!?��
+�X���
�����#rq�U��Ci�5���߾!��ӏF���Rس�N?,�G��7�\�)(�4��=F�5���m�񖶼Z���B/7B�8h�&v~�]���Yw�.�K��s'(� �b�??�,�g�~�D�R[-K���#!�
+Ҁ1��=%\F����H����٣h�"@
����_߶Έ��ч�2�ϊv�dm"F7

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-pool
 version: !ruby/object:Gem::Version
-  version: 0.11.2
+  version: 0.12.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -73,6 +73,8 @@ homepage: https://github.com/socketry/async-pool
 licenses:
 - MIT
 metadata:
+  bug_tracker_uri: https://github.com/socketry/async-pool/issues
+  changelog_uri: https://github.com/socketry/async-pool/blob/main/releases.md
   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
@@ -83,14 +85,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: A singleplex and multiplex resource pool for implementing robust clients.
 test_files: []