toys-core 0.3.11 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 170a7493ef1b6d852d4a551b7e6f38d0cf861f6660c8b2b1d710c1eee7b5dd2b
-  data.tar.gz: eb2b614017aff294664306a4a2aa6ce96eda22bf37a375c9bb03641c39eb439d
+  metadata.gz: 95766b26892b0fab477c7f05a8eddf8aa0f30a9e98075b41881791ca1d446389
+  data.tar.gz: 03af27a0411ed093f1b0b27edb4aafd2562cc3b92f9176dfdd10e26be090d8f0
 SHA512:
-  metadata.gz: 2e0dc6614370daa927916614b19631dd6b9541d3ed664593b4aeaa6cab2407cb8abf7284afbf13c100fc7b6a783ac261c10e280f7112e6f359bcce90125ab414
-  data.tar.gz: aa7dbaf6c473f233207886fb2b4ce11a7dd551f802dd4e16ad9e8647ee394c8c96f5b6f483e3a775aab08224d4213cce05cf78dbf5fb1000258c4630942e2dc9
+  metadata.gz: dc6e36460d0849a153a4fe8ac376bfc120f93e19f2931bfc892dbf0fda67af82e4aa0bd73c138e9950c5559fca8cc1bc6f056195bdaad5f935e7203a48cf3411
+  data.tar.gz: 458da8a2896163512994018fbce12ee6392ae69e63383b232d9c86577bdd02a5069bbbda52c79786d7d2e09f880ccea7bca2b0845979ef12c73a545a68303c28

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Release History
 
+### 0.4.0 / 2018-07-03
+
+Now declaring this alpha quality. Backward-incompatible changes are still
+possible from this point, but I'll try to avoid them.
+
+* CHANGED: Utils::Terminal#confirm default is now unset by default
+* CHANGED: Moved gem install/activation methods into a mixin
+* IMPROVED: Toys::Utils::Gems can suppress the confirmation prompt
+* IMPROVED: Magic comments are now honored in toys files.
+* IMPROVED: Utils::Gems installation is now much faster.
+* FIXED: Utils::Gems didn't reset the specifications on Ruby 2.3.
+
 ### 0.3.11 / 2018-07-02
 
 * CHANGED: Require Ruby 2.3 or later

data/README.md

@@ -1,26 +1,15 @@
 # Toys
 
-Toys is a command line binary that lets you build your own personal suite of
-command line tools using a Ruby DSL. Toys handles argument parsing, error
-reporting, logging, help text, and many other details for you. Toys is designed
-for software developers, IT specialists, and other power users who want to
-write and organize scripts to automate their workflows.
+Toys is a configurable command line tool. Write commands in config files using
+a simple DSL, and Toys will provide the command line binary and take care of
+all the details such as argument parsing, online help, and error reporting.
 
 Toys-Core is the command line tool framework underlying Toys. It can be used
-to create command line binaries using the internal Toys APIs.
+to create your own command line binaries using the internal Toys APIs.
 
