toys-core 0.3.6 → 0.3.7

data/lib/toys/utils/wrappable_string.rb

@@ -27,6 +27,8 @@
 # POSSIBILITY OF SUCH DAMAGE.
 ;
 
+require "toys/utils/terminal"
+
 module Toys
   module Utils
     ##
@@ -99,7 +101,7 @@ module Toys
         line = ""
         line_len = 0
         fragments.each do |frag|
-          frag_len = ::HighLine.uncolor(frag).size
+          frag_len = Utils::Terminal.remove_style_escapes(frag).size
           if line_len.zero?
             line = frag
             line_len = frag_len

metadata

@@ -1,29 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: toys-core
 version: !ruby/object:Gem::Version
-  version: 0.3.6
+  version: 0.3.7
 platform: ruby
 authors:
 - Daniel Azuma
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-05-21 00:00:00.000000000 Z
+date: 2018-05-30 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: highline
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.7'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.7'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -108,17 +94,23 @@ files:
 - README.md
 - docs/getting-started.md
 - lib/toys-core.rb
-- lib/toys/alias.rb
 - lib/toys/cli.rb
-- lib/toys/config_dsl.rb
-- lib/toys/context.rb
 - lib/toys/core_version.rb
+- lib/toys/definition/acceptor.rb
+- lib/toys/definition/alias.rb
+- lib/toys/definition/arg.rb
+- lib/toys/definition/flag.rb
+- lib/toys/definition/tool.rb
+- lib/toys/dsl/arg.rb
+- lib/toys/dsl/flag.rb
+- lib/toys/dsl/tool.rb
 - lib/toys/errors.rb
 - lib/toys/helpers.rb
 - lib/toys/helpers/exec.rb
 - lib/toys/helpers/fileutils.rb
 - lib/toys/helpers/highline.rb
-- lib/toys/helpers/spinner.rb
+- lib/toys/helpers/terminal.rb
+- lib/toys/input_file.rb
 - lib/toys/loader.rb
 - lib/toys/middleware.rb
 - lib/toys/middleware/add_verbosity_flags.rb
@@ -127,6 +119,7 @@ files:
 - lib/toys/middleware/set_default_descriptions.rb
 - lib/toys/middleware/show_help.rb
 - lib/toys/middleware/show_root_version.rb
+- lib/toys/runner.rb
 - lib/toys/template.rb
 - lib/toys/templates.rb
 - lib/toys/templates/clean.rb
@@ -135,13 +128,11 @@ files:
 - lib/toys/templates/rubocop.rb
 - lib/toys/templates/yardoc.rb
 - lib/toys/tool.rb
-- lib/toys/tool/acceptor.rb
-- lib/toys/tool/arg_definition.rb
-- lib/toys/tool/flag_definition.rb
 - lib/toys/utils/exec.rb
+- lib/toys/utils/gems.rb
 - lib/toys/utils/help_text.rb
-- lib/toys/utils/line_output.rb
 - lib/toys/utils/module_lookup.rb
+- lib/toys/utils/terminal.rb
 - lib/toys/utils/wrappable_string.rb
 homepage: https://github.com/dazuma/toys
 licenses:

data/lib/toys/config_dsl.rb

