async-service 0.12.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a0a40d50b41d2ddb7691daa0b3911559150853ea1c060be2bd3dad1c75d6f549
-  data.tar.gz: 5d24dc0724bf6cb013ed68072a6579368f50233b4e54ebffc1615fe300683fd0
+  metadata.gz: bd7c0c91471cbf80069a3c770f1a9489e1dac8a2b22db648a0942f31e35e2743
+  data.tar.gz: a1aa57c3746945251bde7ad98baec11d28bd477a9c39bfe33fcdf22ac9f42f71
 SHA512:
-  metadata.gz: 68a1fb24248fba49149e69e209e452b5de54b250e03160164bc6447f16831d0081297dcfd4e849b85aef32aac3432520f9d7e4eb86fd0ddd08f1c3d225dcd942
-  data.tar.gz: 3678501569e9b53da6540fe2d24fcbeffbe415acf779f8ca6c943ac67c627899d1a25ef488df8c65c348b54f20315c8faea44459f993ffaa771f590be63cdccc
+  metadata.gz: 400055e9c5d608f4eae1551304c25b96207e7b2c6b92cadeba6f476dac3c0de1a2ff2d24eb39da282d7ba52a0a6f90c400063b8a94fe883ca064ed3cbbcc1099
+  data.tar.gz: 0f416c8a882c91cc453111f0949498bf8e17d463b8dc623d06da07ca5e2435c966b2a6668c25170fe474afb9e684c368ef73522d6f29101cc1f319473624556a

data/bin/async-service

@@ -1,6 +1,7 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
-require 'async/service'
+require "async/service"
 
 configuration = Async::Service::Configuration.load
 Async::Service::Controller.run(configuration)

data/lib/async/service/configuration.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2024, by Samuel Williams.
+# Copyright, 2024-2025, by Samuel Williams.
 
-require_relative 'loader'
-require_relative 'generic'
-require_relative 'controller'
+require_relative "loader"
+require_relative "generic"
+require_relative "controller"
 
 module Async
 	module Service
@@ -47,16 +47,27 @@ module Async
 				@environments.empty?
 			end
 			
+			# Enumerate all services in the configuration.
+			#
+			# A service is an environment that has a `service_class` key.
+			#
+			# @parameter implementing [Module] If specified, only services implementing this module will be returned/yielded.
+			# @yields {|service| ...} Each service in the configuration.
 			def services(implementing: nil)
 				return to_enum(:services, implementing: implementing) unless block_given?
 				
 				@environments.each do |environment|
-					next if implementing and environment.implements?(implementing)
-					
-					yield Generic.wrap(environment)
+					if implementing.nil? or environment.implements?(implementing)
+						if service = Generic.wrap(environment)
+							yield service
+						end
+					end
 				end
 			end
 			
+			# Create a controller for the configured services.
+			#
+			# @returns [Controller] A controller that can be used to start/stop services.
 			def controller(**options)
 				Controller.new(self.services(**options).to_a)
 			end

data/lib/async/service/controller.rb

@@ -1,16 +1,16 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2024, by Samuel Williams.
+# Copyright, 2024-2025, by Samuel Williams.
 
-require 'async/container/controller'
+require "async/container/controller"
 
 module Async
 	module Service
 		class Controller < Async::Container::Controller
 			def self.warmup
 				begin
-					require 'bundler'
+					require "bundler"
 					Bundler.require(:preload)
 				rescue Bundler::GemfileNotFound, LoadError
 					# Ignore.

data/lib/async/service/environment.rb

@@ -67,6 +67,10 @@ module Async
 						@facet.define_method(name){argument}
 					end
 				end
+				
+				def respond_to_missing?(name, include_private = false)
+					true
+				end
 			end
 			
 			def self.build(...)

data/lib/async/service/generic.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2024, by Samuel Williams.
+# Copyright, 2024-2025, by Samuel Williams.
 
 module Async
 	module Service
@@ -12,11 +12,14 @@ module Async
 		class Generic
 			# Convert the given environment into a service if possible.
 			# @parameter environment [Build::Environment] The environment to use to construct the service.
+			# @returns [Generic | Nil] The constructed service if the environment specifies a service class.
 			def self.wrap(environment)
 				evaluator = environment.evaluator
 				
-				if service_class = evaluator.service_class || self
-					return service_class.new(environment, evaluator)
+				if evaluator.key?(:service_class)
+					if service_class = evaluator.service_class
+						return service_class.new(environment, evaluator)
+					end
 				end
 			end
 			

data/lib/async/service/loader.rb

@@ -1,13 +1,13 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2024, by Samuel Williams.
+# Copyright, 2024-2025, by Samuel Williams.
 
-require_relative 'environment'
+require_relative "environment"
 
 module Async
 	module Service
-	# The domain specific language for loading configuration files.
+		# The domain specific language for loading configuration files.
 		class Loader
 			# Initialize the loader, attached to a specific configuration instance.
 			# Any environments generated by the loader will be added to the configuration.
@@ -47,11 +47,14 @@ module Async
 				Environment.build(**initial, &block)
 			end
 			
-			# Define a host with the specified name.
-			# Adds `root` and `authority` keys.
+			# Define a service with the specified name.
+			# Adds `root` and `name` keys.
 			# @parameter name [String] The name of the environment, usually a hostname.
-			def service(name, &block)
-				@configuration.add(self.environment(name: name, root: @root, &block))
+			def service(name = nil, **options, &block)
+				options[:name] = name
+				options[:root] ||= @root
+				
+				@configuration.add(self.environment(**options, &block))
 			end
 		end
 	end

data/lib/async/service/version.rb

@@ -5,6 +5,6 @@
 
 module Async
 	module Service
-		VERSION = "0.12.0"
+		VERSION = "0.13.0"
 	end
 end

data/lib/async/service.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2024, by Samuel Williams.
+# Copyright, 2024-2025, by Samuel Williams.
 
-require_relative 'service/configuration'
-require_relative 'service/controller'
-require_relative 'service/version'
+require_relative "service/configuration"
+require_relative "service/controller"
+require_relative "service/version"

data/license.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright, 2024, by Samuel Williams.  
+Copyright, 2024-2025, by Samuel Williams.  
 
 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

@@ -16,8 +16,8 @@ We welcome contributions to this project.
 
 ### 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.
+In order to protect users of this project, we require all contributors to comply with the [Developer Certificate of Origin](https://developercertificate.org/). This ensures that all contributions are properly licensed and attributed.
 
-### Contributor Covenant
+### Community Guidelines
 
-This project is governed by the [Contributor Covenant](https://www.contributor-covenant.org/). All contributors and participants agree to abide by its terms.
+This project is best served by a collaborative and respectful environment. Treat each other professionally, respect differing viewpoints, and engage constructively. Harassment, discrimination, or harmful behavior is not tolerated. Communicate clearly, listen actively, and support one another. If any issues arise, please inform the project maintainers.

metadata

@@ -1,11 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: async-service
 version: !ruby/object:Gem::Version
-  version: 0.12.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Samuel Williams
-autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -37,7 +36,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-04-07 00:00:00.000000000 Z
+date: 2025-03-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -67,8 +66,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.16'
-description:
-email:
 executables:
 - async-service
 extensions: []
@@ -89,7 +86,7 @@ licenses:
 - MIT
 metadata:
   documentation_uri: https://socketry.github.io/async-service/
-post_install_message:
+  source_code_uri: https://github.com/socketry/async-service.git
 rdoc_options: []
 require_paths:
 - lib
@@ -97,15 +94,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: A service layer for Async.
 test_files: []