Use String::Format gem for formatting.

Author: ioquatix

async-service.gemspec

@@ -28,4 +28,5 @@ Gem::Specification.new do |spec|
 
 	spec.add_dependency "async"
 	spec.add_dependency "async-container", "~> 0.16"
+	spec.add_dependency "string-format", "~> 0.2"
 end

lib/async/service/formatting.rb

@@ -3,40 +3,24 @@
 # Released under the MIT License.
 # Copyright, 2025, by Samuel Williams.
 
+require "string/format"
+
 module Async
 	module Service
 		# Formatting utilities for service titles.
 		#
 		# 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 @@ def format_count(value, units = UNITS)
 			# @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 @@ def format_ratio(current, total)
 			# @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

releases.md

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

test/async/service/formatting.rb

@@ -117,7 +117,7 @@
 	with "#format_statistics" do
 		it "formats single values" do
 			result = subject.format_statistics(connections: 23)
-			expect(result).to be == "CONNECTIONS=23"
+			expect(result).to be == "C=23"
 		end
 
 		it "formats ratios from arrays" do
@@ -139,12 +139,12 @@
 				active: 5,
 				load: 0.273
 			)
-			expect(result).to be == "CONNECTIONS=23/3.42K ACTIVE=5 LOAD=0.27"
+			expect(result).to be == "C=23/3.42K A=5 L=0.27"
 		end
 
 		it "handles arrays with more than 2 elements" do
 			result = subject.format_statistics(multi: [1, 2, 3])
-			expect(result).to be == "MULTI=1/2/3"
+			expect(result).to be == "M=1/2/3"
 		end
 
 		it "handles empty statistics" do
@@ -157,7 +157,7 @@
 				:symbol_key => 100,
 				"string_key" => 200
 			)
-			expect(result).to be == "SYMBOL_KEY=100 STRING_KEY=200"
+			expect(result).to be == "S=100 S=200"
 		end
 	end