-To get started using toys-core for your own command line binary, see the
+To get started with toys-core, see the
 [Getting Started Guide](https://www.rubydoc.info/gems/toys-core/file/docs/getting-started.md)
 
-## Contributing
-
-While we appreciate contributions, please note that this software is currently
-highly experimental, and the code is evolving very rapidly. Please contact the
-author before embarking on a major pull request. More detailed contribution
-guidelines will be provided when the software stabilizes further.
-
-The source can be found on Github at https://github.com/dazuma/toys
-
 ## License
 
 Copyright 2018 Daniel Azuma
@@ -28,3 +17,5 @@ Copyright 2018 Daniel Azuma
 This software is licensed under the 3-clause BSD license.
 
 See the LICENSE.md file for more information.
+
+The source can be found on Github at https://github.com/dazuma/toys

data/lib/toys/core_version.rb

@@ -34,5 +34,5 @@ module Toys
   # Current version of Toys core
   # @return [String]
   #
-  CORE_VERSION = "0.3.11"
+  CORE_VERSION = "0.4.0"
 end

data/lib/toys/definition/tool.rb

@@ -666,7 +666,7 @@ module Toys
         unless @definition_finished
           ContextualError.capture("Error installing tool middleware!", tool_name: full_name) do
             config_proc = proc {}
-            middleware_stack.reverse.each do |middleware|
+            middleware_stack.reverse_each do |middleware|
               config_proc = make_config_proc(middleware, loader, config_proc)
             end
             config_proc.call

data/lib/toys/dsl/tool.rb

@@ -590,23 +590,15 @@ module Toys
         if mod.nil?
           raise ToolDefinitionError, "Module not found: #{name.inspect}"
         end
-        if mod.respond_to?(:initializer)
-          cur_tool.add_initializer(mod.initializer, *args) if mod.initializer
+        if mod.respond_to?(:initialization_callback) && mod.initialization_callback
+          cur_tool.add_initializer(mod.initialization_callback, *args)
+        end
+        if mod.respond_to?(:inclusion_callback) && mod.inclusion_callback
+          class_exec(*args, &mod.inclusion_callback)
         end
         super(mod)
       end
 
-      ##
-      # Activate the given gem. If it is not present, attempt to install it (or
-      # inform the user to update the bundle).
-      #
-      # @param [String] name Name of the gem
-      # @param [String...] requirements Version requirements
-      #
-      def gem(name, *requirements)
-        (@__gems ||= Utils::Gems.new).activate(name, *requirements)
-      end
-
       ## @private
       def self.new_class(words, priority, loader)
         tool_class = ::Class.new(::Toys::Tool)

data/lib/toys/input_file.rb

@@ -48,20 +48,28 @@ module Toys::InputFile # rubocop:disable Style/ClassAndModuleChildren
     end
     basename = ::File.basename(path).tr(".-", "_").gsub(/\W/, "")
     name = "M#{namespace.object_id}_#{basename}"
-    const_set(name, namespace)
-    str = <<-STR
-      module #{name}
-        @tool_class.class_eval do
-          #{::IO.read(path)}
+    str = build_eval_string(name, ::IO.read(path))
+    if str
+      const_set(name, namespace)
+      ::Toys::DSL::Tool.prepare(tool_class, remaining_words, path) do
+        ::Toys::ContextualError.capture_path("Error while loading Toys config!", path) do
+          # rubocop:disable Security/Eval
+          eval(str, __binding, path, 0)
+          # rubocop:enable Security/Eval
         end
       end
-    STR
-    ::Toys::DSL::Tool.prepare(tool_class, remaining_words, path) do
-      ::Toys::ContextualError.capture_path("Error while loading Toys config!", path) do
-        # rubocop:disable Security/Eval
-        eval(str, __binding, path, 0)
-        # rubocop:enable Security/Eval
-      end
     end
   end
+
+  ## @private
+  def self.build_eval_string(module_name, string)
+    index = string.index(/^\s*[^#\s]/)
+    return nil if index.nil?
+    "#{string[0, index]}\n" \
+      "module #{module_name}\n" \
+      "@tool_class.class_eval do\n" \
+      "#{string[index..-1]}\n" \
+      "end\n" \
+      "end\n"
+  end
 end

data/lib/toys/mixin.rb

@@ -43,12 +43,20 @@ module Toys
   # To create a mixin, define a module, and include this module. Then define
   # the methods you want to be available.
   #
-  # If you want to perform some initialization specific to the mixin, use a
-  # `to_initialize` block. This block is passed any extra arguments that were
-  # passed to the `include` directive. It is called in the context of the tool,
-  # so it also has access to tool methods such as {Toys::Tool#option}. It can
-  # perform any setup required, which often involves initializing some
-  # persistent state and storing it in the tool using {Toys::Tool#set}.
+  # If you want to perform some initialization specific to the mixin, you can
+  # provide a `to_initialize` block and/or a `to_include` block.
+  #
+  # The `to_initialize` block is called when the tool itself is instantiated.
+  # It has access to tool methods such as {Toys::Tool#option}, and can perform
+  # setup for the tool execution itself, often involving initializing some
+  # persistent state and storing it in the tool using {Toys::Tool#set}. The
+  # `to_initialize` block is passed any extra arguments that were provided to
+  # the `include` directive.
+  #
+  # The `to_include` block is called in the context of your tool class when
+  # your mixin is included. It is also passed any extra arguments that were
+  # provided to the `include` directive. It can be used to issue directives
+  # or define methods on the DSL, specific to the mixin.
   #
   # ## Example
   #
@@ -95,25 +103,40 @@ module Toys
     ## @private
     def self.included(mod)
       return if mod.respond_to?(:to_initialize)
-      mod.extend(ClassMethods)
+      mod.extend(ModuleMethods)
     end
 
     ##
-    # Class methods that will be added to a mixin module.
+    # Methods that will be added to a mixin module object.
     #
-    module ClassMethods
+    module ModuleMethods
       ##
-      # Provide the block that initializes this mixin.
+      # Provide a block that initializes this mixin when the tool is
+      # constructed.
       #
       def to_initialize(&block)
-        self.initializer = block
+        self.initialization_callback = block
+      end
+
+      ##
+      # Provide a block that modifies the tool class when the mixin is
+      # included.
+      #
+      def to_include(&block)
+        self.inclusion_callback = block
       end
 
       ##
       # You may alternately set the initializer block using this accessor.
       # @return [Proc]
       #
-      attr_accessor :initializer
+      attr_accessor :initialization_callback
+
+      ##
+      # You may alternately set the inclusion block using this accessor.
+      # @return [Proc]
+      #
+      attr_accessor :inclusion_callback
     end
   end
 end

data/lib/toys/runner.rb

@@ -161,7 +161,7 @@ module Toys
           tool.exit(-1)
         end
       end
-      @tool_definition.middleware_stack.reverse.each do |middleware|
+      @tool_definition.middleware_stack.reverse_each do |middleware|
         executor = make_executor(middleware, tool, executor)
       end
       catch(:result) do

data/lib/toys/standard_mixins/gems.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+# 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.
+;
+
+module Toys
+  module StandardMixins
+    ##
+    # Provides methods for installing and activating third-party gems. When
+    # this mixin is included, it provides a `gem` method that has the same
+    # effect as {Toys::Utils::Gems#activate}, so you can ensure a gem is
+    # present when running a tool. A `gem` directive is likewise added to the
+    # tool DSL itself, so you can also ensure a gem is present when defining a
+    # tool.
+    #
+    # You may make these methods available to your tool by including the
+    # following directive in your tool configuration:
+    #
+    #     include :gems
+    #
+    # If you pass additional options to the include directive, those are used
+    # to initialize settings for the gem install process. For example:
+    #
+    #     include :gems, output: $stdout, default_confirm: false
+    #
+    # This is a frontend for {Toys::Utils::Gems}. More information is
+    # available in that class's documentation.
+    #
+    module Gems
+      include Mixin
+
+      to_include do |opts = {}|
+        @__gems = Utils::Gems.new(opts)
+
+        def self.gems
+          @__gems
+        end
+
+        def self.gem(name, *requirements)
+          gems.activate(name, *requirements)
+        end
+      end
+
+      ##
+      # Returns a tool-wide instance of {Toys::Utils::Gems}.
+      #
+      def gems
+        self.class.gems
+      end
+
+      ##
+      # Activate the given gem.
+      #
+      # @param [String] name Name of the gem
+      # @param [String...] requirements Version requirements
+      #
+      def gem(name, *requirements)
+        self.class.gems.activate(name, *requirements)
+      end
+    end
+  end
+end

data/lib/toys/standard_mixins/highline.rb

@@ -74,7 +74,7 @@ module Toys
       end
 
       ##
-      # Returns a global highline instance
+      # Returns a tool-wide highline instance
       # @return [::HighLine]
       #
       def highline

data/lib/toys/standard_mixins/terminal.rb

@@ -69,7 +69,7 @@ module Toys
       end
 
       ##
-      # Returns a global terminal instance
+      # Returns a tool-wide terminal instance
       # @return [Toys::Utils::Terminal]
       #
       def terminal

data/lib/toys/tool.rb

@@ -259,17 +259,6 @@ module Toys
       end
     end
 
-    ##
-    # Activate the given gem. If it is not present, attempt to install it (or
-    # inform the user to update the bundle).
-    #
-    # @param [String] name Name of the gem
-    # @param [String...] requirements Version requirements
-    #
-    def gem(name, *requirements)
-      (@__data[Utils::Gems] ||= Utils::Gems.new).activate(name, *requirements)
-    end
-
     ##
     # Exit immediately with the given status code
     #

data/lib/toys/utils/gems.rb

@@ -58,22 +58,35 @@ module Toys
       end
 
       ##
-      # Activate the given gem.
+      # Activate the given gem. If it is not present, attempt to install it (or
+      # inform the user to update the bundle).
       #
       # @param [String] name Name of the gem
       # @param [String...] requirements Version requirements
-      # @param [Boolean] default_confirm Default response for the confirmation prompt
       #
-      def self.activate(name, *requirements, default_confirm: false)
-        new.activate(name, *requirements, default_confirm: default_confirm)
+      def self.activate(name, *requirements)
+        new.activate(name, *requirements)
       end
 
       ##
       # Create a new gem activator.
       #
-      def initialize(input: $stdin, output: $stderr)
+      # @param [IO] input Input IO
+      # @param [IO] output Output IO
+      # @param [Boolean] suppress_confirm Suppress the confirmation prompt and
+      #     just use the given `default_confirm` value. Default is false,
+      #     indicating the confirmation prompt appears by default.
+      # @param [Boolean] default_confirm Default response for the confirmation
+      #     prompt. Default is true.
+      #
+      def initialize(input: $stdin,
+                     output: $stderr,
+                     suppress_confirm: false,
+                     default_confirm: true)
         @terminal = Terminal.new(input: input, output: output)
         @exec = Exec.new
+        @suppress_confirm = suppress_confirm ? true : false
+        @default_confirm = default_confirm ? true : false
       end
 
       ##
@@ -82,18 +95,26 @@ module Toys
       #
       # @param [String] name Name of the gem
       # @param [String...] requirements Version requirements
-      # @param [Boolean] default_confirm Default response for the confirmation prompt
       #
-      def activate(name, *requirements, default_confirm: false)
+      def activate(name, *requirements)
         gem(name, *requirements)
-      rescue ::Gem::MissingSpecError
-        install_gem(name, requirements, default_confirm: default_confirm)
-      rescue ::Gem::LoadError => e
-        if ::ENV["BUNDLE_GEMFILE"]
-          raise GemfileUpdateNeededError.new(gem_requirements_text(name, requirements),
-                                             ::ENV["BUNDLE_GEMFILE"])
+      rescue ::Gem::LoadError => e1
+        is_missing_spec =
+          if defined?(::Gem::MissingSpecError)
+            e1.is_a?(::Gem::MissingSpecError)
+          else
+            e1.message.include?("Could not find")
+          end
+        if is_missing_spec
+          install_gem(name, requirements)
+          begin
+            gem(name, *requirements)
+          rescue ::Gem::LoadError => e2
+            report_error(name, requirements, e2)
+          end
+        else
+          report_error(name, requirements, e1)
         end
-        raise ActivationFailedError, e.message
       end
 
       private
@@ -102,44 +123,40 @@ module Toys
         "#{name.inspect}, #{requirements.map(&:inspect).join(', ')}"
       end
 
-      def install_gem(name, requirements, default_confirm: false)
+      def install_gem(name, requirements)
         requirements_text = gem_requirements_text(name, requirements)
-        response = @terminal.confirm("Gem needed: #{requirements_text}. Install?",
-                                     default: default_confirm)
+        response =
+          if @suppress_confirm
+            @default_confirm
+          else
+            @terminal.confirm("Gem needed: #{requirements_text}. Install?",
+                              default: @default_confirm)
+          end
         unless response
           raise InstallFailedError, "Canceled installation of needed gem: #{requirements_text}"
         end
-        version = find_best_version(name, requirements)
-        raise InstallFailedError, "No gem found matching #{requirements_text}." unless version
-        perform_install(name, version)
-        activate(name, *requirements)
+        perform_install(name, requirements)
       end
 
-      def find_best_version(name, requirements)
-        @terminal.spinner(leading_text: "Getting info on gem #{name.inspect}... ",
-                          final_text: "Done.\n") do
-          req = ::Gem::Requirement.new(*requirements)
-          result = @exec.capture(["gem", "query", "-q", "-r", "-a", "-e", name])
-          if result =~ /\(([\w\.,\s]+)\)/
-            $1.split(", ")
-              .map { |v| ::Gem::Version.new(v) }
-              .find { |v| !v.prerelease? && req.satisfied_by?(v) }
-          else
-            raise InstallFailedError, "Unable to determine existing versions of gem #{name.inspect}"
-          end
+      def perform_install(name, requirements)
+        result = @terminal.spinner(leading_text: "Installing gem #{name}... ",
+                                   final_text: "Done.\n") do
+          @exec.exec(["gem", "install", name, "--version", requirements.join(",")],
+                     out: :capture, err: :capture)
+        end
+        @terminal.puts(result.captured_out + result.captured_err)
+        if result.error?
+          raise InstallFailedError, "Failed to install gem #{name}"
         end
+        ::Gem::Specification.reset
       end
 
-      def perform_install(name, version)
-        @terminal.spinner(leading_text: "Installing gem #{name} #{version}... ",
-                          final_text: "Done.\n") do
-          result = @exec.exec(["gem", "install", name, "--version", version.to_s],
-                              out: :capture, err: :capture)
-          if result.error?
-            @terminal.puts(result.captured_out + result.captured_err)
-            raise InstallFailedError, "Failed to install gem #{name} #{version}"
-          end
+      def report_error(name, requirements, err)
+        if ::ENV["BUNDLE_GEMFILE"]
+          raise GemfileUpdateNeededError.new(gem_requirements_text(name, requirements),
+                                             ::ENV["BUNDLE_GEMFILE"])
         end
+        raise ActivationFailedError, err.message
       end
     end
   end

data/lib/toys/utils/terminal.rb

@@ -55,6 +55,12 @@ module Toys
     # *   An array of ANSI codes as integers.
     #
     class Terminal
+      ##
+      # Fatal terminal error.
+      #
+      class TerminalError < ::StandardError
+      end
+
       ## ANSI style code to clear styles
       CLEAR_CODE = "\e[0m"
 
@@ -207,23 +213,29 @@ module Toys
       # Confirm with the user.
       #
       # @param [String] prompt Prompt string. Defaults to `"Proceed?"`.
-      # @param [Boolean] default Default value (defaults to false).
+      # @param [Boolean,nil] default Default value, or `nil` for no default.
+      #     Uses `nil` if not specified.
       # @return [Boolean]
       #
-      def confirm(prompt = "Proceed?", default: false)
-        y = default ? "Y" : "y"
-        n = default ? "n" : "N"
+      def confirm(prompt = "Proceed?", default: nil)
+        y = default == true ? "Y" : "y"
+        n = default == false ? "n" : "N"
         write("#{prompt} (#{y}/#{n}) ")
-        resp = input.gets.to_s.strip
+        resp = input.gets
         case resp
         when /^y/i
           true
         when /^n/i
           false
-        when ""
+        when nil
+          raise TerminalError, "Cannot confirm because the input stream is at eof." if default.nil?
           default
         else
-          confirm("Please answer \"y\" or \"n\"")
+          if !resp.strip.empty? || default.nil?
+            confirm("Please answer \"y\" or \"n\"")
+          else
+            default
+          end
         end
       end
 

metadata

@@ -1,99 +1,99 @@
 --- !ruby/object:Gem::Specification
 name: toys-core
 version: !ruby/object:Gem::Version
-  version: 0.3.11
+  version: 0.4.0
 platform: ruby
 authors:
 - Daniel Azuma
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-07-02 00:00:00.000000000 Z
+date: 2018-07-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: minitest
+  name: highline
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.11'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.11'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: minitest-focus
+  name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '5.11'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '5.11'
 - !ruby/object:Gem::Dependency
-  name: minitest-rg
+  name: minitest-focus
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.2'
+        version: '1.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.2'
+        version: '1.1'
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: minitest-rg
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.55.0
+        version: '5.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.55.0
+        version: '5.2'
 - !ruby/object:Gem::Dependency
-  name: yard
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: 0.57.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: 0.57.2
 - !ruby/object:Gem::Dependency
-  name: highline
+  name: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 0.9.14
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 0.9.14
 description: Toys-Core is the command line tool framework underlying Toys. It can
   be used to create command line binaries using the internal Toys APIs.
 email:
@@ -131,6 +131,7 @@ files:
 - lib/toys/standard_middleware/show_root_version.rb
 - lib/toys/standard_mixins/exec.rb
 - lib/toys/standard_mixins/fileutils.rb
+- lib/toys/standard_mixins/gems.rb
 - lib/toys/standard_mixins/highline.rb
 - lib/toys/standard_mixins/terminal.rb
 - lib/toys/template.rb