# frozen_string_literal: true

require 'set'

class Sinclair
  # @api public
  # @author Darthjee
  #
  # Base options class
  #
  # @example Options usage
  #   class ConnectionOptions < Sinclair::Options
  #     with_options :timeout, :retries, port: 443, protocol: 'https'
  #   end
  #
  #   options = ConnectionOptions.new(retries: 10, port: 8080)
  #
  #   options.timeout  # returns nil
  #   options.retries  # returns 10
  #   options.port     # returns 8080
  #   options.protocol # returns 'https'
  class Options
    autoload :Builder, 'sinclair/options/builder'

    class << self
      # @api private
      #
      # returns invalid options
      #
      # @return [Array<Symbol>]
      def invalid_options_in(names)
        names.map(&:to_sym) - allowed_options.to_a
      end

      # @api private
      #
      # Allow new option
      #
      # This does not create the method
      #
      # @param name [String,Symbol] options to be allowed
      #
      # @return [Set<Symbol>]
      def allow(name)
        allowed_options << name.to_sym
      end

      private

      # @api private
      # @private
      #
      # Options allowed when initializing options
      #
      # @return [Set<Symbol>]
      def allowed_options
        @allowed_options ||= build_allowed_options
      end

      # @api private
      # @private
      #
      # Build set of allowed options
      #
      # When class is descendent of {Options}
      # a duplication of it's parents allowed_options is
      # returned
      #
      # @return (see allowed_options)
      def build_allowed_options
        superclass.send(:allowed_options).dup
      rescue NoMethodError
        Set.new
      end

      # @api public
      # @!visibility public
      #
      # Add available options
      #
      # @example (see Options)
      #
      # @return (see Sinclair#build)
      #
      # @overload with_options(*options)
      #   @param options [Array<Symbol>] list of accepted
      #     options
      # @overload with_options(*options, **defaults)
      #   @param options [Array<Symbol>] list of accepted
      #     options
      #   @param defaults [Hash<Symbol,Object>] default options
      #     hash
      def with_options(*options)
        Builder.new(self, *options).build
      end
    end

    # @param options [Hash] hash with options (see {.options}, {.with_options})
    # @example (see Options)
    def initialize(options = {})
      check_options(options)

      options.each do |key, value|
        instance_variable_set("@#{key}", value)
      end
    end

    private

    # @private
    # @api private
    #
    # check if given options are allowed
    #
    # @raise Sinclair::Exception::InvalidOptions
    #
    # @return [NilClass]
    def check_options(options)
      invalid_keys = self.class.invalid_options_in(options.keys)

      return if invalid_keys.empty?

      raise Sinclair::Exception::InvalidOptions, invalid_keys
    end
  end
end