async-service 0.20.1 → 0.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2d1b7a93421f685e9a7b545f73facbe3182d2e8da3458f7c70f43902dae2ce5a
-  data.tar.gz: a251e23004b48a5993665692e54037e2079f1e9176ba283fc1eb2f34b6388995
+  metadata.gz: b34c255ee7608b446acf8a57e86b876644f34eb21d5afa6b2a35d8f6235bb718
+  data.tar.gz: 66b3494d6bdfb347e1ae6b1440261754132a70fa903743f5d50dc19d636ef13e
 SHA512:
-  metadata.gz: bffe72b2c92b84fe2ecda60023ab1efc9c46f996e62e0ccda98a230d716ead4893879c78000eb2980c50a7dd0b9391b3158561f820e2dc3d5d6af2d17dec85c8
-  data.tar.gz: 8644d5b85ce7d4e40c04002c61432eb956ff75fd227435f45fe32b13c3e50973282b6c72b92e8b8eb3da99fe8ef876845c14a4830d09cd828cac921a43e7a308
+  metadata.gz: bc3919f55bbf3221098522a47ecc4d744cdabc97f958d4b5d63dc8ed350c4f778b414acda577304a1a2b6493132abf01562f333a67bd84f348feab260d20c9ad
+  data.tar.gz: 9adf428ca9ddd8eb76aa0adcd67ab60268fa49bfe118d868b5fca6a75aa27749a4576f1f437f2e94855bcb2fd1013dd06ec4e8c4ec801b8c4cd99ddbbd77bf5d

data/bake/async/service/configuration.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2024-2025, by Samuel Williams.
+
+def initialize(context)
+	super
+	
+	require "async/service/configuration"
+	
+	@configuration = Async::Service::Configuration.new
+end
+
+attr :configuration
+
+# Load the configuration from the given path.
+# @parameter path [String] The path to the configuration file.
+def load(path)
+	@configuration.load_file(path)
+end
+
+# List the available environments (all named environments).
+def list
+	@configuration.environments.map(&:to_h)
+end
+
+# List the available services (those that define a service class).
+def services
+	@configuration.services.map(&:to_h)
+end

data/bake/async/service/controller.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2024-2026, by Samuel Williams.
+
+def initialize(context)
+	super
+	
+	require "async/service/controller"
+end
+
+def run
+	controller.run
+end
+
+private
+
+def controller
+	configuration = context.lookup("async:service:configuration").instance.configuration
+	
+	return configuration.make_controller
+end

data/lib/async/service/managed/health_checker.rb

@@ -10,32 +10,28 @@ module Async
 			module HealthChecker
 				# Start the health checker.
 				#
-				# If a timeout is specified, a transient child task will be scheduled, which will yield the instance if a block is given, then mark the instance as ready, and finally sleep for half the health check duration (so that we guarantee that the health check runs in time).
+				# If a timeout is specified, a transient child task will be scheduled which will mark the instance as healthy, sleep for half the health check duration (so that we guarantee that the health check runs in time), and then yield the instance if a block is given. This repeats indefinitely.
 				#
-				# If a timeout is not specified, the health checker will yield the instance immediately and then mark the instance as ready.
+				# If a timeout is not specified, the instance is marked as healthy immediately and no task is created. Any block given is ignored.
 				#
 				# @parameter instance [Object] The service instance to check.
 				# @parameter timeout [Numeric] The timeout duration for the health check.
 				# @parameter parent [Async::Task] The parent task to run the health checker in.
-				# @yields {|instance| ...} If a block is given, it will be called with the service instance at least once.
+				# @yields {|instance| ...} If a block is given and a timeout is specified, it will be called with the service instance after each sleep interval.
 				def health_checker(instance, timeout = @evaluator.health_check_timeout, parent: Async::Task.current, &block)
 					if timeout
 						parent.async(transient: true) do
 							while true
-								if block_given?
-									yield(instance)
-								end
-								
 								instance.healthy!
 								
 								sleep(timeout / 2.0)
+								
+								if block_given?
+									yield(instance)
+								end
 							end
 						end
 					else
-						if block_given?
-							yield(instance)
-						end
-						
 						instance.healthy!
 					end
 				end

data/lib/async/service/managed/service.rb

@@ -93,6 +93,7 @@ module Async
 							evaluator = self.environment.evaluator
 							server = nil
 							
+							# If a health check timeout is configured, this block runs periodically to refresh the process title. Without a timeout there is no periodic timer, so the block is never called — the one-shot assignment below handles that case.
 							health_checker(instance, health_check_timeout) do
 								if server
 									instance.name = format_title(evaluator, server)
@@ -105,6 +106,8 @@ module Async
 							
 							instance.status!("Running...")
 							server = run(instance, evaluator)
+							# Set the process title immediately once the server is available:
+							instance.name = format_title(evaluator, server)
 							emit_running(instance, clock)
 							
 							instance.ready!

data/lib/async/service/version.rb

@@ -7,6 +7,6 @@
 module Async
 	# @namespace
 	module Service
-		VERSION = "0.20.1"
+		VERSION = "0.22.0"
 	end
 end

data/readme.md

@@ -31,6 +31,14 @@ 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.22.0
+
+  - Ensure process title is updated immediately after server starts in `Managed::Service`.
+
+### v0.21.0
+
+  - Add missing bake files.
+
 ### v0.20.1
 
   - Use `container.stopping?` in policy to prevent redundant stop calls during graceful shutdown.
@@ -74,15 +82,6 @@ Please see the [project releases](https://socketry.github.io/async-service/relea
 
   - `Managed::Service` should run within `Async do ... end`.
 
-### v0.15.0
-
-  - Rename `ContainerEnvironment` and `ContainerService` to `Managed::Environment` and `Managed::Service` respectively.
-  - Health check uses `Fiber.new{instance.ready!}.resume` to confirm fiber allocation is working.
-
-### v0.14.4
-
-  - Use `String::Format` gem for formatting.
-
 ## Contributing
 
 We welcome contributions to this project.

data/releases.md

@@ -1,5 +1,13 @@
 # Releases
 
+## v0.22.0
+
+  - Ensure process title is updated immediately after server starts in `Managed::Service`.
+
+## v0.21.0
+
+  - Add missing bake files.
+
 ## v0.20.1
 
   - Use `container.stopping?` in policy to prevent redundant stop calls during graceful shutdown.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-service
 version: !ruby/object:Gem::Version
-  version: 0.20.1
+  version: 0.22.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -85,6 +85,8 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- bake/async/service/configuration.rb
+- bake/async/service/controller.rb
 - bin/async-service
 - context/best-practices.md
 - context/deployment.md
@@ -124,14 +126,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.6
 specification_version: 4
 summary: A service layer for Async.
 test_files: []