Sha256: 076e0d7b15f72b0b7cfbcadb022db68646e5da4a0e5f4ad99efb4d317c829653

Contents?: true

Size: 1.67 KB

Versions: 11

Compression:

Stored size: 1.67 KB

Contents

# frozen_string_literal: true

require "set"

module Dry
  module Core
    # Define extensions that can be later enabled by the user.
    #
    # @example
    #
    #   class Foo
    #     extend Dry::Core::Extensions
    #
    #     register_extension(:bar) do
    #        def bar; :bar end
    #     end
    #   end
    #
    #   Foo.new.bar # => NoMethodError
    #   Foo.load_extensions(:bar)
    #   Foo.new.bar # => :bar
    #
    module Extensions
      # @api private
      def self.extended(obj)
        super
        obj.instance_variable_set(:@__available_extensions__, {})
        obj.instance_variable_set(:@__loaded_extensions__, Set.new)
      end

      # Register an extension
      #
      # @param [Symbol] name extension name
      # @yield extension block. This block guaranteed not to be called more than once
      def register_extension(name, &block)
        @__available_extensions__[name] = block
      end

      # Whether an extension is available
      #
      # @param [Symbol] name extension name
      # @return [Boolean] Extension availability
      def available_extension?(name)
        @__available_extensions__.key?(name)
      end

      # Enables specified extensions. Already enabled extensions remain untouched
      #
      # @param [Array<Symbol>] extensions list of extension names
      def load_extensions(*extensions)
        extensions.each do |ext|
          block = @__available_extensions__.fetch(ext) do
            raise ArgumentError, "Unknown extension: #{ext.inspect}"
          end
          unless @__loaded_extensions__.include?(ext)
            block.call
            @__loaded_extensions__ << ext
          end
        end
      end
    end
  end
end

Version data entries

11 entries across 11 versions & 1 rubygems

Version Path
dry-core-1.0.2 lib/dry/core/extensions.rb
dry-core-1.0.1 lib/dry/core/extensions.rb
dry-core-1.0.0 lib/dry/core/extensions.rb
dry-core-0.9.1 lib/dry/core/extensions.rb
dry-core-0.9.0 lib/dry/core/extensions.rb
dry-core-0.8.1 lib/dry/core/extensions.rb
dry-core-0.8.0 lib/dry/core/extensions.rb
dry-core-0.7.1 lib/dry/core/extensions.rb
dry-core-0.7.0 lib/dry/core/extensions.rb
dry-core-0.6.0 lib/dry/core/extensions.rb
dry-core-0.5.0 lib/dry/core/extensions.rb