async-pool 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 90ad67ae4201f83d1a5c9767b425ce1223d0b4d9c068a1046c98948875ec4c15
-  data.tar.gz: 84b8d54ad04302b935f65ca5e13c5929bda43bcf95754db9568f4c99ae7d5e92
+  metadata.gz: 30797072f6201029b50156bd2b6f9ef035790e084a81449b906800a1fb6bcb33
+  data.tar.gz: d29642965319848394b3d5a2712bfe5a139fac48ec6263029b25b52e9d9fd32b
 SHA512:
-  metadata.gz: 3871fcd341afbc5db9af1f6e70ff6b58aeca070f9f8e89a5c4680e20feb33baa4c5d4c946bf2378fc526fa2dc021648ba0ec2b34b08a0de6cf2205ea6065b88f
-  data.tar.gz: 32f66fb6d31ab5413dd104061fd0afc8b3fdfb07d1644a3d315ac40c469cb985d976da393e9b54fb13fd6fff5b5a2680f7c0f00a506c52c735a068e074f890d1
+  metadata.gz: 975f7735a49f0853287bbad466aadf91e0d6b896cdb2c6d88336d94f1d4cee9c227ef8cf4ea63dcc118ca1b709ce109622d8e89f1d90d951d1ea1f261dcfa854
+  data.tar.gz: 7a75ec0f2d2506b85bc61ec60f3da503ddcfb5277c2390398d5a7b5834cee33b01651405f134e3c80865a5f87a975754f21cceeee1a4a2797f24c9f8efb74948

data/lib/async/pool/controller.rb

@@ -1,8 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2022, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 # Copyright, 2020, by Simon Perepelitsa.
+# Copyright, 2024, by Thomas Morgan.
 
 require 'console/logger'
 
@@ -44,6 +45,27 @@ module Async
 			# @attribute [Integer] The maximum number of resources that this pool can have at any given time.
 			attr_accessor :limit
 			
+			def to_s
+				if @resources.empty?
+					"\#<#{self.class}(#{usage_string})>"
+				else
+					"\#<#{self.class}(#{usage_string}) #{availability_summary.join(';')}>"
+				end
+			end
+			
+			def as_json(...)
+				{
+					limit: @limit,
+					concurrency: @guard.limit,
+					usage: @resources.size,
+					availability_summary: self.availability_summary,
+				}
+			end
+			
+			def to_json(...)
+				as_json.to_json(...)
+			end
+			
 			# @attribute [Integer] The maximum number of concurrent tasks that can be creating a new resource.
 			def concurrency
 				@guard.limit
@@ -133,14 +155,6 @@ module Async
 				@gardener&.stop
 			end
 			
-			def to_s
-				if @resources.empty?
-					"\#<#{self.class}(#{usage_string})>"
-				else
-					"\#<#{self.class}(#{usage_string}) #{availability_string}>"
-				end
-			end
-			
 			# Retire (and close) all unused resources. If a block is provided, it should implement the desired functionality for unused resources.
 			# @param retain [Integer] the minimum number of resources to retain.
 			# @yield resource [Resource] unused resources.
@@ -156,10 +170,12 @@ module Async
 				
 				# It's okay for this to context switch:
 				unused.each do |resource|
-					if block_given?
-						yield resource
-					else
-						retire(resource)
+					if usage = @resources[resource] and usage.zero?
+						if block_given?
+							yield resource
+						else
+							retire(resource)
+						end
 					end
 					
 					break if @resources.size <= retain
@@ -215,10 +231,10 @@ module Async
 				"#{@resources.size}/#{@limit || '∞'}"
 			end
 			
-			def availability_string
+			def availability_summary
 				@resources.collect do |resource, usage|
 					"#{usage}/#{resource.concurrency}#{resource.viable? ? nil : '*'}/#{resource.count}"
-				end.join(";")
+				end
 			end
 			
 			# def usage

data/lib/async/pool/version.rb

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

data/license.md

@@ -1,8 +1,9 @@
 # MIT License
 
-Copyright, 2019-2023, by Samuel Williams.  
+Copyright, 2019-2024, by Samuel Williams.  
 Copyright, 2020, by Simon Perepelitsa.  
 Copyright, 2021, by Olle Jonsson.  
+Copyright, 2024, by Thomas Morgan.  
 
 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

@@ -52,3 +52,11 @@ We welcome contributions to this project.
 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.
+
+### Developer Certificate of Origin
+
+This project uses the [Developer Certificate of Origin](https://developercertificate.org/). All contributors to this project must agree to this document to have their contributions accepted.
+
+### Contributor Covenant
+
+This project is governed by the [Contributor Covenant](https://www.contributor-covenant.org/). All contributors and participants agree to abide by its terms.

metadata

@@ -1,12 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: async-pool
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Samuel Williams
 - Olle Jonsson
 - Simon Perepelitsa
+- Thomas Morgan
 autorequire:
 bindir: bin
 cert_chain:
@@ -39,7 +40,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2023-03-12 00:00:00.000000000 Z
+date: 2024-04-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -55,90 +56,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.25'
-- !ruby/object:Gem::Dependency
-  name: bake-test
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: bake-test-external
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: covered
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: sus
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.15'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.15'
-- !ruby/object:Gem::Dependency
-  name: sus-fixtures-async
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 description:
 email:
 executables: []
@@ -155,7 +72,9 @@ homepage: https://github.com/socketry/async-pool
 licenses:
 - MIT
 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:
@@ -164,14 +83,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.7
+rubygems_version: 3.5.3
 signing_key:
 specification_version: 4
 summary: A singleplex and multiplex resource pool for implementing robust clients.