dry-system 1.0.1 → 1.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6d867a0c8708ea863edb44b5f93453c5d986925c921af51d747b605d6f4d3bbb
-  data.tar.gz: 1ee2e7a02c48bd9feb02a018aea1c81f59a5bda1ca7351d62a008162a62d1471
+  metadata.gz: f6e2bd6b5eeb03f260f1bf95def5a6dd7b1a419aa2e57301805fc37f43ffa08c
+  data.tar.gz: 18d1e11ad33a6e725b3eb049662957652120edcc2ce5da31847d13f511df65d8
 SHA512:
-  metadata.gz: 75e76f0ff522306b18b38c17c4bdfdae39280cbf4507beff3233bfc7cd10af752de605d0af619b6528a237f6860a4baee3754afedd890d66d50ac54a2880b4bf
-  data.tar.gz: aa31996c109cee9a6b05f61b127d7b9a6ec04cc30fe2e10ecf3f14f8948b2c34be7e687ec6ba6565bd06b9874816cf33d150a5b7499c9e125540e920159a7531
+  metadata.gz: b80e0a016030c542c963155140f30d15eb62c463c29ed1ba94d79378371fd11d2f2a7c4ea13cd0c11bbea3210cda2262cacde67ce9f8c50412e25a98c292a3a7
+  data.tar.gz: 35473d55c1434e8427c1d297868d65d2a31c2ebf559c50618712e97293f0d1c8ecd726945a94e4bde6bcbcfd7ef50837590f5e36c4a3a8396d52bce99a988e80

data/CHANGELOG.md

@@ -1,5 +1,102 @@
 <!--- DO NOT EDIT THIS FILE - IT'S AUTOMATICALLY GENERATED VIA DEVTOOLS --->
 