@@ -1,699 +0,0 @@
-# Copyright 2018 Daniel Azuma
-#
-# All rights reserved.
-#
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted provided that the following conditions are met:
-#
-# * Redistributions of source code must retain the above copyright notice,
-#   this list of conditions and the following disclaimer.
-# * Redistributions in binary form must reproduce the above copyright notice,
-#   this list of conditions and the following disclaimer in the documentation
-#   and/or other materials provided with the distribution.
-# * Neither the name of the copyright holder, nor the names of any other
-#   contributors to this software, may be used to endorse or promote products
-#   derived from this software without specific prior written permission.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
-# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-# POSSIBILITY OF SUCH DAMAGE.
-;
-
-require "toys/context"
-
-module Toys
-  ##
-  # This class defines the DSL for a toys configuration file.
-  #
-  # A toys configuration defines one or more named tools. It provides syntax
-  # for setting the description, defining flags and arguments, specifying
-  # how to execute the tool, and requesting helper modules and other services.
-  # It also lets you define subtools, nested arbitrarily deep, using blocks.
-  #
-  # Generally ConfigDSL is invoked from the {Loader}. Applications should not
-  # need to create instances of ConfigDSL directly.
-  #
-  # ## Simple example
-  #
-  # Create a file called `.toys.rb` in the current directory, with the
-  # following contents:
-  #
-  #     tool "greet" do
-  #       desc "Prints a simple greeting"
-  #
-  #       optional_arg :recipient, default: "world"
-  #
-  #       script do
-  #         puts "Hello, #{self[:recipient]}!"
-  #       end
-  #     end
-  #
-  # Now you can execute it using:
-  #
-  #     toys greet
-  #
-  # or try:
-  #
-  #     toys greet rubyists
-  #
-  class ConfigDSL
-    # Copy the well-known context key constants here, so that script blocks
-    # inside config DSL files can access them without qualification.
-    ::Toys::Context.constants.each do |const|
-      const_set(const, ::Toys::Context.const_get(const))
-    end
-
-    ##
-    # Create an instance of the DSL.
-    # @private
-    #
-    # @param [Array<String>] words Full name of the current tool.
-    # @param [Array<String>,nil] remaining_words Arguments remaining in the
-    #     current lookup.
-    # @param [Integer] priority Priority of this configuration
-    # @param [Toys::Loader] loader Current active loader
-    # @param [String] path The path to the config file being evaluated
-    #
-    # @return [Toys::ConfigDSL]
-    #
-    def initialize(words, remaining_words, priority, loader, path)
-      @words = words
-      @remaining_words = remaining_words
-      @priority = priority
-      @loader = loader
-      @path = path
-    end
-
-    ##
-    # Create an acceptor that can be passed into a flag or arg. An acceptor
-    # validates and/or converts a string parameter to a Ruby object. This
-    # acceptor may, for the current tool, be referenced by the name you provide
-    # when you create a flag or arg.
-    #
-    # An acceptor contains a validator, which parses and validates the string
-    # syntax of an argument, and a converter, which takes the validation
-    # results and returns a final value for the context data.
-    #
-    # The validator may be either a regular expression or a list of valid
-    # inputs.
-    #
-    # If the validator is a regular expression, it is matched against the
-    # argument string and succeeds only if the expression covers the *entire*
-    # string. The elements of the MatchData (i.e. the string matched, plus any
-    # captures) are then passed into the conversion function.
-    #
-    # If the validator is an array, the *string form* of the array elements
-    # (i.e. the results of calling to_s on each element) are considered the
-    # valid values for the argument. This is useful for enums, for example.
-    # In this case, the input is converted to the original array element, and
-    # any converter function you provide is ignored.
-    #
-    # If you provide no validator, then no validation takes place and all
-    # argument strings are considered valid. The string itself is passed on to
-    # the converter.
-    #
-    # The converter should be a proc that takes as its arguments the results
-    # of validation. For example, if you use a regular expression validator,
-    # the converter should take a series of strings arguments, the first of
-    # which is the full input string, and the rest of which are captures.
-    # If you provide no converter, no conversion is done and the input string
-    # is considered the final value. You may also provide the converter as a
-    # block.
-    #
-    # @param [String] name The acceptor name.
-    # @param [Regexp,Array,nil] validator The validator.
-    # @param [Proc,nil] converter The validator.
-    #
-    def acceptor(name, validator = nil, converter = nil, &block)
-      accept =
-        case validator
-        when ::Regexp
-          Tool::PatternAcceptor.new(name, validator, converter, &block)
-        when ::Array
-          Tool::EnumAcceptor.new(name, validator)
-        when nil
-          Tool::Acceptor.new(name, converter, &block)
-        else
-          raise ToolDefinitionError, "Illegal validator: #{validator.inspect}"
-        end
-      _cur_tool.add_acceptor(accept)
-      self
-    end
-
-    ##
-    # Create a subtool. You must provide a block defining the subtool.
-    #
-    # If the subtool is already defined (either as a tool or a namespace), the
-    # old definition is discarded and replaced with the new definition.
-    #
-    # @param [String] word The name of the subtool
-    #
-    def tool(word, &block)
-      word = word.to_s
-      subtool_words = @words + [word]
-      next_remaining = Loader.next_remaining_words(@remaining_words, word)
-      ConfigDSL.evaluate(subtool_words, next_remaining, @priority, @loader, @path, block)
-      self
-    end
-    alias name tool
-
-    ##
-    # Create an alias in the current namespace.
-    #
-    # @param [String] word The name of the alias
-    # @param [String] target The target of the alias
-    #
-    def alias_tool(word, target)
-      @loader.make_alias(@words + [word.to_s], @words + [target.to_s], @priority)
-      self
-    end
-
-    ##
-    # Create an alias of the current tool.
-    #
-    # @param [String] word The name of the alias
-    #
-    def alias_as(word)
-      if @words.empty?
-        raise ToolDefinitionError, "Cannot make an alias of the root."
-      end
-      @loader.make_alias(@words[0..-2] + [word.to_s], @words, @priority)
-      self
-    end
-
-    ##
-    # Include another config file or directory at the current location.
-    #
-    # @param [String] path The file or directory to include.
-    #
-    def include(path)
-      @loader.include_path(path, @words, @remaining_words, @priority)
-      self
-    end
-
-    ##
-    # Expand the given template in the current location.
-    #
-    # The template may be specified as a class or a well-known template name.
-    # You may also provide arguments to pass to the template.
-    #
-    # @param [Class,String,Symbol] template_class The template, either as a
-    #     class or a well-known name.
-    # @param [Object...] args Template arguments
-    #
-    def expand(template_class, *args)
-      unless template_class.is_a?(::Class)
-        name = template_class.to_s
-        template_class = Templates.lookup(name)
-        if template_class.nil?
-          raise ToolDefinitionError, "Template not found: #{name.inspect}"
-        end
-      end
-      template = template_class.new(*args)
-      yield template if block_given?
-      instance_exec(template, &template_class.expander)
-      self
-    end
-
-    ##
-    # Set the short description for the current tool. The short description is
-    # displayed with the tool in a subtool list. You may also use the
-    # equivalent method `short_desc`.
-    #
-    # The description is a {Toys::Utils::WrappableString}, which may be word-
-    # wrapped when displayed in a help screen. You may pass a
-    # {Toys::Utils::WrappableString} directly to this method, or you may pass
-    # any input that can be used to construct a wrappable string:
-    #
-    # *   If you pass a String, its whitespace will be compacted (i.e. tabs,
-    #     newlines, and multiple consecutive whitespace will be turned into a
-    #     single space), and it will be word-wrapped on whitespace.
-    # *   If you pass an Array of Strings, each string will be considered a
-    #     literal word that cannot be broken, and wrapping will be done across
-    #     the strings in the array. In this case, whitespace is not compacted.
-    #
-    # For example, if you pass in a sentence as a simple string, it may be
-    # word wrapped when displayed:
-    #
-    #     desc "This sentence may be wrapped."
-    #
-    # To specify a sentence that should never be word-wrapped, pass it as the
-    # sole element of a string array:
-    #
-    #     desc ["This sentence will not be wrapped."]
-    #
-    # @param [Toys::Utils::WrappableString,String,Array<String>] str
-    #
-    def desc(str)
-      return self if _cur_tool.nil?
-      _cur_tool.lock_definition_path(@path)
-      _cur_tool.desc = str
-      self
-    end
-    alias short_desc desc
-
-    ##
-    # Set the long description for the current tool. The long description is
-    # displayed in the usage documentation for the tool itself.
-    #
-    # A long description is a series of descriptions, which are generally
-    # displayed in a series of lines/paragraphs. Each individual description
-    # uses the form described in the {Toys::ConfigDSL#desc} documentation, and
-    # may be word-wrapped when displayed. To insert a blank line, include an
-    # empty string as one of the descriptions.
-    #
-    # Example:
-    #
-    #     long_desc "This is an initial paragraph that might be word wrapped.",
-    #               "This next paragraph is followed by a blank line.",
-    #               "",
-    #               ["This line will not be wrapped."]
-    #
-    # @param [Toys::Utils::WrappableString,String,Array<String>...] strs
-    #
-    def long_desc(*strs)
-      return self if _cur_tool.nil?
-      _cur_tool.lock_definition_path(@path)
-      _cur_tool.long_desc = strs
-      self
-    end
-
-    ##
-    # Add a flag to the current tool. Each flag must specify a key which
-    # the script may use to obtain the flag value from the context.
-    # You may then provide the flags themselves in `OptionParser` form.
-    #
-    # Attributes of the flag may be passed in as arguments to this method, or
-    # set in a block passed to this method.
-    #
-    # @param [Symbol] key The key to use to retrieve the value from the
-    #     execution context.
-    # @param [String...] flags The flags in OptionParser format.
-    # @param [Object] accept An acceptor that validates and/or converts the
-    #     value. You may provide either the name of an acceptor you have
-    #     defined, or one of the default acceptors provided by OptionParser.
-    #     Optional. If not specified, accepts any value as a string.
-    # @param [Object] default The default value. This is the value that will
-    #     be set in the context if this flag is not provided on the command
-    #     line. Defaults to `nil`.
-    # @param [Proc,nil] handler An optional handler for setting/updating the
-    #     value. If given, it should take two arguments, the new given value
-    #     and the previous value, and it should return the new value that
-    #     should be set. The default handler simply replaces the previous
-    #     value. i.e. the default is effectively `-> (val, _prev) { val }`.
-    # @param [Boolean] report_collisions Raise an exception if a flag is
-    #     requested that is already in use or marked as unusable. Default is
-    #     true.
-    # @param [String,Array<String>,Toys::Utils::WrappableString] desc Short
-    #     description for the flag. See {Toys::ConfigDSL#desc} for a description
-    #     of the allowed formats. Defaults to the empty string.
-    # @param [Array<String,Array<String>,Toys::Utils::WrappableString>] long_desc
-    #     Long description for the flag. See {Toys::ConfigDSL#long_desc} for a
-    #     description of the allowed formats. (But note that this param takes
-    #     an Array of description lines, rather than a series of arguments.)
-    #     Defaults to the empty array.
-    # @yieldparam flag_dsl [Toys::ConfigDSL::FlagDSL] An object that lets you
-    #     configure this flag in a block.
-    #
-    def flag(key, *flags,
-             accept: nil, default: nil, handler: nil,
-             report_collisions: true,
-             desc: nil, long_desc: nil)
-      return self if _cur_tool.nil?
-      flag_dsl = FlagDSL.new(flags, accept, default, handler, report_collisions, desc, long_desc)
-      yield flag_dsl if block_given?
-      _cur_tool.lock_definition_path(@path)
-      flag_dsl._add_to(_cur_tool, key)
-      self
-    end
-
-    ##
-    # Add a required positional argument to the current tool. You must specify
-    # a key which the script may use to obtain the argument value from the
-    # context.
-    #
-    # @param [Symbol] key The key to use to retrieve the value from the
-    #     execution context.
-    # @param [Object] accept An acceptor that validates and/or converts the
-    #     value. You may provide either the name of an acceptor you have
-    #     defined, or one of the default acceptors provided by OptionParser.
-    #     Optional. If not specified, accepts any value as a string.
-    # @param [String] display_name A name to use for display (in help text and
-    #     error reports). Defaults to the key in upper case.
-    # @param [String,Array<String>,Toys::Utils::WrappableString] desc Short
-    #     description for the flag. See {Toys::ConfigDSL#desc} for a description
-    #     of the allowed formats. Defaults to the empty string.
-    # @param [Array<String,Array<String>,Toys::Utils::WrappableString>] long_desc
-    #     Long description for the flag. See {Toys::ConfigDSL#long_desc} for a
-    #     description of the allowed formats. (But note that this param takes
-    #     an Array of description lines, rather than a series of arguments.)
-    #     Defaults to the empty array.
-    # @yieldparam arg_dsl [Toys::ConfigDSL::ArgDSL] An object that lets you
-    #     configure this argument in a block.
-    #
-    def required_arg(key, accept: nil, display_name: nil, desc: nil, long_desc: nil)
-      return self if _cur_tool.nil?
-      arg_dsl = ArgDSL.new(accept, nil, display_name, desc, long_desc)
-      yield arg_dsl if block_given?
-      _cur_tool.lock_definition_path(@path)
-      arg_dsl._add_required_to(_cur_tool, key)
-      self
-    end
-    alias required required_arg
-
-    ##
-    # Add an optional positional argument to the current tool. You must specify
-    # a key which the script may use to obtain the argument value from the
-    # context. If an optional argument is not given on the command line, the
-    # value is set to the given default.
-    #
-    # @param [Symbol] key The key to use to retrieve the value from the
-    #     execution context.
-    # @param [Object] default The default value. This is the value that will
-    #     be set in the context if this argument is not provided on the command
-    #     line. Defaults to `nil`.
-    # @param [Object] accept An acceptor that validates and/or converts the
-    #     value. You may provide either the name of an acceptor you have
-    #     defined, or one of the default acceptors provided by OptionParser.
-    #     Optional. If not specified, accepts any value as a string.
-    # @param [String] display_name A name to use for display (in help text and
-    #     error reports). Defaults to the key in upper case.
-    # @param [String,Array<String>,Toys::Utils::WrappableString] desc Short
-    #     description for the flag. See {Toys::ConfigDSL#desc} for a description
-    #     of the allowed formats. Defaults to the empty string.
-    # @param [Array<String,Array<String>,Toys::Utils::WrappableString>] long_desc
-    #     Long description for the flag. See {Toys::ConfigDSL#long_desc} for a
-    #     description of the allowed formats. (But note that this param takes
-    #     an Array of description lines, rather than a series of arguments.)
-    #     Defaults to the empty array.
-    # @yieldparam arg_dsl [Toys::ConfigDSL::ArgDSL] An object that lets you
-    #     configure this argument in a block.
-    #
-    def optional_arg(key, default: nil, accept: nil, display_name: nil,
-                     desc: nil, long_desc: nil)
-      return self if _cur_tool.nil?
-      arg_dsl = ArgDSL.new(accept, default, display_name, desc, long_desc)
-      yield arg_dsl if block_given?
-      _cur_tool.lock_definition_path(@path)
-      arg_dsl._add_optional_to(_cur_tool, key)
-      self
-    end
-    alias optional optional_arg
-
-    ##
-    # Specify what should be done with unmatched positional arguments. You must
-    # specify a key which the script may use to obtain the remaining args from
-    # the context.
-    #
-    # @param [Symbol] key The key to use to retrieve the value from the
-    #     execution context.
-    # @param [Object] default The default value. This is the value that will
-    #     be set in the context if no unmatched arguments are provided on the
-    #     command line. Defaults to the empty array `[]`.
-    # @param [Object] accept An acceptor that validates and/or converts the
-    #     value. You may provide either the name of an acceptor you have
-    #     defined, or one of the default acceptors provided by OptionParser.
-    #     Optional. If not specified, accepts any value as a string.
-    # @param [String] display_name A name to use for display (in help text and
-    #     error reports). Defaults to the key in upper case.
-    # @param [String,Array<String>,Toys::Utils::WrappableString] desc Short
-    #     description for the flag. See {Toys::ConfigDSL#desc} for a description
-    #     of the allowed formats. Defaults to the empty string.
-    # @param [Array<String,Array<String>,Toys::Utils::WrappableString>] long_desc
-    #     Long description for the flag. See {Toys::ConfigDSL#long_desc} for a
-    #     description of the allowed formats. (But note that this param takes
-    #     an Array of description lines, rather than a series of arguments.)
-    #     Defaults to the empty array.
-    # @yieldparam arg_dsl [Toys::ConfigDSL::ArgDSL] An object that lets you
-    #     configure this argument in a block.
-    #
-    def remaining_args(key, default: [], accept: nil, display_name: nil,
-                       desc: nil, long_desc: nil)
-      return self if _cur_tool.nil?
-      arg_dsl = ArgDSL.new(accept, default, display_name, desc, long_desc)
-      yield arg_dsl if block_given?
-      _cur_tool.lock_definition_path(@path)
-      arg_dsl._set_remaining_on(_cur_tool, key)
-      self
-    end
-    alias remaining remaining_args
-
-    ##
-    # Specify the script for this tool. This is a block that will be called,
-    # with `self` set to a {Toys::Context}.
-    #
-    def script(&block)
-      return self if _cur_tool.nil?
-      _cur_tool.lock_definition_path(@path)
-      _cur_tool.script = block
-      self
-    end
-
-    ##
-    # Define a helper method that may be called from this tool's script.
-    # You must provide a name for the method, and a block for the method
-    # definition.
-    #
-    # @param [String,Symbol] name Name of the method. May not begin with an
-    #     underscore.
-    #
-    def helper(name, &block)
-      return self if _cur_tool.nil?
-      _cur_tool.lock_definition_path(@path)
-      _cur_tool.add_helper(name, &block)
-      self
-    end
-
-    ##
-    # Specify that the given module should be mixed in to this tool's script.
-    # Effectively, the module is added to the {Toys::Context} object.
-    # You may either provide a module directly, or specify the name of a
-    # well-known module.
-    #
-    # @param [Module,Symbol] mod Module or name of well-known module.
-    #
-    def use(mod)
-      return self if _cur_tool.nil?
-      _cur_tool.lock_definition_path(@path)
-      _cur_tool.use_module(mod)
-      self
-    end
-
-    ##
-    # DSL for a flag definition block. Lets you set flag attributes in a block
-    # instead of a long series of keyword arguments.
-    #
-    class FlagDSL
-      ## @private
-      def initialize(flags, accept, default, handler, report_collisions, desc, long_desc)
-        @flags = flags
-        @accept = accept
-        @default = default
-        @handler = handler
-        @report_collisions = report_collisions
-        @desc = desc
-        @long_desc = long_desc
-      end
-
-      ##
-      # Add flags in OptionParser format. This may be called multiple times,
-      # and the results are cumulative.
-      # @param [String...] flags
-      #
-      def flags(*flags)
-        @flags += flags
-        self
-      end
-
-      ##
-      # Set the OptionParser acceptor.
-      # @param [Object] accept
-      #
-      def accept(accept)
-        @accept = accept
-        self
-      end
-
-      ##
-      # Set the default value.
-      # @param [Object] default
-      #
-      def default(default)
-        @default = default
-        self
-      end
-
-      ##
-      # Set the optional handler for setting/updating the value when a flag is
-      # parsed. It should be a Proc taking two arguments, the new given value
-      # and the previous value, and it should return the new value that should
-      # be set.
-      # @param [Proc] handler
-      #
-      def handler(handler)
-        @handler = handler
-        self
-      end
-
-      ##
-      # Set whether to raise an exception if a flag is requested that is
-      # already in use or marked as disabled.
-      # @param [Boolean] setting
-      #
-      def report_collisions(setting)
-        @report_collisions = setting
-        self
-      end
-
-      ##
-      # Set the short description. See {Toys::ConfigDSL#desc} for the allowed
-      # formats.
-      # @param [String,Array<String>,Toys::Utils::WrappableString] desc
-      #
-      def desc(desc)
-        @desc = desc
-        self
-      end
-
-      ##
-      # Adds to the long description. This may be called multiple times, and
-      # the results are cumulative. See {Toys::ConfigDSL#long_desc} for the
-      # allowed formats.
-      # @param [String,Array<String>,Toys::Utils::WrappableString...] long_desc
-      #
-      def long_desc(*long_desc)
-        @long_desc += long_desc
-        self
-      end
-
-      ## @private
-      def _add_to(tool, key)
-        tool.add_flag(key, @flags,
-                      accept: @accept, default: @default, handler: @handler,
-                      report_collisions: @report_collisions,
-                      desc: @desc, long_desc: @long_desc)
-      end
-    end
-
-    ##
-    # DSL for an arg definition block. Lets you set arg attributes in a block
-    # instead of a long series of keyword arguments.
-    #
-    class ArgDSL
-      ## @private
-      def initialize(accept, default, display_name, desc, long_desc)
-        @accept = accept
-        @default = default
-        @display_name = display_name
-        @desc = desc
-        @long_desc = long_desc
-      end
-
-      ##
-      # Set the OptionParser acceptor.
-      # @param [Object] accept
-      #
-      def accept(accept)
-        @accept = accept
-        self
-      end
-
-      ##
-      # Set the default value.
-      # @param [Object] default
-      #
-      def default(default)
-        @default = default
-        self
-      end
-
-      ##
-      # Set the name of this arg as it appears in help screens.
-      # @param [String] display_name
-      #
-      def display_name(display_name)
-        @handler = display_name
-        self
-      end
-
-      ##
-      # Set the short description. See {Toys::ConfigDSL#desc} for the allowed
-      # formats.
-      # @param [String,Array<String>,Toys::Utils::WrappableString] desc
-      #
-      def desc(desc)
-        @desc = desc
-        self
-      end
-
-      ##
-      # Adds to the long description. This may be called multiple times, and
-      # the results are cumulative. See {Toys::ConfigDSL#long_desc} for the
-      # allowed formats.
-      # @param [String,Array<String>,Toys::Utils::WrappableString...] long_desc
-      #
-      def long_desc(*long_desc)
-        @long_desc += long_desc
-        self
-      end
-
-      ## @private
-      def _add_required_to(tool, key)
-        tool.add_required_arg(key,
-                              accept: @accept, display_name: @display_name,
-                              desc: @desc, long_desc: @long_desc)
-      end
-
-      ## @private
-      def _add_optional_to(tool, key)
-        tool.add_optional_arg(key,
-                              accept: @accept, default: @default, display_name: @display_name,
-                              desc: @desc, long_desc: @long_desc)
-      end
-
-      ## @private
-      def _set_remaining_on(tool, key)
-        tool.set_remaining_args(key,
-                                accept: @accept, default: @default, display_name: @display_name,
-                                desc: @desc, long_desc: @long_desc)
-      end
-    end
-
-    ## @private
-    def _binding
-      binding
-    end
-
-    ## @private
-    def _cur_tool
-      unless defined? @_cur_tool
-        @_cur_tool = @loader.get_or_create_tool(@words, priority: @priority)
-      end
-      @_cur_tool
-    end
-
-    ## @private
-    def self.evaluate(words, remaining_words, priority, loader, path, source)
-      dsl = new(words, remaining_words, priority, loader, path)
-      case source
-      when String
-        ContextualError.capture_path("Error while loading Toys config!", path) do
-          # rubocop:disable Security/Eval
-          eval(source, dsl._binding, path, 1)
-          # rubocop:enable Security/Eval
-        end
-      when ::Proc
-        dsl.instance_eval(&source)
-      end
-      nil
-    end
-  end
-end