Update Toys packages to '~> 0.22.0'

[renovate]

This PR contains the following updates:

Package	Change	Age	Confidence
toys (source, changelog)	'~> 0.19.0' → '~> 0.22.0'

---

Release Notes

dazuma/toys (toys)

v0.22.0: toys 0.22.0

v0.22.0 / 2026-05-05

Toys 0.22 is a major release focused on polish and cleanup in preparation for version 1.0. It includes a number of small breaking changes where needed to clean up the interfaces. (Note that many of the changes listed below are actually in the toys-core gem.)

Breaking interface changes:

• The static directive no longer "forces" creating of helper methods, instead using the same logic as the flag and argument directives. In particular, by default it will not create a method starting with underscore.
• Removed Toys::Settings and moved inheritable_helper_methods to a dedicated tool attribute. Use the basic_settings gem if you need the old settings class.
• Toys::Acceptor#create no longer takes a hash as the spec. (This was undocumented but worked previously.) To construct an object, pass the class as the main spec object, and the keyword arguments in the options.
• Toys::Acceptor::Enum#values now returns the values themselves instead of a zipped array that includes strings.
• Toys::FlagGroup::Base is no longer instantiable; use Toys::FlagGroup::Optional instead.
• The acceptor and display_name attributes of Toys::PositionalArg are no longer writable and must be set in the constructor.
• Toys::Completion#create no longer takes a hash as the spec. (This was undocumented but worked previously.) To construct an object, pass the class as the main spec object, and the keyword arguments in the options.
• The delegation_target attribute of Toys::ToolDefinition::DefaultCompletion is no longer writable and must be set in the constructor.
• You can no longer override a completion class using the :"" key. (This was undocumented but worked previously.) Just pass a fully constructed completion object if you need a custom object.
• The original Module#include method is now available in the DSL as include_module instead of super_include.
• Template classes no longer automatically include Toys::Context::Key. This behavior was undocumented and inconsistent between different ways of defining templates.
• Made Toys::CLI#load_tool return the block value rather than the exit_code.
• Made Toys::Testing#toys_load_tool return the block value rather than the exit_code
• Dropped undocumented Loader#add_path_set option to include individual source names in the relative_paths argument.
• Renamed use_less in the Toys::StandardMiddleware::ShowHelp constructor to use_pager, and added support for custom pagers.
• Renamed many of the methods in StandardUI to reduce confusion.
• Removed LoaderError and used ToolDefinitionError for those cases, as it was decided that the distinction was ambiguous and dependent on internal details.
• Removed ContextualError#underlying_error as it was synonymous with cause.
• Consolidated ContextualError public interface into a single capture method.
• ArgParser::ExtraArgumentsError now takes :arguments instead of :values, and provides an accessor for the same.
• ArgParser::ToolUnrecognizedError now takes :full_name instead of :values, and provides an accessor for the same.
• Renamed ArgParser::UsageError#full_message to message_with_suggestions to avoid overriding Exception#full_message.

New features:

• The range acceptor supports beginless and endless ranges.
• A custom source_name can be provided to Loader#add_path_set, Loader#add_git, and Loader#add_gem.
• The :gems mixin provides a context key for retrieving the underlying Toys::Utils::Gems service object.
• The :gems mixin provides an explicit Toys::Utils::Gems::ClassMethods module defining the directives added to the tool class.
• The activate and bundle methods in the Gems utility now return useful results.

Other fixes:

• The :update argument to the load_git directive had no effect if the :as argument was provided.
• FlagValueUnacceptableError and ArgValueUnacceptableError have their value set correctly.
• If a CLI has a static (shared) logger, creating a child with logger: nil actually clears it.
• Removed unused Toys::StandardMiddleware::ShowHelp::TOOL_NAME_KEY.
• ShowHelp middleware displays an error message instead of raising an exception when help cannot be generated due to a bad search regex.
• ArgParser::UsageError is now a proper exception.
• ContextualError does a better job of capturing relevant syntax errors.
• Various minor completion system fixes.

Several libraries under toys/utils were extracted into their own gems. The current code remains under Toys::Utils as a vendored copy of the external gem, so the extracted gems are not actually dependencies of Toys. The affected libraries are:

• Toys::Utils::Exec which was extracted to the gem exec_service.
• Toys::Utils::XDG which was extracted to the gem simple_xdg.
• Toys::Utils::GitCache which was extracted to the gem git_cache.

Finally, a variety of clarifications and fixes were made to the reference documentation, readme, and user's guide.

v0.21.0: toys 0.21.0

v0.21.0 / 2026-03-23

This release includes a variety of small fixes and updates toward improving product polish in preparation for a 1.0 release. It focuses on the following areas:

• Updates to the help system
  • FIXED / BREAKING CHANGE: The help middleware omits the subtool filter flags on runnable tools that have subtools
• Updates to bundler integration
  • FIXED: Fixed some cleanup issues when bundler setup fails
• Updates to the exec utility
  • ADDED: Support for the :unbundle option which removes any existing bundle for a subprocess
  • FIXED: Fixed several thread-safety issues with the controller
  • FIXED: The result callback is now called in background mode if the result is never explicitly obtained from the controller
