Contents

# frozen_string_literal: true

module ReSorcery
  # Configure `ReSorcery`: All configuration kept in one place
  #
  # `ReSorcery` has some values that can be configured by users. To keep such
  # configuration clear, and to prevent confusing behavior, `#configure` can
  # only be called once, and must be called before `include`ing `ReSorcery`.
  #
  # Example:
  #
  #     ReSorcery.configure do
  #       link_rels ['self', 'create', 'update']
  #       link_methods ['get', 'post', 'put']
  #     end
  #
  # @see `Configuration::CONFIGURABLES` for a list of what can be configured and
  # what value each configurable takes.
  #
  module Configuration
    extend Decoder::BuiltinDecoders

    CONFIGURABLES = {
      link_rels: array(String),
      link_methods: array(String),
    }.freeze

    def configuration
      @configuration ||= {}
    end

    def configure(&block)
      raise Error::InvalidConfigurationError, @configured if configured?

      @configured = "configured at #{caller_locations.first}"
      instance_exec(&block)
    end

    private

    def configured?
      @configured ||= false
    end

    CONFIGURABLES.each do |name, decoder|
      define_method(name) do |value|
        decoder.test(value).cata(
          ok: ->(v) { configuration[name] = v },
          err: ->(e) { raise Error::ArgumentError, "Error configuring `#{name}`: #{e}" },
        )
      end
    end
  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
re_sorcery-0.1.0	lib/re_sorcery/configuration.rb