async-service 0.14.2 → 0.14.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d183945602c8bb4ac0408390671c73a0e7b86baae548194a91ce0587f6d5941a
-  data.tar.gz: 2dbb203184966a7abffaa996c80ec82e1664cd952f4b37997553797396145289
+  metadata.gz: '09520c2c06a66a0524f733e446046f67e24d8a316ba4d08e566863dae765116d'
+  data.tar.gz: 8462198e099679b85c524d75a15ca8911ab17d31da71e492dbeda2958006a752
 SHA512:
-  metadata.gz: 965863a04ce7cee71764485e7adce9be13324ccf5a8fe8ee04df2e831c9137bdff8bc47d4b62b637db5d98661918df46affb8ef29003899a0f23bb44920c5ca2
-  data.tar.gz: 56a49adffb4902fc4ac4dc9b8638e1ce21f214e172de610a28f4c448a29002499d0535b077828098e9b19415af18184866612103765043796c4c61d85ce4614f
+  metadata.gz: 39579c924d04afb7271183498a40ab91f7380f1d848dd52c5785f49823ec85d19f173ecd9cf09de92229c4b9e80a5f22dadd7f4eed5663ea1a356ad8f12534c9
+  data.tar.gz: 17bf024007654e733965b103747f72db73f5dd89484c000320dee4296426321ce92cb0ed30f1f7a45d65992aaf6269c9111c0ddcdb51bfdbe1bec0dfeb8c30c5

data/lib/async/service/formatting.rb

@@ -3,6 +3,8 @@
 # Released under the MIT License.
 # Copyright, 2025, by Samuel Williams.
 
+require "string/format"
+
 module Async
 	module Service
 		# Formatting utilities for service titles.
@@ -10,33 +12,15 @@ module Async
 		# Services need meaningful process/thread names for monitoring and debugging. This module provides consistent formatting for common service metrics like connection counts, request ratios, and load values in process titles.
 		#
 		# It is expected you will include these into your service class and use them to update the `instance.name` in the health check.
+		#
+		# @deprecated Use {String::Format} directly.
 		module Formatting
-			UNITS = [nil, "K", "M", "B", "T", "P", "E", "Z", "Y"]
-			
 			# Format a count into a human-readable string.
 			# @parameter value [Numeric] The count to format.
-			# @parameter units [Array] The units to use for formatting (default: UNITS).
+			# @parameter units [Array] The units to use for formatting (default: String::Format::UNITS).
 			# @returns [String] A formatted string representing the count.
-			def format_count(value, units = UNITS)
-				value = value
-				index = 0
-				limit = units.size - 1
-				
-				# Handle negative numbers by working with absolute value:
-				negative = value < 0
-				value = value.abs
-				
-				while value >= 1000 and index < limit
-					value = value / 1000.0
-					index += 1
-				end
-				
-				result = String.new
-				result << "-" if negative
-				result << value.round(2).to_s
-				result << units[index].to_s if units[index]
-				
-				return result
+			def format_count(value, units = String::Format::UNITS)
+				String::Format.count(value, units)
 			end
 			
 			module_function :format_count
@@ -46,7 +30,7 @@ module Async
 			# @parameter total [Numeric] The total value.
 			# @returns [String] A formatted ratio string.
 			def format_ratio(current, total)
-				"#{format_count(current)}/#{format_count(total)}"
+				String::Format.ratio(current, total)
 			end
 			
 			module_function :format_ratio
@@ -55,27 +39,16 @@ module Async
 			# @parameter load [Numeric] The load value (typically 0.0 to 1.0+).
 			# @returns [String] A formatted load string.
 			def format_load(load)
-				load.round(2).to_s
+				String::Format.decimal(load)
 			end
 			
 			module_function :format_load
 			
 			# Format multiple statistics into a compact string.
-			# @parameter stats [Hash] Hash of statistic names to values or [current, total] arrays.
+			# @parameter pairs [Hash] Hash of statistic names to values or [current, total] arrays.
 			# @returns [String] A formatted statistics string.
 			def format_statistics(**pairs)
-				pairs.map do |key, value|
-					case value
-					when Array
-						if value.length == 2
-							"#{key.to_s.upcase}=#{format_ratio(value[0], value[1])}"
-						else
-							"#{key.to_s.upcase}=#{value.join('/')}"
-						end
-					else
-						"#{key.to_s.upcase}=#{format_count(value)}"
-					end
-				end.join(" ")
+				String::Format.statistics(pairs)
 			end
 			
 			module_function :format_statistics

data/lib/async/service/version.rb

@@ -5,6 +5,6 @@
 
 module Async
 	module Service
-		VERSION = "0.14.2"
+		VERSION = "0.14.4"
 	end
 end

data/readme.md

@@ -27,6 +27,10 @@ Please see the [project documentation](https://socketry.github.io/async-service/
 
 Please see the [project releases](https://socketry.github.io/async-service/releases/index) for all releases.
 
+### v0.14.4
+
+  - Use `String::Format` gem for formatting.
+
 ### v0.14.0
 
   - Introduce `ContainerEnvironment` and `ContainerService` for implementing best-practice services.
@@ -67,10 +71,6 @@ Please see the [project releases](https://socketry.github.io/async-service/relea
 
   - Fix requirement that facet must be a module.
 
-### v0.6.0
-
-  - Unify construction of environments for better consistency.
-
 ## Contributing
 
 We welcome contributions to this project.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.14.4
+
+  - Use `String::Format` gem for formatting.
+
 ## v0.14.0
 
   - Introduce `ContainerEnvironment` and `ContainerService` for implementing best-practice services.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-service
 version: !ruby/object:Gem::Version
-  version: 0.14.2
+  version: 0.14.4
 platform: ruby
 authors:
 - Samuel Williams
@@ -66,6 +66,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.16'
+- !ruby/object:Gem::Dependency
+  name: string-format
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
 executables:
 - async-service
 extensions: []