toys 0.14.1 → 0.14.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fc447cfb397077cb652af00a19031a4b1c439ed483117fecf9e855bf286dbeb5
-  data.tar.gz: 951fb9c8104eb35ac1275efd2c0e7e0c784538b9b878b560861ea7bcb380144a
+  metadata.gz: 5605477c7993fad15f1c79740f8de6b90f4aef19becdc00a236e71853cb4d9a8
+  data.tar.gz: 1c63369d5c4302356f412e25904bd6db43ca93b9896c687c6ae5bbfd4fe24fc8
 SHA512:
-  metadata.gz: 1fcdf6af97a7c1516f37760206aa67445f522df7fe0898e61a0ddbc568411b404bab109e68cbdedf21e755bf7a2bf6e3be7c4deb3a52a9e8e36fe29db0148e6b
-  data.tar.gz: fbaaea69be3d5ebffe89167ab01bd51dcab5006239fb20ba00dab31c14f3d0f335cac57c81aad541519e355ae699a5b8c2ed23f8c8ab4db8b8ed64ff239c2c9b
+  metadata.gz: c312c18f2fa8d57f6dbeb8def6b434a611030387e289a370bcb96faadf90a49b948cfc7ac17b14f9e7b97a942a85b133d384ad37705aed9b833fca3f650517d1
+  data.tar.gz: 1f7125dbf036acb25b0352de30b68f95c229610572c754b8cdf3e1c633e03f5a6318eeb5de56df1d229402f4915d16aacb794d62fcd571007a604aec4ad6070f

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release History
 
+### v0.14.2 / 2022-10-09
+
+* ADDED: The tool directive supports the delegate_relative argument, as a preferred alternative over alias_tool.
+* FIXED: The toys file reference now properly appears in error messages on Ruby 3.1.
+* FIXED: Error messages show the correct toys file line number on TruffleRuby.
+* FIXED: Inspect strings for tool classes are less opaque and include the tool name.
+* FIXED: The presence of an acceptor forces an ambiguous flag to take a value rather than erroring.
+
 ### v0.14.1 / 2022-10-03
 
 * FIXED: Fixed a crash due to a missing file in the gem

data/core-docs/toys/core.rb

@@ -9,6 +9,6 @@ module Toys
     # Current version of Toys core.
     # @return [String]
     #
-    VERSION = "0.14.1"
+    VERSION = "0.14.2"
   end
 end

data/core-docs/toys/dsl/tool.rb

@@ -263,7 +263,8 @@ module Toys
       #       end
       #     end
       #
-      # The following example defines a tool that runs one of its subtools.
+      # The following example uses `delegate_to` to define a tool that runs one
+      # of its subtools.
       #
       #     tool "test", delegate_to: ["test", "unit"] do
       #       tool "unit" do
@@ -284,19 +285,22 @@ module Toys
       #     delegate to another tool, specified by the full path. This path may
       #     be given as an array of strings, or a single string possibly
       #     delimited by path separators.
+      # @param delegate_relative [String,Array<String>] Optional. Similar to
+      #     delegate_to, but takes a delegate name relative to the context in
+      #     which this tool is being defined.
       # @param block [Proc] Defines the subtool.
       # @return [self]
       #
-      def tool(words, if_defined: :combine, delegate_to: nil, &block)
+      def tool(words, if_defined: :combine, delegate_to: nil, delegate_relative: nil, &block)
         # Source available in the toys-core gem
       end
 
       ##
       # Create an alias, representing an "alternate name" for a tool.
       #
-      # This is functionally equivalent to creating a subtool with the
-      # `delegate_to` option, except that `alias_tool` takes a _relative_ name
-      # for the delegate.
+      # Note: This is functionally equivalent to creating a tool with the
+      # `:delegate_relative` option. As such, `alias_tool` is considered
+      # deprecated.
       #
       # ### Example
       #
@@ -309,20 +313,24 @@ module Toys
       #       end
       #     end
       #     alias_tool "t", "test"
+      #     # Note: the following is preferred over alias_tool:
+      #     # tool "t", delegate_relative: "test"
       #
       # @param word [String] The name of the alias
       # @param target [String,Array<String>] Relative path to the target of the
       #     alias. This path may be given as an array of strings, or a single
       #     string possibly delimited by path separators.
       # @return [self]
+      # @deprecated Use {#tool} and pass `:delegate_relative` instead
       #
       def alias_tool(word, target)
         # Source available in the toys-core gem
       end
 
       ##
-      # Causes the current tool to delegate to another tool. When run, it
-      # simply invokes the target tool with the same arguments.
+      # Causes the current tool to delegate to another tool, specified by the
+      # full tool name. When run, it simply invokes the target tool with the
+      # same arguments.
       #
       # ### Example
       #

data/docs/guide.md

@@ -3171,6 +3171,10 @@ a namespace to delegate to one of its subtools:
 
 Now `toys test` delegates to, and thus has the same effect as `toys test unit`.
 
+It is also possible to specify the delegate via _relative_ name, using the
+`:delegate_relative` keyword argument. This can be helpful if you have a set of
+tools and delegates that are meant to be reused under different namespaces.
+
 ### Applying directives to multiple tools
 
 Sometimes a group of tools are set up similarly or share a set of flags,

data/lib/toys/version.rb

@@ -5,5 +5,5 @@ module Toys
   # Current version of the Toys command line executable.
   # @return [String]
   #
-  VERSION = "0.14.1"
+  VERSION = "0.14.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: toys
 version: !ruby/object:Gem::Version
-  version: 0.14.1
+  version: 0.14.2
 platform: ruby
 authors:
 - Daniel Azuma
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-10-03 00:00:00.000000000 Z
+date: 2022-10-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: toys-core
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.14.1
+        version: 0.14.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.14.1
+        version: 0.14.2
 description: Toys is a configurable command line tool. Write commands in Ruby using
   a simple DSL, and Toys will provide the command line executable and take care of
   all the details such as argument parsing, online help, and error reporting. Toys
@@ -120,10 +120,10 @@ homepage: https://github.com/dazuma/toys
 licenses:
 - MIT
 metadata:
-  changelog_uri: https://dazuma.github.io/toys/gems/toys/v0.14.1/file.CHANGELOG.html
+  changelog_uri: https://dazuma.github.io/toys/gems/toys/v0.14.2/file.CHANGELOG.html
   source_code_uri: https://github.com/dazuma/toys/tree/main/toys
   bug_tracker_uri: https://github.com/dazuma/toys/issues
-  documentation_uri: https://dazuma.github.io/toys/gems/toys/v0.14.1
+  documentation_uri: https://dazuma.github.io/toys/gems/toys/v0.14.2
 post_install_message: 
 rdoc_options: []
 require_paths: