cliqr 1.2.0 → 2.0.0

data/spec/validation/validation_spec.rb

@@ -2,10 +2,10 @@
 
 require 'spec_helper'
 
-describe Cliqr::ConfigValidation do
+describe Cliqr::Config::Validation do
   it 'does not know how to validate unknown types' do
     expect do
-      Cliqr::ConfigValidation::ValidatorFactory.get(:bla, {}).validate(nil, nil, nil)
+      Cliqr::Config::Validation::ValidatorFactory.get(:bla, {}).validate(nil, nil, nil)
     end.to raise_error(Cliqr::Error::UnknownValidatorType, "unknown validation type: 'bla'")
   end
 end

metadata

@@ -1,41 +1,41 @@
 --- !ruby/object:Gem::Specification
 name: cliqr
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Anshul Verma
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-06-18 00:00:00.000000000 Z
+date: 2015-07-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: log4r
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.1'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.6'
 description: |2
@@ -63,22 +63,36 @@ files:
 - lib/cliqr/argument_validation/argument_type_validator.rb
 - lib/cliqr/argument_validation/option_validator.rb
 - lib/cliqr/argument_validation/validator.rb
-- lib/cliqr/cli/argument_operator.rb
-- lib/cliqr/cli/argument_operator_context.rb
-- lib/cliqr/cli/command.rb
-- lib/cliqr/cli/command_context.rb
-- lib/cliqr/cli/command_runner_factory.rb
-- lib/cliqr/cli/config.rb
-- lib/cliqr/cli/executor.rb
-- lib/cliqr/cli/interface.rb
-- lib/cliqr/cli/router.rb
-- lib/cliqr/cli/shell_command.rb
-- lib/cliqr/cli/usage_builder.rb
-- lib/cliqr/config_validation/validation_set.rb
-- lib/cliqr/config_validation/validator_factory.rb
-- lib/cliqr/config_validation/verifiable.rb
-- lib/cliqr/dsl.rb
+- lib/cliqr/command/argument_operator.rb
+- lib/cliqr/command/argument_operator_context.rb
+- lib/cliqr/command/base_command.rb
+- lib/cliqr/command/color.rb
+- lib/cliqr/command/command_context.rb
+- lib/cliqr/command/shell_banner_builder.rb
+- lib/cliqr/command/shell_command.rb
+- lib/cliqr/command/shell_prompt_builder.rb
+- lib/cliqr/config/action.rb
+- lib/cliqr/config/base.rb
+- lib/cliqr/config/command.rb
+- lib/cliqr/config/dsl.rb
+- lib/cliqr/config/event.rb
+- lib/cliqr/config/event_based.rb
+- lib/cliqr/config/named.rb
+- lib/cliqr/config/option.rb
+- lib/cliqr/config/option_based.rb
+- lib/cliqr/config/shell.rb
+- lib/cliqr/config/validation/validation_set.rb
+- lib/cliqr/config/validation/validator_factory.rb
+- lib/cliqr/config/validation/verifiable.rb
 - lib/cliqr/error.rb
+- lib/cliqr/events/event.rb
+- lib/cliqr/events/event_context.rb
+- lib/cliqr/events/handler.rb
+- lib/cliqr/events/invoker.rb
+- lib/cliqr/executor/command_runner_factory.rb
+- lib/cliqr/executor/router.rb
+- lib/cliqr/executor/runner.rb
+- lib/cliqr/interface.rb
 - lib/cliqr/parser/action_token.rb
 - lib/cliqr/parser/argument_parser.rb
 - lib/cliqr/parser/argument_token.rb
@@ -90,6 +104,15 @@ files:
 - lib/cliqr/parser/single_valued_option_token.rb
 - lib/cliqr/parser/token.rb
 - lib/cliqr/parser/token_factory.rb