+## 1.2.3 2025-07-29
+
+
+### Fixed
+
+- Re-register components from manifest registrars in apps that reload the container (e.g. when
+using dry-rails and Rails development mode) (via #286, @alassek)
+
+
+[Compare v1.2.2...v1.2.3](https://github.com/dry-rb/dry-system/compare/v1.2.2...v1.2.3)
+
+## 1.2.2 2025-01-31
+
+
+### Fixed
+
+- Syntax errors on 3.3.0 (@flash-gordon, see #284)
+
+
+[Compare v1.2.1...v1.2.2](https://github.com/dry-rb/dry-system/compare/v1.2.1...v1.2.2)
+
+## 1.2.1 2025-01-08
+
+
+### Fixed
+
+- `eager_load` was removed from `finalize!`. It was introduced with `true` by default that
+wasn't the intention #281 (via #282) (@flash-gordon)
+
+
+[Compare v1.2.0...v1.2.1](https://github.com/dry-rb/dry-system/compare/v1.2.0...v1.2.1)
+
+## 1.2.0 2025-01-07
+
+
+### Added
+
+- Option to skip eager loading during finalize with `eager_load: false` (via #276) (@cllns)
+
+### Changed
+
+- Update required Ruby version to 3.1 (@flash-gordon)
+
+[Compare v1.1.1...v1.2.0](https://github.com/dry-rb/dry-system/compare/v1.1.1...v1.2.0)
+
+## 1.1.1 2024-11-03
+
+
+### Fixed
+
+- Restore `ProviderRegistrar#find_and_load_provider` as an alias of `#[]`
+
+
+[Compare v1.1.0...v1.1.1](https://github.com/dry-rb/dry-system/compare/v1.1.0...v1.1.1)
+
+## 1.1.0 2024-10-31
+
+
+
+[Compare v1.1.0.beta2...v1.1.0](https://github.com/dry-rb/dry-system/compare/v1.1.0.beta2...v1.1.0)
+
+## 1.1.0.beta2 2024-09-25
+
+
+### Changed
+
+- Allow provider sources to use a custom superclass. This requires a custom provider registrar
+to be configured, with its own implementations of `#provider_source_class` (the superclass to
+use) and `#provider_source_options` (custom initialization args to pass to the provider
+source). (via #275) (@alassek, @timriley)
+
+[Compare v1.1.0.beta1...v1.1.0.beta2](https://github.com/dry-rb/dry-system/compare/v1.1.0.beta1...v1.1.0.beta2)
+
+## 1.1.0.beta1 2024-07-03
+
+
+### Added
+
+- Add `Dry::System::ProviderRegistrar#target_container`, to be passed when initializing
+providers. By default this is an alias of `#container`. This allows for custom provider
+registrars to override `#target_container` to provide a custom `#target` within providers.
+An overridden value **MUST** still wrap the original `#target_container` to ensure components
+are registered in the right place. (via #270) (@timriley)
+
+### Changed
+
+- Make `Dry::System::ProviderRegistrar` public API (via #270) (@timriley)
+- When registering a provider source, you can now provide a `provider_options:` hash of default
+options for providers to be registered using that source. The one provider option currently
+supported is `namespace:`. (via #271) (@timriley)
+- Load providers when accessing them via `Dry::System::ProviderRegistrar#[]`. The previous,
+behavior of `#[]` returning `nil` if a provider had not been explicitly loaded was a
+potential source of confusion. Now `#[]` can serve as the one and only interface for fetching
+a provider. (via #273) (@timriley)
+
+[Compare v1.0.1...v1.1.0.beta1](https://github.com/dry-rb/dry-system/compare/v1.0.1...v1.1.0.beta1)
+
 ## 1.0.1 2022-11-18
 
 

data/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015-2022 dry-rb team
+Copyright (c) 2015-2023 dry-rb team
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

data/README.md

@@ -1,29 +1,22 @@
 <!--- this file is synced from dry-rb/template-gem project -->
+
 [gem]: https://rubygems.org/gems/dry-system
 [actions]: https://github.com/dry-rb/dry-system/actions
-[codacy]: https://www.codacy.com/gh/dry-rb/dry-system
-[chat]: https://dry-rb.zulipchat.com
-[inchpages]: http://inch-ci.org/github/dry-rb/dry-system
-
-# dry-system [![Join the chat at https://dry-rb.zulipchat.com](https://img.shields.io/badge/dry--rb-join%20chat-%23346b7a.svg)][chat]
 
-[![Gem Version](https://badge.fury.io/rb/dry-system.svg)][gem]
-[![CI Status](https://github.com/dry-rb/dry-system/workflows/ci/badge.svg)][actions]
-[![Codacy Badge](https://api.codacy.com/project/badge/Grade/3a0e30d0ae2542c7ba047ba5f923c0bb)][codacy]
-[![Codacy Badge](https://api.codacy.com/project/badge/Coverage/3a0e30d0ae2542c7ba047ba5f923c0bb)][codacy]
-[![Inline docs](http://inch-ci.org/github/dry-rb/dry-system.svg?branch=main)][inchpages]
+# dry-system [![Gem Version](https://badge.fury.io/rb/dry-system.svg)][gem] [![CI Status](https://github.com/dry-rb/dry-system/workflows/CI/badge.svg)][actions]
 
 ## Links
 
 * [User documentation](https://dry-rb.org/gems/dry-system)
 * [API documentation](http://rubydoc.info/gems/dry-system)
+* [Forum](https://discourse.dry-rb.org)
 
 ## Supported Ruby versions
 
 This library officially supports the following Ruby versions:
 
-* MRI `>= 2.7.0`
-* jruby `>= 9.3` (postponed until 2.7 is supported)
+* MRI `>= 3.1`
+* jruby `>= 9.4` (not tested on CI)
 
 ## License
 

data/dry-system.gemspec

@@ -21,20 +21,17 @@ Gem::Specification.new do |spec|
   spec.executables   = []
   spec.require_paths = ["lib"]
 
-  spec.metadata["allowed_push_host"] = "https://rubygems.org"
-  spec.metadata["changelog_uri"]     = "https://github.com/dry-rb/dry-system/blob/main/CHANGELOG.md"
-  spec.metadata["source_code_uri"]   = "https://github.com/dry-rb/dry-system"
-  spec.metadata["bug_tracker_uri"]   = "https://github.com/dry-rb/dry-system/issues"
+  spec.metadata["allowed_push_host"]     = "https://rubygems.org"
+  spec.metadata["changelog_uri"]         = "https://github.com/dry-rb/dry-system/blob/main/CHANGELOG.md"
+  spec.metadata["source_code_uri"]       = "https://github.com/dry-rb/dry-system"
+  spec.metadata["bug_tracker_uri"]       = "https://github.com/dry-rb/dry-system/issues"
+  spec.metadata["rubygems_mfa_required"] = "true"
 
-  spec.required_ruby_version = ">= 2.7.0"
+  spec.required_ruby_version = ">= 3.1"
 
   # to update dependencies edit project.yml
-  spec.add_runtime_dependency "dry-auto_inject", "~> 1.0", "< 2"
-  spec.add_runtime_dependency "dry-configurable", "~> 1.0", "< 2"
-  spec.add_runtime_dependency "dry-core", "~> 1.0", "< 2"
-  spec.add_runtime_dependency "dry-inflector", "~> 1.0", "< 2"
-
-  spec.add_development_dependency "bundler"
-  spec.add_development_dependency "rake"
-  spec.add_development_dependency "rspec"
+  spec.add_dependency "dry-auto_inject", "~> 1.1"
+  spec.add_dependency "dry-configurable", "~> 1.3"
+  spec.add_dependency "dry-core", "~> 1.1"
+  spec.add_dependency "dry-inflector", "~> 1.1"
 end

data/lib/dry/system/component.rb

@@ -60,10 +60,9 @@ module Dry
       #
       # @return [Object] component's class instance
       # @api public
-      def instance(*args)
-        options[:instance]&.call(self, *args) || loader.call(self, *args)
+      def instance(*args, **kwargs)
+        options[:instance]&.call(self, *args, **kwargs) || loader.call(self, *args, **kwargs)
       end
-      ruby2_keywords(:instance) if respond_to?(:ruby2_keywords, true)
 
       # Returns the component's unique key
       #

data/lib/dry/system/component_dir.rb

@@ -76,13 +76,13 @@ module Dry
 
       def files(namespace)
         if namespace.path?
-          Dir[File.join(full_path, namespace.path, "**", RB_GLOB)].sort
+          ::Dir[::File.join(full_path, namespace.path, "**", RB_GLOB)]
         else
           non_root_paths = config.namespaces.to_a.reject(&:root?).map(&:path)
 
-          Dir[File.join(full_path, "**", RB_GLOB)].reject { |file_path|
+          ::Dir[::File.join(full_path, "**", RB_GLOB)].reject { |file_path|
             Pathname(file_path).relative_path_from(full_path).to_s.start_with?(*non_root_paths)
-          }.sort
+          }
         end
       end
 
@@ -155,9 +155,9 @@ module Dry
         }
       end
 
-      def method_missing(name, *args, &block)
+      def method_missing(name, ...)
         if config.respond_to?(name)
-          config.public_send(name, *args, &block)
+          config.public_send(name, ...)
         else
           super
         end

data/lib/dry/system/config/component_dir.rb

@@ -7,7 +7,7 @@ module Dry
     module Config
       # @api public
       class ComponentDir
-        include Dry::Configurable
+        include ::Dry::Configurable
 
         # @!group Settings
 
@@ -211,9 +211,9 @@ module Dry
 
         private
 
-        def method_missing(name, *args, &block)
+        def method_missing(name, ...)
           if config.respond_to?(name)
-            config.public_send(name, *args, &block)
+            config.public_send(name, ...)
           else
             super
           end

data/lib/dry/system/config/component_dirs.rb

@@ -110,7 +110,7 @@ module Dry
 
         # @api private
         def initialize_copy(source)
-          @dirs = source.dirs.map { |path, dir| [path, dir.dup] }.to_h
+          @dirs = source.dirs.to_h { |path, dir| [path, dir.dup] }
           @defaults = source.defaults.dup
         end
 
@@ -221,8 +221,8 @@ module Dry
         # @yieldparam dir [ComponentDir] the yielded component dir
         #
         # @api public
-        def each(&block)
-          to_a.each(&block)
+        def each(&)
+          to_a.each(&)
         end
 
         protected
@@ -272,9 +272,9 @@ module Dry
           end
         end
 
-        def method_missing(name, *args, &block)
+        def method_missing(name, ...)
           if defaults.respond_to?(name)
-            defaults.public_send(name, *args, &block)
+            defaults.public_send(name, ...)
           else
             super
           end

data/lib/dry/system/config/namespaces.rb

@@ -187,8 +187,8 @@ module Dry
         # @yieldparam namespace [Namespace] the yielded namespace
         #
         # @api public
-        def each(&block)
-          to_a.each(&block)
+        def each(&)
+          to_a.each(&)
         end
       end
     end

data/lib/dry/system/constants.rb

@@ -8,6 +8,6 @@ module Dry
     RB_GLOB = "*.rb"
     PATH_SEPARATOR = File::SEPARATOR
     KEY_SEPARATOR = "."
-    WORD_REGEX = /\w+/.freeze
+    WORD_REGEX = /\w+/
   end
 end

data/lib/dry/system/container.rb

@@ -103,8 +103,8 @@ module Dry
         # @see after
         #
         # @api public
-        def configure(finalize_config: true, &block)
-          super(&block)
+        def configure(finalize_config: true, &)
+          super(&)
           configured!(finalize_config: finalize_config)
         end
 
@@ -148,7 +148,7 @@ module Dry
         #
         # @example
         #   # system/container.rb
-        #   require "dry/system/container"
+        #   require "dry/system"
         #   require "logger"
         #
         #   class Core < Dry::System::Container
@@ -314,23 +314,21 @@ module Dry
         # @return [self] frozen container
         #
         # @api public
-        def finalize!(freeze: true, &block)
+        def finalize!(freeze: true, &)
           return self if finalized?
 
           configured!
 
-          hooks[:before_finalize].each { |hook| instance_eval(&hook) }
-          yield(self) if block
+          run_hooks(:finalize) do
+            yield(self) if block_given?
 
-          providers.finalize!
-          auto_registrar.finalize!
-          manifest_registrar.finalize!
-          importer.finalize!
+            [providers, auto_registrar, manifest_registrar, importer].each(&:finalize!)
 
-          @__finalized__ = true
+            @__finalized__ = true
+          end
 
           self.freeze if freeze
-          hooks[:after_finalize].each { |hook| instance_eval(&hook) }
+
           self
         end
 
@@ -462,7 +460,7 @@ module Dry
         # @api public
         def require_from_root(*paths)
           paths.flat_map { |path|
-            path.to_s.include?("*") ? ::Dir[root.join(path)].sort : root.join(path)
+            path.to_s.include?("*") ? ::Dir[root.join(path)] : root.join(path)
           }.each { |path|
             Kernel.require path.to_s
           }
@@ -486,6 +484,15 @@ module Dry
           config.root
         end
 
+        # @api public
+        def register(key, *)
+          super
+
+          hooks[:after_register].each { |hook| instance_exec(key, &hook) }
+
+          self
+        end
+
         # @api public
         def resolve(key)
           load_component(key) unless finalized?
@@ -608,22 +615,22 @@ module Dry
         def load_component(key)
           return self if registered?(key)
 
-          if (provider = providers.find_and_load_provider(key))
+          if (provider = providers[key])
             provider.start
             return self
           end
 
           component = find_component(key)
 
-          providers.start_provider_dependency(component)
+          providers[component.root_key]&.start
           return self if registered?(key)
 
           if component.loadable?
             load_local_component(component)
           elsif manifest_registrar.file_exists?(component)
             manifest_registrar.(component)
-          elsif importer.namespace?(component.identifier.root_key)
-            load_imported_component(component.identifier, namespace: component.identifier.root_key)
+          elsif importer.namespace?(component.root_key)
+            load_imported_component(component.identifier, namespace: component.root_key)
           elsif importer.namespace?(nil)
             load_imported_component(component.identifier, namespace: nil)
           end
@@ -659,6 +666,12 @@ module Dry
             end
           } || IndirectComponent.new(Identifier.new(key))
         end
+
+        def run_hooks(event)
+          hooks[:"before_#{event}"].each { instance_eval(&_1) }
+          yield
+          hooks[:"after_#{event}"].each { instance_eval(&_1) }
+        end
       end
 
       # Default hooks

data/lib/dry/system/errors.rb

@@ -125,7 +125,7 @@ module Dry
           end
         end
 
-        super message.join("\n")
+        super(message.join("\n"))
       end
     end
   end

data/lib/dry/system/loader.rb

@@ -43,18 +43,17 @@ module Dry
         # @return [Object]
         #
         # @api public
-        def call(component, *args)
+        def call(component, *args, **kwargs)
           require!(component)
 
           constant = self.constant(component)
 
           if singleton?(constant)
-            constant.instance(*args)
+            constant.instance(*args, **kwargs)
           else
-            constant.new(*args)
+            constant.new(*args, **kwargs)
           end
         end
-        ruby2_keywords(:call) if respond_to?(:ruby2_keywords, true)
 
         # Returns the component's class constant
         #
@@ -67,7 +66,7 @@ module Dry
           inflector.constantize(const_name)
         rescue NameError => e
           # Ensure it's this component's constant, not any other NameError within the component
-          if e.message =~ /#{const_name}( |\n)/
+          if e.message =~ /#{const_name}( |\n|$)/
             raise ComponentNotLoadableError.new(component, e)
           else
             raise e

data/lib/dry/system/magic_comments_parser.rb

@@ -3,8 +3,8 @@
 module Dry
   module System
     class MagicCommentsParser
-      VALID_LINE_RE = /^(#.*)?$/.freeze
-      COMMENT_RE = /^#\s+(?<name>[A-Za-z]{1}[A-Za-z0-9_]+):\s+(?<value>.+?)$/.freeze
+      VALID_LINE_RE = /^(#.*)?$/
+      COMMENT_RE = /^#\s+(?<name>[A-Za-z]{1}[A-Za-z0-9_]+):\s+(?<value>.+?)$/
 
       COERCIONS = {
         "true" => true,

data/lib/dry/system/manifest_registrar.rb

@@ -26,19 +26,19 @@ module Dry
 
       # @api private
       def finalize!
-        ::Dir[registrations_dir.join(RB_GLOB)].sort.each do |file|
+        ::Dir[registrations_dir.join(RB_GLOB)].each do |file|
           call(Identifier.new(File.basename(file, RB_EXT)))
         end
       end
 
       # @api private
       def call(component)
-        require(root.join(config.registrations_dir, component.root_key.to_s))
+        load(root.join(config.registrations_dir, "#{component.root_key}#{RB_EXT}"))
       end
 
       # @api private
       def file_exists?(component)
-        File.exist?(File.join(registrations_dir, "#{component.root_key}#{RB_EXT}"))
+        ::File.exist?(::File.join(registrations_dir, "#{component.root_key}#{RB_EXT}"))
       end
 
       private

data/lib/dry/system/plugins/bootsnap.rb

@@ -6,10 +6,8 @@ module Dry
       module Bootsnap
         DEFAULT_OPTIONS = {
           load_path_cache: true,
-          disable_trace: true,
           compile_cache_iseq: true,
-          compile_cache_yaml: true,
-          autoload_paths_cache: false
+          compile_cache_yaml: true
         }.freeze
 
         # @api private
@@ -32,12 +30,16 @@ module Dry
         def setup_bootsnap
           return unless bootsnap_available?
 
-          ::Bootsnap.setup(config.bootsnap.merge(cache_dir: root.join("tmp/cache").to_s))
+          ::Bootsnap.setup(**config.bootsnap, cache_dir: root.join("tmp/cache").to_s)
         end
 
         # @api private
         def bootsnap_available?
-          RUBY_ENGINE == "ruby" && RUBY_VERSION >= "2.3.0" && RUBY_VERSION < "3.1.0"
+          spec = Gem.loaded_specs["bootsnap"] or return false
+
+          RUBY_ENGINE == "ruby" &&
+            spec.match_platform(RUBY_PLATFORM) &&
+            spec.required_ruby_version.satisfied_by?(Gem::Version.new(RUBY_VERSION))
         end
       end
     end

data/lib/dry/system/plugins/dependency_graph/strategies.rb

@@ -20,7 +20,7 @@ module Dry
                 target_class: klass
               )
 
-              super(klass)
+              super
             end
           end
 
@@ -36,7 +36,7 @@ module Dry
                 target_class: klass
               )
 
-              super(klass)
+              super
             end
           end
 
@@ -51,7 +51,7 @@ module Dry
                 target_class: klass
               )
 
-              super(klass)
+              super
             end
           end
 

data/lib/dry/system/plugins/dependency_graph.rb

@@ -34,7 +34,7 @@ module Dry
         end
 
         # @api private
-        def register(key, contents = nil, options = {}, &block)
+        def register(key, contents = nil, options = {}, &)
           super.tap do
             key = key.to_s
 

data/lib/dry/system/plugins/monitoring.rb

@@ -30,13 +30,13 @@ module Dry
           resolve(key).tap do |target|
             proxy = Proxy.for(target, **options, key: key)
 
-            if block
+            if block_given?
               proxy.monitored_methods.each do |meth|
                 notifications.subscribe(:monitoring, target: key, method: meth, &block)
               end
             end
 
-            decorate(key, with: -> target { proxy.new(target, notifications) })
+            decorate(key, with: -> tgt { proxy.new(tgt, notifications) })
           end
         end
       end

data/lib/dry/system/plugins.rb

@@ -11,8 +11,8 @@ module Dry
       # @return [Plugins]
       #
       # @api public
-      def self.register(name, plugin, &block)
-        registry[name] = Plugin.new(name, plugin, &block)
+      def self.register(name, plugin, &)
+        registry[name] = Plugin.new(name, plugin, &)
       end
 
       # @api private

data/lib/dry/system/provider/source.rb

@@ -37,11 +37,21 @@ module Dry
           # @see Dry::System::Provider::SourceDSL
           #
           # @api private
-          def for(name:, group: nil, &block)
-            Class.new(self) { |klass|
+          def for(name:, group: nil, superclass: nil, &block)
+            superclass ||= self
+
+            ::Class.new(superclass) { |klass|
               klass.source_name name
               klass.source_group group
-              SourceDSL.evaluate(klass, &block) if block
+
+              name_with_group = group ? "#{group}->#{name}" : name
+              klass.instance_eval(<<~RUBY, __FILE__, __LINE__ + 1)
+                def name                                   # def name
+                  "#{superclass.name}[#{name_with_group}]" #   "CustomSource[custom]"
+                end                                        # end
+              RUBY
+
+              SourceDSL.evaluate(klass, &block) if block_given?
             }
           end
 
@@ -58,14 +68,6 @@ module Dry
             end
           end
 
-          # @api private
-          def name
-            source_str = source_name
-            source_str = "#{source_group}->#{source_str}" if source_group
-
-            "Dry::System::Provider::Source[#{source_str}]"
-          end
-
           # @api private
           def to_s
             "#<#{name}>"
@@ -117,15 +119,18 @@ module Dry
         #
         # @api public
         attr_reader :target_container
-        alias_method :target, :target_container
+
+        # @see #target_container
+        # @api public
+        def target = target_container
 
         # @api private
-        def initialize(provider_container:, target_container:, &block)
+        def initialize(provider_container:, target_container:, &)
           super()
           @callbacks = {before: CALLBACK_MAP.dup, after: CALLBACK_MAP.dup}
           @provider_container = provider_container
           @target_container = target_container
-          instance_exec(&block) if block
+          instance_exec(&) if block_given?
         end
 
         # Returns a string containing a human-readable representation of the provider.
@@ -258,7 +263,7 @@ module Dry
         end
 
         # @api private
-        def method_missing(name, *args, &block)
+        def method_missing(name, *args, &)
           if container.key?(name)
             container[name]
           else

data/lib/dry/system/provider/source_dsl.rb

@@ -10,8 +10,8 @@ module Dry
       #
       # @api private
       class SourceDSL
-        def self.evaluate(source_class, &block)
-          new(source_class).instance_eval(&block)
+        def self.evaluate(source_class, &)
+          new(source_class).instance_eval(&)
         end
 
         attr_reader :source_class
@@ -24,23 +24,23 @@ module Dry
           source_class.setting(...)
         end
 
-        def prepare(&block)
-          source_class.define_method(:prepare, &block)
+        def prepare(&)
+          source_class.define_method(:prepare, &)
         end
 
-        def start(&block)
-          source_class.define_method(:start, &block)
+        def start(&)
+          source_class.define_method(:start, &)
         end
 
-        def stop(&block)
-          source_class.define_method(:stop, &block)
+        def stop(&)
+          source_class.define_method(:stop, &)
         end
 
         private
 
-        def method_missing(name, *args, &block)
+        def method_missing(name, ...)
           if source_class.respond_to?(name)
-            source_class.public_send(name, *args, &block)
+            source_class.public_send(name, ...)
           else
             super
           end

data/lib/dry/system/provider.rb

@@ -127,7 +127,8 @@ module Dry
       attr_reader :source
 
       # @api private
-      def initialize(name:, namespace: nil, target_container:, source_class:, &block) # rubocop:disable Style/KeywordParametersOrder
+      # rubocop:disable Style/KeywordParametersOrder
+      def initialize(name:, namespace: nil, target_container:, source_class:, source_options: {}, &)
         @name = name
         @namespace = namespace
         @target_container = target_container
@@ -137,11 +138,13 @@ module Dry
         @step_running = nil
 
         @source = source_class.new(
+          **source_options,
           provider_container: provider_container,
           target_container: target_container,
-          &block
+          &
         )
       end
+      # rubocop:enable Style/KeywordParametersOrder
 
       # Runs the `prepare` lifecycle step.
       #

data/lib/dry/system/provider_registrar.rb

@@ -13,7 +13,8 @@ module Dry
     # provider registrar is responsible for loading provider files and exposing an API for
     # running the provider lifecycle steps.
     #
-    # @api private
+    # @api public
+    # @since 1.1.0
     class ProviderRegistrar
       # @api private
       attr_reader :providers
@@ -21,6 +22,14 @@ module Dry
       # @api private
       attr_reader :container
 
+      # Returns the container exposed to providers as `target_container`.
+      #
+      # @return [Dry::System::Container]
+      #
+      # @api public
+      # @since 1.1.0
+      alias_method :target_container, :container
+
       # @api private
       def initialize(container)
         @providers = {}
@@ -37,14 +46,14 @@ module Dry
 
       # @see Container.register_provider
       # @api private
-      def register_provider(name, namespace: nil, from: nil, source: nil, if: true, &block)
+      def register_provider(name, from: nil, source: nil, if: true, **provider_options, &)
         raise ProviderAlreadyRegisteredError, name if providers.key?(name)
 
         if from && source.is_a?(Class)
           raise ArgumentError, "You must supply a block when using a provider source"
         end
 
-        if block && source.is_a?(Class)
+        if block_given? && source.is_a?(Class)
           raise ArgumentError, "You must supply only a `source:` option or a block, not both"
         end
 
@@ -54,13 +63,18 @@ module Dry
           if from
             build_provider_from_source(
               name,
-              namespace: namespace,
               source: source || name,
               group: from,
-              &block
+              options: provider_options,
+              &
             )
           else
-            build_provider(name, namespace: namespace, source: source, &block)
+            build_provider(
+              name,
+              source: source,
+              options: provider_options,
+              &
+            )
           end
 
         providers[provider.name] = provider
@@ -70,43 +84,31 @@ module Dry
 
       # rubocop:enable Metrics/PerceivedComplexity
 
-      # Returns a provider for the given name, if it has already been loaded
-      #
-      # @api public
-      def [](provider_name)
-        providers[provider_name]
-      end
-      alias_method :provider, :[]
-
-      # @api private
-      def key?(provider_name)
-        providers.key?(provider_name)
-      end
-
       # Returns a provider if it can be found or loaded, otherwise nil
       #
       # @return [Dry::System::Provider, nil]
       #
-      # @api private
-      def find_and_load_provider(name)
-        name = name.to_sym
+      # @api public
+      def [](provider_name)
+        provider_name = provider_name.to_sym
 
-        if (provider = providers[name])
+        if (provider = providers[provider_name])
           return provider
         end
 
         return if finalized?
 
-        require_provider_file(name)
+        require_provider_file(provider_name)
 
-        providers[name]
+        providers[provider_name]
       end
 
+      # @api public
+      alias_method :find_and_load_provider, :[]
+
       # @api private
-      def start_provider_dependency(component)
-        if (provider = find_and_load_provider(component.root_key))
-          provider.start
-        end
+      def key?(provider_name)
+        providers.key?(provider_name)
       end
 
       # Returns all provider files within the configured provider_paths.
@@ -124,10 +126,10 @@ module Dry
       # @api public
       def provider_files
         @provider_files ||= provider_paths.each_with_object([[], []]) { |path, (provider_files, loaded)| # rubocop:disable Layout/LineLength
-          files = Dir["#{path}/#{RB_GLOB}"].sort
+          files = ::Dir["#{path}/#{RB_GLOB}"]
 
           files.each do |file|
-            basename = File.basename(file)
+            basename = ::File.basename(file)
 
             unless loaded.include?(basename)
               provider_files << Pathname(file)
@@ -137,6 +139,21 @@ module Dry
         }.first
       end
 
+      # Extension point for subclasses to customize their
+      # provider source superclass. Expected to be a subclass
+      # of Dry::System::Provider::Source
+      #
+      # @api public
+      # @since 1.1.0
+      def provider_source_class = Dry::System::Provider::Source
+
+      # Extension point for subclasses to customize initialization
+      # params for provider_source_class
+      #
+      # @api public
+      # @since 1.1.0
+      def provider_source_options = {}
+
       # @api private
       def finalize!
         provider_files.each do |path|
@@ -196,26 +213,47 @@ module Dry
         }
       end
 
-      def build_provider(name, namespace:, source: nil, &block)
-        source_class = source || Provider::Source.for(name: name, &block)
+      def build_provider(name, options:, source: nil, &)
+        source_class = source || Provider::Source.for(
+          name: name,
+          superclass: provider_source_class,
+          &
+        )
+
+        source_options =
+          if source_class < provider_source_class
+            provider_source_options
+          else
+            {}
+          end
 
         Provider.new(
+          **options,
           name: name,
-          namespace: namespace,
-          target_container: container,
-          source_class: source_class
+          target_container: target_container,
+          source_class: source_class,
+          source_options: source_options
         )
       end
 
-      def build_provider_from_source(name, source:, group:, namespace:, &block)
-        source_class = System.provider_sources.resolve(name: source, group: group)
+      def build_provider_from_source(name, source:, group:, options:, &)
+        provider_source = System.provider_sources.resolve(name: source, group: group)
+
+        source_options =
+          if provider_source.source <= provider_source_class
+            provider_source_options
+          else
+            {}
+          end
 
         Provider.new(
+          **provider_source.provider_options,
+          **options,
           name: name,
-          namespace: namespace,
-          target_container: container,
-          source_class: source_class,
-          &block
+          target_container: target_container,
+          source_class: provider_source.source,
+          source_options: source_options,
+          &
         )
       end
 

data/lib/dry/system/provider_source_registry.rb

@@ -6,6 +6,17 @@ module Dry
   module System
     # @api private
     class ProviderSourceRegistry
+      # @api private
+      class Registration
+        attr_reader :source
+        attr_reader :provider_options
+
+        def initialize(source:, provider_options:)
+          @source = source
+          @provider_options = provider_options
+        end
+      end
+
       attr_reader :sources
 
       def initialize
@@ -13,24 +24,24 @@ module Dry
       end
 
       def load_sources(path)
-        Dir[File.join(path, "**/#{RB_GLOB}")].sort.each do |file|
+        ::Dir[::File.join(path, "**/#{RB_GLOB}")].each do |file|
           require file
         end
       end
 
-      def register(name:, group:, source:)
-        sources[key(name, group)] = source
+      def register(name:, group:, source:, provider_options:)
+        sources[key(name, group)] = Registration.new(
+          source: source,
+          provider_options: provider_options
+        )
       end
 
-      def register_from_block(name:, group:, &block)
+      def register_from_block(name:, group:, provider_options:, &)
         register(
           name: name,
           group: group,
-          source: Provider::Source.for(
-            name: name,
-            group: group,
-            &block
-          )
+          source: Provider::Source.for(name: name, group: group, &),
+          provider_options: provider_options
         )
       end
 

data/lib/dry/system/provider_sources/settings/config.rb

@@ -55,9 +55,9 @@ module Dry
 
           private
 
-          def method_missing(name, *args, &block)
+          def method_missing(name, ...)
             if config.respond_to?(name)
-              config.public_send(name, *args, &block)
+              config.public_send(name, ...)
             else
               super
             end

data/lib/dry/system/provider_sources.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "pathname"
 require "dry/system"
 
 Dry::System.register_provider_sources Pathname(__dir__).join("provider_sources").realpath

data/lib/dry/system/stubs.rb

@@ -11,8 +11,8 @@ module Dry
         # of the container
         #
         # @api private
-        def finalize!(**, &block)
-          super(freeze: false, &block)
+        def finalize!(**, &)
+          super(freeze: false, &)
         end
       end
 

data/lib/dry/system/version.rb

@@ -2,6 +2,6 @@
 
 module Dry
   module System
-    VERSION = "1.0.1"
+    VERSION = "1.2.3"
   end
 end

data/lib/dry/system.rb

@@ -30,15 +30,25 @@ module Dry
     # Registers a provider source, which can be used as the basis for other providers
     #
     # @api public
-    def self.register_provider_source(name, group:, source: nil, &block)
-      if source && block
+    def self.register_provider_source(name, group:, source: nil, provider_options: {}, &)
+      if source && block_given?
         raise ArgumentError, "You must supply only a `source:` option or a block, not both"
       end
 
       if source
-        provider_sources.register(name: name, group: group, source: source)
+        provider_sources.register(
+          name: name,
+          group: group,
+          source: source,
+          provider_options: provider_options
+        )
       else
-        provider_sources.register_from_block(name: name, group: group, &block)
+        provider_sources.register_from_block(
+          name: name,
+          group: group,
+          provider_options: provider_options,
+          &
+        )
       end
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dry-system
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.2.3
 platform: ruby
 authors:
 - Piotr Solnica
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-11-18 00:00:00.000000000 Z
+date: 2025-07-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-auto_inject
@@ -16,122 +16,56 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '2'
+        version: '1.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '2'
+        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: dry-configurable
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '2'
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '2'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: dry-core
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '2'
+        version: '1.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '2'
+        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: dry-inflector
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '2'
+        version: '1.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '2'
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.1'
 description: Organize your code into reusable components
 email:
 - piotr.solnica@gmail.com
@@ -193,7 +127,8 @@ metadata:
   changelog_uri: https://github.com/dry-rb/dry-system/blob/main/CHANGELOG.md
   source_code_uri: https://github.com/dry-rb/dry-system
   bug_tracker_uri: https://github.com/dry-rb/dry-system/issues
-post_install_message: 
+  rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -201,15 +136,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
-signing_key: 
+rubygems_version: 3.3.27
+signing_key:
 specification_version: 4
 summary: Organize your code into reusable components
 test_files: []