• Updates to the git_cache utility
  • ADDED: Support for filtering lookups of ref and source info
  • ADDED: Support for SHA-256 repos
  • FIXED: Fixed failure to get a parent directory after previously getting a descendant object
  • FIXED: GitCache no longer unnecessarily sets the write bit on files copied into a specified directory
  • FIXED: GitCache no longer cleans out existing files when writing to a shared source, which should reduce issues with concurrent clients
• Updates to the XDG utility
  • FIXED / BREAKING CHANGE: The XDG utility returns an empty array (instead of the system defaults) from the corresponding methods if XDG_DATA_DIRS or XDG_CONFIG_DIRS is nonempty but contains only relative paths
  • ADDED: Provided lookup_state and lookup_cache methods on the XDG utility
• Updates to the settings system:
  • FIXED: Block certain reserved names from being used as Settings field names
  • FIXED: Fixed Settings#load_data! when subclassing another settings class
  • FIXED: Reject non-String values in Settings regexp type spec
  • FIXED: Settings guards against unknown classes when loading YAML on older Ruby versions
  • FIXED: Settings guards against ILLEGAL_VALUE being passed to range.member?
  • FIXED: Settings does a better job choosing exact-match values when using a union type
  • FIXED: Settings reject non-numeric strings in Integer and Float converters
  • FIXED: Settings propagates nested group errors in Settings#load_data!

v0.20.0: toys 0.20.0

v0.20.0 / 2026-03-09

Toys 0.20 is a major release with several new features and a number of fixes, including a few minor breaking changes.

Changes in the :minitest template:

• BREAKING CHANGE: Tools produced by the :minitest template default to looking for test files of the forms *_test.rb and test_*.rb instead of test*.rb.
• NEW: The :minitest template supports installing specified gems without using bundler.
• NEW: Tools produced by the :minitest template provide command line arguments for overriding the gem installation or bundler settings.
• NEW: Tools produced by the :minitest template recognize --include as an alias for --name. This matches recent versions of minitest.
• NEW: The :minitest template generates more comprehensive documentation.
• NEW: The minitest tool template now requires "minitest/autorun" before loading tests, so tests don't have to do so themselves.
• BREAKING API CHANGE: Toys::Templates::Minitest::DEFAULT_GEM_VERSION_REQUIREMENTS is now a hash that covers multiple gems rather than just the minitest gem
• FIXED: The minitest template no longer exceeds command line length limits if the list of test files is extremely long.

New functionality in the :rspec template:

• NEW: The :rspec template supports installing specified gems without using bundler.
• NEW: Tools produced by the :rspec template provide command line arguments for overriding the gem installation or bundler settings.
• NEW: Tools produced by the :rspec template recognize the --example-matches flag, and can handle multiple --example and --tag flags.
• NEW: The :rspec template generates more comprehensive documentation.
• BREAKING API CHANGE: Toys::Templates::Rspec::DEFAULT_GEM_VERSION_REQUIREMENTS is now a hash that covers potentially multiple gems

New functionality in the :clean template:

• The :clean template supports specifying certain gitignored files to preserve.
• The :clean template is more robust against concurrent modification and works better with large git repos.

New functionality in the system test builtin tool:

• BREAKING CHANGE: The system test builtin looks for test files of the form *_test.rb in addition to test_*.rb.
• The system test builtin uses bundler to install gems if a Gemfile is present in the .test directory.
• The system test builtin supports flags that can specify arbitrary gems to load.

Updates to the Exec mixin and library:

• NEW: The new Toys::Utils::Exec::Result#effective_result method provides a reasonable integer result code even when a process terminates via signal or fails to start at all.
• BREAKING API CHANGE: :cli is no longer a legal config option.
• BREAKING API CHANGE: An options hash is no longer passed to the proc when executing a proc using a fork.
• BREAKING API CHANGE: Passing an IO object as an input or output stream no longer closes it afterward.
• BREAKING API CHANGE: Toys::Utils::Exec::Controller#result no longer preemptively (and prematurely) closes the controller input stream
• FIXED: The :unsetenv_others option now works properly when executing a proc using a fork.
• FIXED: Environment variable values specified as nil are now correctly unset when executing a proc using a fork.
• FIXED: Fixed a rare concurrency issue if multiple threads concurrently get the result from a controller.

Other changes:

• NEW: Native tab completion for zsh.
• NEW: The :bundler mixin supports "manual" bundle setup, allowing bundler decisions to be deferred to execution time
• FIXED: The :bundler mixin will not attempt to add the pathname gem to generated Gemfiles when running on TruffleRuby. This caused issues because TruffleRuby includes a special version of the gem and cannot install the one from Rubygems.
• FIXED: ContextualError no longer overrides Exception#cause, which could confuse TruffleRuby.
• DOCUMENTATION: Updated user guide to cover zsh completion and manual bundler setup
• DOCUMENTATION: Some reorganization and cleanup in the user guide

---

Configuration

📅 Schedule: (UTC)

• Branch creation
  • At any time (no schedule defined)
• Automerge
  • At any time (no schedule defined)

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.