+- lib/cliqr/usage/command_usage_context.rb
+- lib/cliqr/usage/option_usage_context.rb
+- lib/cliqr/usage/templates/partial/action_list.erb
+- lib/cliqr/usage/templates/partial/command_name.erb
+- lib/cliqr/usage/templates/partial/option_list.erb
+- lib/cliqr/usage/templates/partial/usage_info.erb
+- lib/cliqr/usage/templates/usage/cli.erb
+- lib/cliqr/usage/templates/usage/shell.erb
+- lib/cliqr/usage/usage_builder.rb
 - lib/cliqr/util.rb
 - lib/cliqr/validation_errors.rb
 - lib/cliqr/version.rb
@@ -101,21 +124,29 @@ files:
 - spec/dsl/interface_spec.rb
 - spec/dsl/usage_spec.rb
 - spec/executor/action_executor_spec.rb
+- spec/executor/color_executor_spec.rb
 - spec/executor/command_runner_spec.rb
+- spec/executor/event_executor_spec.rb
 - spec/executor/executor_spec.rb
 - spec/executor/help_executor_spec.rb
-- spec/executor/shell_executor_spec.rb
 - spec/fixtures/action_reader_command.rb
 - spec/fixtures/always_error_command.rb
 - spec/fixtures/argument_reader_command.rb
 - spec/fixtures/csv_argument_operator.rb
 - spec/fixtures/option_reader_command.rb
+- spec/fixtures/test_arg_printer_event_handler.rb
+- spec/fixtures/test_color_shell_prompt.rb
 - spec/fixtures/test_command.rb
+- spec/fixtures/test_empty_event_handler.rb
+- spec/fixtures/test_invoker_event_handler.rb
 - spec/fixtures/test_option_checker_command.rb
 - spec/fixtures/test_option_reader_command.rb
 - spec/fixtures/test_option_type_checker_command.rb
+- spec/fixtures/test_shell_banner.rb
+- spec/fixtures/test_shell_prompt.rb
 - spec/parser/action_argument_parser_spec.rb
 - spec/parser/argument_parser_spec.rb
+- spec/shell/shell_executor_spec.rb
 - spec/spec_helper.rb
 - spec/validation/action_argument_validator_spec.rb
 - spec/validation/command_argument_validation_spec.rb
@@ -124,7 +155,6 @@ files:
 - tasks/rdoc.rake
 - tasks/rubucop.rake
 - tasks/yard.rake
-- templates/usage.erb
 homepage: https://github.com/anshulverma/cliqr
 licenses:
 - MIT
@@ -135,17 +165,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: 1.9.3
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: 1.3.6
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.6
 signing_key: 
 specification_version: 4
 summary: A framework and DSL for defining CLI interface
@@ -158,21 +188,29 @@ test_files:
 - spec/dsl/interface_spec.rb
 - spec/dsl/usage_spec.rb
 - spec/executor/action_executor_spec.rb
+- spec/executor/color_executor_spec.rb
 - spec/executor/command_runner_spec.rb
+- spec/executor/event_executor_spec.rb
 - spec/executor/executor_spec.rb
 - spec/executor/help_executor_spec.rb
-- spec/executor/shell_executor_spec.rb
 - spec/fixtures/action_reader_command.rb
 - spec/fixtures/always_error_command.rb
 - spec/fixtures/argument_reader_command.rb
 - spec/fixtures/csv_argument_operator.rb
 - spec/fixtures/option_reader_command.rb
+- spec/fixtures/test_arg_printer_event_handler.rb
+- spec/fixtures/test_color_shell_prompt.rb
 - spec/fixtures/test_command.rb
+- spec/fixtures/test_empty_event_handler.rb
+- spec/fixtures/test_invoker_event_handler.rb
 - spec/fixtures/test_option_checker_command.rb
 - spec/fixtures/test_option_reader_command.rb
 - spec/fixtures/test_option_type_checker_command.rb
+- spec/fixtures/test_shell_banner.rb
+- spec/fixtures/test_shell_prompt.rb
 - spec/parser/action_argument_parser_spec.rb
 - spec/parser/argument_parser_spec.rb
+- spec/shell/shell_executor_spec.rb
 - spec/spec_helper.rb
 - spec/validation/action_argument_validator_spec.rb
 - spec/validation/command_argument_validation_spec.rb

data/lib/cliqr/cli/config.rb

