async-service 0.21.0 → 0.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de59afc9bb1a297f08d89797f5cc1cab814aadb6fd867773a70a3c2b83bcf1d7
-  data.tar.gz: 07c8402c361ae967fd593616d1777367118687fa490b9bb8e5cb5e64003280c0
+  metadata.gz: 5f7f1e1833ae119be22f91c6c84073871863a49269b3173a9ed0506dbdb7afc3
+  data.tar.gz: a05e566aa7668b42991189b7bcea2f8e9e298a4a51545880e965e82256ac7d8e
 SHA512:
-  metadata.gz: 777190197a4272ce2f8c726abdbf1b018e46af424ca68d9fbfa4eba8490912e3c9cbb9579490743bbddf384a3b4fa2159f38ec9d58c013badd9ce4642f9bfb68
-  data.tar.gz: 5976d4d560ddcb71e781bdd1ec9a304f7851ed3cb76f1f1d82fb590765fd4137cd463afabb4da78abead51f328ce5d55cd3b45d272056fa765be086c1531c835
+  metadata.gz: 64b72fff461e46bf290c993b0fbe2ca03a7014f4cecbf0af35bceb32e5303626a62bfdeb4f2bf2fe78ae07c763939ad5830e3613881af89d9b5f80e123fa20fb
+  data.tar.gz: 6e64b02a88d0bf6b07fe228cf125c1b6864f9f29d589e2c828b7bd6733a154b2c40f4ac7e83b4f715d28281d2284a331e13669925f81ff0bed1025df63d0aa76

data/lib/async/service/generic.rb

@@ -11,12 +11,19 @@ module Async
 		# Designed to be invoked within an {Async::Controller::Container}.
 		class Generic
 			# Convert the given environment into a service if possible.
+			#
+			# If the evaluator responds to `make_service`, it is called with the environment and its return value is used as the service. This allows environments to compose child environments and return a concrete service without a dedicated service class.
+			#
+			# Otherwise, the evaluator's `service_class` is instantiated with the environment and evaluator as arguments.
+			#
 			# @parameter environment [Environment] The environment to use to construct the service.
-			# @returns [Generic | Nil] The constructed service if the environment specifies a service class.
+			# @returns [Generic | Nil] The constructed service if the environment specifies a service class or make_service.
 			def self.wrap(environment)
 				evaluator = environment.evaluator
 				
-				if evaluator.key?(:service_class)
+				if evaluator.respond_to?(:make_service)
+					return evaluator.make_service(environment)
+				elsif evaluator.key?(:service_class)
 					if service_class = evaluator.service_class
 						return service_class.new(environment, evaluator)
 					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.21.0"
+		VERSION = "0.23.0"
 	end
 end

data/readme.md

@@ -31,6 +31,18 @@ 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.23.0
+
+  - `Async::Service::Generic.wrap` now checks for a `make_service(environment)` method on the evaluator before falling back to `service_class`. This allows environments to compose child environments and return a fully-constructed service without introducing a dedicated service class.
+
+### 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.
@@ -70,19 +82,6 @@ Please see the [project releases](https://socketry.github.io/async-service/relea
   - Renamed `Async::Service::Managed::Service` -\> `Async::Service::ManagedService`.
   - Renamed `Async::Service::Managed::Environment` -\> `Async::Service::ManagedEnvironment`.
 
-### v0.15.1
-
-  - `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,17 @@
 # Releases
 
+## v0.23.0
+
+  - `Async::Service::Generic.wrap` now checks for a `make_service(environment)` method on the evaluator before falling back to `service_class`. This allows environments to compose child environments and return a fully-constructed service without introducing a dedicated service class.
+
+## 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.21.0
+  version: 0.23.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -133,7 +133,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !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: []