@@ -1,554 +0,0 @@
-# encoding: utf-8
-
-require 'cliqr/dsl'
-require 'cliqr/util'
-require 'cliqr/config_validation/verifiable'
-require 'cliqr/cli/command'
-require 'cliqr/cli/argument_operator'
-
-module Cliqr
-  # A extension for CLI module to group all config classes
-  module CLI
-    # A value to initialize configuration attributes with
-    UNSET = Object.new
-
-    # Configuration option to enable arguments for a command (default)
-    ENABLE_CONFIG = :enable
-
-    # Configuration option to disable arguments for a command
-    DISABLE_CONFIG = :disable
-
-    # Option type for regular options
-    ANY_ARGUMENT_TYPE = :any
-
-    # Option type for numeric arguments
-    NUMERIC_ARGUMENT_TYPE = :numeric
-
-    # Option type for boolean arguments
-    BOOLEAN_ARGUMENT_TYPE = :boolean
-
-    # Default values based on argument type
-    ARGUMENT_DEFAULTS = {
-        NUMERIC_ARGUMENT_TYPE => 0,
-        BOOLEAN_ARGUMENT_TYPE => false,
-        ANY_ARGUMENT_TYPE => nil
-    }
-
-    # The configuration setting to build a cli application with its own dsl
-    #
-    # @api private
-    class Config
-      extend Cliqr::DSL
-      include Cliqr::ConfigValidation
-
-      # Name of the command
-      #
-      # @return [String]
-      attr_accessor :name
-      validates :name,
-                non_empty_format: /^[a-zA-Z0-9_\-]+$/
-
-      # Description for the base command
-      #
-      # @return [String]
-      attr_accessor :description
-
-      # Command handler for the base command
-      #
-      # @return [Class<Cliqr::CLI::Command>]
-      attr_accessor :handler
-      validates :handler,
-                one_of: {
-                    extend: Cliqr::CLI::Command,
-                    type_of: Proc
-                }
-
-      #  Dictates whether this command can take arbitrary arguments (optional)
-      #
-      # @return [Symbol] Either <tt>#ENABLE_CONFIG</tt> or <tt>#DISABLE_CONFIG</tt>
-      attr_accessor :arguments
-      validates :arguments,
-                inclusion: [ENABLE_CONFIG, DISABLE_CONFIG]
-
-      # Array of options applied to the base command
-      #
-      # @return [Array<OptionConfig>]
-      attr_accessor :options
-      validates :options,
-                collection: true
-
-      # Array of children action configs for this action
-      #
-      # @return [Array<Cliqr::CLI::Config>]
-      attr_accessor :actions
-      validates :actions,
-                collection: true
-
-      # Enable or disable help command and option
-      #
-      # @return [Symbol] Either <tt>#ENABLE_CONFIG</tt> or <tt>#DISABLE_CONFIG</tt>
-      attr_accessor :help
-      validates :help,
-                inclusion: [ENABLE_CONFIG, DISABLE_CONFIG]
-
-      # Enable or disable the shell action for base config
-      #
-      # @return [Symbol] Either <tt>#ENABLE_CONFIG</tt> or <tt>#DISABLE_CONFIG</tt>
-      attr_accessor :shell
-      validates :shell,
-                inclusion: [ENABLE_CONFIG, DISABLE_CONFIG]
-
-      # Version tag for this configuration
-      #
-      # @return [Stirng]
-      attr_accessor :version
-
-      # Parent configuration
-      #
-      # @return [Cliqr::CLI::Config]
-      attr_accessor :parent
-
-      # Root config
-      #
-      # @return [Cliqr::CLI::Config]
-      attr_accessor :root
-
-      # New config instance with all attributes set as UNSET
-      def initialize
-        @name = UNSET
-        @description = UNSET
-        @handler = UNSET
-        @arguments = UNSET
-        @help = UNSET
-        @shell = UNSET
-        @version = UNSET
-
-        @options = []
-        @option_index = {}
-
-        @actions = []
-        @action_index = {}
-      end
-
-      # Finalize config by adding default values for unset values
-      #
-      # @return [Cliqr::CLI::Config]
-      def finalize
-        @name = Config.get_if_unset(@name, '')
-        @description = Config.get_if_unset(@description, '')
-        @handler = Util.ensure_instance(Config.get_if_unset(@handler, nil))
-        @arguments = Config.get_if_unset(@arguments, ENABLE_CONFIG)
-        @help = Config.get_if_unset(@help, ENABLE_CONFIG)
-        @root = self
-        @shell = Config.get_if_unset(@shell, shell_default)
-        @version = Config.get_if_unset(@version, nil)
-
-        self
-      end
-
-      # Set up default attributes for this configuration
-      #
-      # @return [Cliqr::CLI::Config] Update config
-      def setup_defaults
-        add_shell
-        add_version
-        add_help
-        @handler = Cliqr::Util.forward_to_help_handler if @handler.nil? && help? && actions?
-        @actions.each(&:setup_defaults)
-      end
-
-      # Set value for a config option
-      #
-      # @param [Symbol] name Name of the config parameter
-      # @param [Object] value Value for the config parameter
-      # @param [Proc] block Function which populates configuration for a sub-attribute
-      #
-      # @return [Object] if setting a attribute's value
-      # @return [Cliqr::CLI::OptionConfig] if adding a new option
-      # @return [Cliqr::CLI::Config] if adding a new action
-      def set_config(name, value, &block)
-        case name
-        when :option
-          handle_option value, &block # value is the long name for the option
-        when :action
-          handle_action value, &block # value is action's name
-        else
-          value = block if block_given?
-          handle_config name, value
-        end
-      end
-
-      # Check if options are set
-      #
-      # @return [Boolean] <tt>true</tt> if the CLI config's options have been set
-      def options?
-        @options != UNSET
-      end
-
-      # Check if particular option is set
-      #
-      # @param [String] name Name of the option to check
-      #
-      # @return [Boolean] <tt>true</tt> if the CLI config's option is set
-      def option?(name)
-        @option_index.key?(name.to_s)
-      end
-
-      # Get value of a option
-      #
-      # @param [String] name Name of the option
-      #
-      # @return [String] value for the option
-      def option(name)
-        @option_index[name.to_s]
-      end
-
-      # Check if particular action exists
-      #
-      # @param [String] name Name of the action to check
-      #
-      # @return [Boolean] <tt>true</tt> if the action exists in the configuration
-      def action?(name)
-        return false if name.nil?
-        @action_index.key?(name.to_sym)
-      end
-
-      # Check if this config has sub actions
-      #
-      # @return [Array<Cliqr::CLI::Config]>
-      def actions?
-        !@actions.empty?
-      end
-
-      # Get action config by name
-      #
-      # @param [String] name Name of the action
-      #
-      # @return [Cliqr::CLI::Config] Configuration of the action
-      def action(name)
-        @action_index[name.to_sym]
-      end
-
-      # Check if arguments are enabled for this configuration
-      #
-      # @return [Boolean] <tt>true</tt> if arguments are enabled
-      def arguments?
-        @arguments == ENABLE_CONFIG
-      end
-
-      # Get name of the command along with the action upto this config
-      #
-      # @return [String] Serialized command name
-      def command
-        return name unless parent?
-        "#{@parent.command} #{name}"
-      end
-
-      # Check if this config has a parent config
-      #
-      # @return [Boolean] <tt>true</tt> if there exists a parent action for this action
-      def parent?
-        !@parent.nil?
-      end
-
-      # Check if help is enabled for this command
-      #
-      # @return [Boolean] <tt>true</tt> if help is enabled
-      def help?
-        @help == ENABLE_CONFIG
-      end
-
-      # Check if version is enabled for this command
-      #
-      # @return [Boolean] <tt>true</tt> if help is enabled
-      def version?
-        !@version.nil?
-      end
-
-      # Check if this is the root config
-      #
-      # @return [Boolean]
-      def root?
-        self == @root
-      end
-
-      # Check if this configuration has shell action enabled
-      #
-      # @return [Boolean]
-      def shell?
-        @shell == ENABLE_CONFIG
-      end
-
-      private
-
-      # Set value for config option without evaluating a block
-      #
-      # @param [Symbol] name Name of the config option
-      # @param [Object] value Value for the config option
-      #
-      # @return [Object] Value that was assigned to attribute
-      def handle_config(name, value)
-        public_send("#{name}=", value)
-        value
-      end
-
-      # Handle configuration for a new option
-      #
-      # @param [Symbol] name Long name of the option
-      # @param [Proc] block Populate the option's config in this funciton block
-      #
-      # @return [Cliqr::CLI::OptionConfig] Newly created option's config
-      def handle_option(name, &block)
-        option_config = OptionConfig.build(&block)
-        option_config.name = name
-        add_option(option_config)
-      end
-
-      # Add a new option for the command
-      #
-      # @return [Cliqr::CLI::OptionConfig] Newly added option's config
-      def add_option(option_config)
-        validate_option_name(option_config)
-
-        @options.push(option_config)
-        @option_index[option_config.name.to_s] = option_config
-        @option_index[option_config.short.to_s] = option_config if option_config.short?
-
-        option_config
-      end
-
-      # Handle configuration for a new action
-      #
-      # @param [String] name Name of the action
-      # @param [Function] block The block which configures this action
-      #
-      # @return [Cliqr::CLI::Config] The newly configured action
-      def handle_action(name, &block)
-        action_config = Config.build(&block)
-        action_config.name = name
-        add_action(action_config)
-      end
-
-      # Add a new action
-      #
-      # @return [Cliqr::CLI::Config] The newly added action
-      def add_action(action_config)
-        action_config.parent = self
-        action_config.root = root
-
-        validate_action_name(action_config)
-
-        @actions.push(action_config)
-        @action_index[action_config.name.to_sym] = action_config \
-          unless action_config.name.nil?
-
-        action_config
-      end
-
-      # Make sure that the option's name is unique
-      #
-      # @param [Cliqr::CLI::OptionConfig] option_config Config for this particular option
-      #
-      # @return [Cliqr::CLI::OptionConfig] Validated OptionConfig instance
-      def validate_option_name(option_config)
-        fail Cliqr::Error::DuplicateOptions,
-             "multiple options with long name \"#{option_config.name}\"" \
-             if option?(option_config.name)
-
-        fail Cliqr::Error::DuplicateOptions,
-             "multiple options with short name \"#{option_config.short}\"" \
-              if option?(option_config.short)
-
-        option_config
-      end
-
-      # Make sure that the action's name is unique
-      #
-      # @param [Cliqr::CLI::Config] action_config Config for this particular action
-      #
-      # @return [Cliqr::CLI::Config] Validated action's Config instance
-      def validate_action_name(action_config)
-        fail Cliqr::Error::DuplicateActions,
-             "multiple actions named \"#{action_config.name}\"" \
-             if action?(action_config.name)
-
-        action_config
-      end
-
-      # Add help command and option to this config
-      #
-      # @return [Cliqr::CLI::Config] Updated config
-      def add_help
-        return self unless help?
-        add_action(Cliqr::Util.build_help_action(self)) unless action?('help')
-        add_option(Cliqr::Util.build_help_option(self)) unless option?('help')
-      end
-
-      # Add version command and option to this config
-      #
-      # @return [Cliqr::CLI::Config] Updated config
-      def add_version
-        return self unless version?
-        add_action(Cliqr::Util.build_version_action(self)) unless action?('version')
-        add_option(Cliqr::Util.build_version_option(self)) unless option?('version')
-      end
-
-      # Add shell command
-      #
-      # @return [Cliqr::CLI::Config] Updated config
-      def add_shell
-        return self unless shell?
-        add_action(Cliqr::Util.build_shell_action(self)) unless action?('shell')
-      end
-
-      # Get default setting for shell attribute
-      #
-      # @return [Symbol]
-      def shell_default
-        root? && actions? ? ENABLE_CONFIG : DISABLE_CONFIG
-      end
-
-      # Get the passed param value if current attribute is unset
-      #
-      # @return [Object]
-      def self.get_if_unset(attribute_value, default_value)
-        attribute_value == UNSET ? default_value : attribute_value
-      end
-    end
-
-    # Config attributes for a command's option
-    #
-    # @api private
-    class OptionConfig
-      extend Cliqr::DSL
-      include Cliqr::ConfigValidation
-
-      # Long option name
-      #
-      # @return [String]
-      attr_accessor :name
-      validates :name,
-                non_empty: true,
-                format: /^[a-zA-Z0-9_\-]*$/
-
-      # Optional short name for the option
-      #
-      # @return [String]
-      attr_accessor :short
-      validates :short,
-                non_empty_nil_ok_format: /^[a-z0-9A-Z]$/
-
-      # A description string for the option
-      #
-      # @return [String]
-      attr_accessor :description
-
-      # Optional field that restricts values of this option to a certain type
-      #
-      # @return [Symbol] Type of the option
-      attr_accessor :type
-      validates :type,
-                inclusion: [:any, NUMERIC_ARGUMENT_TYPE, BOOLEAN_ARGUMENT_TYPE]
-
-      # Operation to be applied to the option value after validation
-      #
-      # @return [Class<Cliqr::CLI::ArgumentOperator>]
-      attr_accessor :operator
-      validates :operator,
-                one_of: {
-                    extend: Cliqr::CLI::ArgumentOperator,
-                    type_of: Proc
-                }
-
-      # Default value for this option
-      #
-      # @return [Object]
-      attr_accessor :default
-
-      # Set value for command option's attribute
-      #
-      # @param [Symbol] name Name of the attribute
-      # @param [Object] value Value for the attribute
-      # @param [Proc] block A anonymous block to initialize the config value
-      #
-      # @return [Object] Value that was set for the attribute
-      def set_config(name, value, &block)
-        value = block if block_given?
-        handle_option_config name, value
-      end
-
-      # Initialize a new config instance for an option with UNSET attribute values
-      def initialize
-        @name = UNSET
-        @short = UNSET
-        @description = UNSET
-        @type = UNSET
-        @operator = UNSET
-        @default = UNSET
-      end
-
-      # Finalize option's config by adding default values for unset values
-      #
-      # @return [Cliqr::CLI::OptionConfig]
-      def finalize
-        @name = Config.get_if_unset(@name, nil)
-        @short = Config.get_if_unset(@short, nil)
-        @description = Config.get_if_unset(@description, nil)
-        @type = Config.get_if_unset(@type, ANY_ARGUMENT_TYPE)
-        @operator = Util.ensure_instance(Config.get_if_unset(@operator,
-                                                             ArgumentOperator.for_type(@type)))
-        @default = Config.get_if_unset(@default, ARGUMENT_DEFAULTS[@type])
-
-        self
-      end
-
-      # Check if a option's short name is defined
-      #
-      # @return [Boolean] <tt>true</tt> if options' short name is not null neither empty
-      def short?
-        !(@short.nil? || @short.empty?)
-      end
-
-      # Check if a option's description is defined
-      #
-      # @return [Boolean] <tt>true</tt> if options' description is not null neither empty
-      def description?
-        !(@description.nil? || @description.empty?)
-      end
-
-      # Check if a option's type is defined
-      #
-      # @return [Boolean] <tt>true</tt> if options' type is not nil and not equal to <tt>:any</tt>
-      def type?
-        !@type.nil? && @type != :any
-      end
-
-      # Check if a option is of boolean type
-      #
-      # @return [Boolean] <tt>true</tt> is the option is of type <tt>:boolean</tt>
-      def boolean?
-        @type == :boolean
-      end
-
-      # Check if a default value setting is defined
-      #
-      # @return [Boolean]
-      def default?
-        !@default.nil?
-      end
-
-      private
-
-      # Set value for config option without evaluating a block
-      #
-      # @param [Symbol] name Name of the config option
-      # @param [Object] value Value for the config option
-      #
-      # @return [Object]
-      def handle_option_config(name, value)
-        public_send("#{name}=", value)
-        value
-      end
-    end
-  end
-end