sleeping_king_studios-tools 1.1.1 → 1.2.0.rc.0

data/lib/sleeping_king_studios/tools/toolbelt.rb

@@ -4,6 +4,17 @@ require 'sleeping_king_studios/tools'
 
 module SleepingKingStudios::Tools
   # Helper object for quick access to all available tools.
+  #
+  # Specific tools can be accessed by name. For example, to access the
+  # configured instance of ArrayTools, call Toolbelt#array_tools. Certain tools
+  # also define a shorthand - for example, the array_tools instance can also be
+  # accessed using Toolbelt#ary.
+  #
+  # @example
+  #   toolbelt = SleepingKingStudios::Tools::Toolbelt.new
+  #
+  #   toolbelt.array_tools.pluralize('light')
+  #   #=> 'lights'
   class Toolbelt < BasicObject
     # @return [SleepingKingStudios::Tools::Toolbelt] a memoized instance of the
     #   toolbelt class.
@@ -11,42 +22,64 @@ module SleepingKingStudios::Tools
       @instance ||= new
     end
 
-    # @param deprecation_strategy [String] The name of the strategy used when
+    # @param deprecation_caller_depth [Integer] the number of backtrace lines to
+    #   display when outputting a deprecation warning.
+    # @param deprecation_strategy [String] the name of the strategy used when
     #   deprecated code is called. Must be 'ignore', 'raise', or 'warn'.
-    # @param inflector [Object] An object that conforms to the interface used
-    #   by SleepingKingStudios::Tools::Toolbox::Inflector, such as
-    #   ActiveSupport::Inflector .
-    def initialize(deprecation_strategy: nil, inflector: nil)
+    # @param inflector [Object] service object for inflecting strings. The
+    #   inflector must be an object that conforms to the interface used by
+    #   by SleepingKingStudios::Tools::Toolbox::Inflector, such as an instance
+    #   of ActiveSupport::Inflector .
+    def initialize( # rubocop:disable Metrics/MethodLength
+      deprecation_caller_depth: nil,
+      deprecation_strategy:     nil,
+      inflector:                nil
+    )
       @array_tools   = ::SleepingKingStudios::Tools::ArrayTools.new
       @assertions    = ::SleepingKingStudios::Tools::Assertions.new
-      @core_tools    = ::SleepingKingStudios::Tools::CoreTools.new(
-        deprecation_strategy: deprecation_strategy
-      )
+      @core_tools    =
+        ::SleepingKingStudios::Tools::CoreTools.new(
+          deprecation_caller_depth:,
+          deprecation_strategy:
+        )
       @hash_tools    = ::SleepingKingStudios::Tools::HashTools.new
       @integer_tools = ::SleepingKingStudios::Tools::IntegerTools.new
       @object_tools  = ::SleepingKingStudios::Tools::ObjectTools.new
       @string_tools  =
-        ::SleepingKingStudios::Tools::StringTools.new(inflector: inflector)
+        ::SleepingKingStudios::Tools::StringTools.new(inflector:)
     end
 
+    # @return [SleepingKingStudios::Tools::ArrayTools] tools for working with
+    #   array-like enumerable objects.
     attr_reader :array_tools
+    alias ary array_tools
 
+    # @return [SleepingKingStudios::Tools::Assertions] methods for asserting on
+    #   the state of a function or application.
     attr_reader :assertions
 
+    # @return [SleepingKingStudios::Tools::CoreTools] tools for working with an
+    #   application or working environment.
     attr_reader :core_tools
 
+    # @return [SleepingKingStudios::Tools::HashTools] tools for working with
+    #   hash-like enumerable objects.
     attr_reader :hash_tools
+    alias hsh hash_tools
 
+    # @return [SleepingKingStudios::Tools::IntegerTools] tools for working with
+    #   integers.
     attr_reader :integer_tools
+    alias int integer_tools
 
+    # @return [SleepingKingStudios::Tools::ObjectTools] low-level tools for
+    #   working with objects.
     attr_reader :object_tools
+    alias obj object_tools
 
+    # @return [SleepingKingStudios::Tools::ObjectTools] tools for working with
+    #   strings.
     attr_reader :string_tools
-
-    alias ary array_tools
-    alias hsh hash_tools
-    alias int integer_tools
-    alias obj object_tools
     alias str string_tools
 
     # @return [String] a human-readable representation of the object.

data/lib/sleeping_king_studios/tools/toolbox/constant_map.rb

@@ -7,11 +7,29 @@ require 'sleeping_king_studios/tools/toolbox'
 
 module SleepingKingStudios::Tools::Toolbox
   # Provides an enumerable interface for defining a group of constants.
+  #
+  # @example
+  #   UserRoles = ConstantMap.new(
+  #     {
+  #       GUEST: 'guest',
+  #       USER:  'user',
+  #       ADMIN: 'admin'
+  #     }
+  #   )
+  #
+  #   UserRoles::GUEST
+  #   #=> 'guest'
+  #
+  #   UserRoles.user
+  #   #=> 'user'
+  #
+  #   UserRoles.all
+  #   #=> { :GUEST => 'guest', :USER => 'user', :ADMIN => 'admin' }
   class ConstantMap < Module
     extend  Forwardable
     include Enumerable
 
-    # @param constants [Hash] The constants to define.
+    # @param constants [Hash] the constants to define.
     def initialize(constants)
       super()
 
@@ -36,27 +54,27 @@ module SleepingKingStudios::Tools::Toolbox
     #   Iterates through the defined constants, yielding the name and value of
     #   each constant to the block.
     #
-    #   @yieldparam key [Symbol] The name of the constant.
-    #   @yieldparam value [Object] The value of the constant.
+    #   @yieldparam key [Symbol] the name of the constant.
+    #   @yieldparam value [Object] the value of the constant.
 
     # @!method each_key
     #   Iterates through the defined constants, yielding the name of each
     #   constant to the block.
     #
-    #   @yieldparam key [Symbol] The name of the constant.
+    #   @yieldparam key [Symbol] the name of the constant.
 
     # @!method each_pair
     #   Iterates through the defined constants, yielding the name and value of
     #   each constant to the block.
     #
-    #   @yieldparam key [Symbol] The name of the constant.
-    #   @yieldparam value [Object] The value of the constant.
+    #   @yieldparam key [Symbol] the name of the constant.
+    #   @yieldparam value [Object] the value of the constant.
 
     # @!method each_value
     #   Iterates through the defined constants, yielding the value of each
     #   constant to the block.
     #
-    #   @yieldparam value [Object] The value of the constant.
+    #   @yieldparam value [Object] the value of the constant.
 
     # @!method keys
     #   @return [Array] the names of the defined constants.
@@ -68,10 +86,11 @@ module SleepingKingStudios::Tools::Toolbox
     attr_reader :to_h
     alias all to_h
 
-    # Freezes the constant map and recursively freezes every constant value
-    # using ObjectTools#deep_freeze.
+    # Freezes the constant map and recursively freezes every constant value.
     #
-    # @see ObjectTools#deep_freeze
+    # @return [self] the constant map.
+    #
+    # @see SleepingKingStudios::Tools::ObjectTools#deep_freeze
     def freeze
       super
 

data/lib/sleeping_king_studios/tools/toolbox/inflector/rules.rb

@@ -7,14 +7,13 @@ require 'sleeping_king_studios/tools/toolbox'
 class SleepingKingStudios::Tools::Toolbox::Inflector
   # Rules for inflecting words.
   class Rules
-    # @param irregular_words [Hash<String, String>] Hash of irregular word
-    #   pairs in singular => plural order, e.g. "child" => "children".
-    # @param plural_rules [Array<Array<(Regexp, String)>>] Rules for
+    # @param irregular_words [Hash<String, String>] irregular word pairs in
+    #   singular => plural order, e.g. "child" => "children".
+    # @param plural_rules [Array<Array<(Regexp, String)>>] rules for
     #   pluralizing words.
-    # @param singular_rules [Array<Array<(Regexp, String)>>] Rules for
+    # @param singular_rules [Array<Array<(Regexp, String)>>] rules for
     #   singularizing words.
-    # @param uncountable_words [Array<String>] List of uncountable words,
-    #   e.g. "data".
+    # @param uncountable_words [Array<String>] uncountable words e.g. "data".
     def initialize(
       irregular_words:   nil,
       plural_rules:      nil,
@@ -30,29 +29,29 @@ class SleepingKingStudios::Tools::Toolbox::Inflector
       @irregular_words_reversed = reverse_hash(@irregular_words)
     end
 
-    # @return [Array<Array<(String, String)>] Hash of irregular word pairs in
+    # @return [Array<Array<(String, String)>>] irregular word pairs in
     #   singular => plural order.
     attr_reader :irregular_words
 
-    # @return [Array<Array<(String, String)>] Hash of irregular word pairs in
-    #   plural => singular order.
+    # @return [Array<Array<(String, String)>>] irregular word pairs in plural =>
+    #   singular order.
     attr_reader :irregular_words_reversed
 
-    # @return [Array<Array<(Regexp, String)>>] Rules for pluralizing words.
+    # @return [Array<Array<(Regexp, String)>>] rules for pluralizing words.
     attr_reader :plural_rules
 
-    # @return [Array<Array<(Regexp, String)>>] Rules for singularizing words.
+    # @return [Array<Array<(Regexp, String)>>] rules for singularizing words.
     attr_reader :singular_rules
 
-    # @return [Array<String>] List of uncountable words.
+    # @return [Array<String>] uncountable words.
     attr_reader :uncountable_words
 
     # Defines an irregular word pair.
     #
-    # @param singular [String] The singular form of the word.
-    # @param plural [String] The plural form of the word.
+    # @param singular [String] the singular form of the word.
+    # @param plural [String] the plural form of the word.
     #
-    # @return [Rules] The rules object.
+    # @return [self] the rules object.
     def define_irregular_word(singular, plural)
       validate_string(singular)
       validate_string(plural)
@@ -65,10 +64,10 @@ class SleepingKingStudios::Tools::Toolbox::Inflector
 
     # Defines a pluralization rule.
     #
-    # @param pattern [Regexp] The pattern to match.
-    # @param replace [String] The string to replace.
+    # @param pattern [Regexp] the pattern to match.
+    # @param replace [String] the string to replace.
     #
-    # @return [Rules] The rules object.
+    # @return [self] the rules object.
     def define_plural_rule(pattern, replace)
       validate_pattern(pattern)
       validate_string(replace, as: 'replace')
@@ -80,10 +79,10 @@ class SleepingKingStudios::Tools::Toolbox::Inflector
 
     # Defines a singularization rule.
     #
-    # @param pattern [Regexp] The pattern to match.
-    # @param replace [String] The string to replace.
+    # @param pattern [Regexp] the pattern to match.
+    # @param replace [String] the string to replace.
     #
-    # @return [Rules] The rules object.
+    # @return [self] the rules object.
     def define_singular_rule(pattern, replace)
       validate_pattern(pattern)
       validate_string(replace, as: 'replace')
@@ -95,9 +94,9 @@ class SleepingKingStudios::Tools::Toolbox::Inflector
 
     # Defines an uncountable word.
     #
-    # @param word [String] The uncountable word.
+    # @param word [String] the uncountable word.
     #
-    # @return [Rules] The rules object.
+    # @return [self] the rules object.
     def define_uncountable_word(word)
       validate_string(word)
 
@@ -106,7 +105,7 @@ class SleepingKingStudios::Tools::Toolbox::Inflector
       self
     end
 
-    # @return [String] A human-readable representation of the rules object.
+    # @return [String] a human-readable representation of the rules object.
     def inspect
       "#<SleepingKingStudios::Tools::Toolbox::Inflector::Rules:#{object_id}>"
     end

data/lib/sleeping_king_studios/tools/toolbox/inflector.rb

@@ -5,9 +5,17 @@ require 'forwardable'
 require 'sleeping_king_studios/tools/toolbox'
 
 module SleepingKingStudios::Tools::Toolbox
-  # Transforms words (e.g. from singular to plural).
+  # Service object for transforming strings.
   #
-  # Should maintain the same interface as ActiveSupport::Inflector.
+  # Internally, an instance of this class is used to StringTools to perform
+  # string transformations.
+  #
+  # This class should define a compatible interface with
+  # ActiveSupport::Inflector, i.e. all methods defined on Toolbox::Inflector
+  # should have a corresponding method on ActiveSupport::Inflector with a
+  # superset of the parameters. (The reverse is *not* true).
+  #
+  # @see SleepingKingStudios::Tools::StringTools.
   class Inflector
     extend Forwardable
 
@@ -27,38 +35,41 @@ module SleepingKingStudios::Tools::Toolbox
       :singular_rules,
       :uncountable_words
 
-    # @return [Rules] An object defining the transformation rules.
+    # @param rules [SleepingKingStudios::Tools::Toobox::Inflector::Rules] an
+    #   object defining the transformation rules.
     def initialize(rules: nil)
       @rules = rules || Rules.new
     end
 
-    # @return [Rules] The defined rules object for the inflector.
+    # @return [SleepingKingStudios::Tools::Toobox::Inflector::Rules] an object
+    #   defining the transformation rules.
     attr_reader :rules
 
-    # Transforms the word to CamelCase.
+    # Converts a lowercase, underscore-separated string to CamelCase.
     #
-    # @param word [String] The word to transform.
-    # @param uppercase_first_letter [Boolean] If true, the first letter is
+    # @param word [String] the word to transform.
+    # @param uppercase_first_letter [Boolean] if true, the first letter is
     #   capitalized. Defaults to true.
     #
-    # @return [String] The word in CamelCase.
+    # @return [String] the word in CamelCase.
     def camelize(word, uppercase_first_letter = true) # rubocop:disable Style/OptionalBooleanParameter
       return '' if word.nil? || word.empty?
 
-      word = word.to_s.gsub(/(\b|[_-])([a-z])/) { Regexp.last_match(2).upcase }
+      word =
+        word
+        .to_s
+        .gsub(/(\b|[_-]+)([a-z])/) { Regexp.last_match(2).upcase }
+        .gsub(/[_-]+/, '')
 
       (uppercase_first_letter ? word[0].upcase : word[0].downcase) + word[1..]
     end
 
-    # rubocop:disable Metrics/AbcSize
-    # rubocop:disable Metrics/CyclomaticComplexity
-
     # Transforms the word to a plural, lowercase form.
     #
-    # @param word [String] The word to transform.
+    # @param word [String] the word to transform.
     #
-    # @return [String] The word in plural form.
-    def pluralize(word)
+    # @return [String] the word in plural form.
+    def pluralize(word) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity
       return '' if word.nil? || word.empty?
 
       normalized = word.to_s.strip.downcase
@@ -77,14 +88,12 @@ module SleepingKingStudios::Tools::Toolbox
 
       word
     end
-    # rubocop:enable Metrics/AbcSize
-    # rubocop:enable Metrics/CyclomaticComplexity
 
     # Transforms the word to a singular, lowercase form.
     #
-    # @param word [String] The word to transform.
+    # @param word [String] the word to transform.
     #
-    # @return [String] The word in singular form.
+    # @return [String] the word in singular form.
     def singularize(word) # rubocop:disable Metrics/MethodLength
       return '' if word.nil? || word.empty?
 
@@ -109,16 +118,17 @@ module SleepingKingStudios::Tools::Toolbox
     #
     # @param word [String] the word to transform.
     #
-    # @return [String] The word in underscored form.
+    # @return [String] the word in underscored form.
     def underscore(word)
       return '' if word.nil? || word.empty?
 
-      word = word.to_s.gsub(/([A-Z\d]+)([A-Z][a-z])/, '\1_\2')
-
-      word.gsub!(/([a-z\d])([A-Z])/, '\1_\2')
-      word.tr!('-', '_')
-      word.downcase!
       word
+        .to_s
+        .gsub(/([A-Z0-9\d]+)([A-Z][a-z])/, '\1_\2')
+        .gsub(/([a-z\d])([A-Z0-9])/, '\1_\2')
+        .gsub(/\A_+|_+\z/, '')
+        .tr('-', '_')
+        .downcase
     end
   end
 end

data/lib/sleeping_king_studios/tools/toolbox/mixin.rb

@@ -4,26 +4,98 @@ require 'sleeping_king_studios/tools/toolbox'
 
 module SleepingKingStudios::Tools::Toolbox
   # Implements recursive inheritance of both class and instance methods.
+  #
+  # @example Defining A Mixin
+  #   module Widgets
+  #     extend SleepingKingStudios::Tools::Toolbox::Mixin
+  #
+  #     module ClassMethods
+  #       def widget_types
+  #         %w(gadget doohickey thingamabob)
+  #       end
+  #     end
+  #
+  #     def widget?(widget_type)
+  #       self.class.widget_types.include?(widget_type)
+  #     end
+  #   end
+  #
+  # @example Including A Mixin
+  #   module WidgetBuilding
+  #     extend  SleepingKingStudios::Tools::Toolbox::Mixin
+  #     include Widgets
+  #
+  #     def build_widget(widget_type)
+  #       raise ArgumentError, 'not a widget', caller unless widget?(widget_type)
+  #
+  #       Widget.new(widget_type)
+  #     end
+  #   end
+  #
+  # @example Using A Mixin
+  #   class WidgetFactory
+  #     include WidgetBuilding
+  #   end
+  #
+  #   factory = WidgetFactory.new
+  #
+  #   factory.build_widget('gadget')
+  #   #=> Widget
+  #
+  #   WidgetFactory.widget_types
+  #   #=> ['gadget', 'doohickey', 'thingamabob']
   module Mixin
-    # @api private
-    def self.mixin?(mod)
-      return false unless mod.is_a?(Module)
+    # Checks if the given module is itself a Mixin.
+    #
+    # @param othermod [Object] the object or module to inspect.
+    #
+    # @return [true, false] true if the other object is a Module that extends
+    #   Mixin; otherwise false.
+    def self.mixin?(othermod)
+      return false unless othermod.is_a?(Module)
 
-      mod.singleton_class.include?(self)
+      othermod.singleton_class.include?(self)
     end
 
-    # @private
-    def included(other)
+    # Callback invoked whenever the receiver is included in another module.
+    #
+    # @param othermod [Module] the other class or module in which the mixin is
+    #   included.
+    #
+    # @return [void]
+    def included(othermod)
       return super unless defined?(self::ClassMethods)
 
-      if SleepingKingStudios::Tools::Toolbox::Mixin.mixin?(other)
-        unless other.constants(false).include?(:ClassMethods)
-          other.const_set(:ClassMethods, Module.new)
+      if SleepingKingStudios::Tools::Toolbox::Mixin.mixin?(othermod)
+        unless othermod.constants(false).include?(:ClassMethods)
+          othermod.const_set(:ClassMethods, Module.new)
         end
 
-        other::ClassMethods.include(self::ClassMethods)
+        othermod::ClassMethods.include(self::ClassMethods)
       else
-        other.extend self::ClassMethods
+        othermod.extend self::ClassMethods
+      end
+
+      super
+    end
+
+    # Callback invoked whenever the receiver is prepended into another module.
+    #
+    # @param othermod [Module] the other class or module in which the mixin is
+    #   prepended.
+    #
+    # @return [void]
+    def prepended(othermod)
+      return super unless defined?(self::ClassMethods)
+
+      if SleepingKingStudios::Tools::Toolbox::Mixin.mixin?(othermod)
+        unless othermod.constants(false).include?(:ClassMethods)
+          othermod.const_set(:ClassMethods, Module.new)
+        end
+
+        othermod::ClassMethods.prepend(self::ClassMethods)
+      else
+        othermod.singleton_class.prepend(self::ClassMethods)
       end
 
       super

data/lib/sleeping_king_studios/tools/toolbox/semantic_version.rb

@@ -3,8 +3,7 @@
 require 'sleeping_king_studios/tools/toolbox'
 
 module SleepingKingStudios::Tools::Toolbox
-  # Helper for generating semantic version strings with optional prerelease and
-  # build parameters.
+  # Helper for generating semantic version strings.
   #
   # @example
   #   module Version
@@ -15,15 +14,24 @@ module SleepingKingStudios::Tools::Toolbox
   #     PATCH = 4
   #     PRERELEASE = 'beta'
   #     BUILD = 1
-  #   end # module
+  #   end
+  #
+  #   VERSION = Version.to_version
+  #   #=> '3.1.4-beta+1'
   #
   #   VERSION = Version.to_gem_version
+  #   #=> '3.1.4.beta.1'
   #
   # @see http://semver.org
   module SemanticVersion
+    UNDEFINED = Object.new.freeze
+    private_constant :UNDEFINED
+
     # Error class for handling missing constants in a version definition.
     class InvalidVersionError < StandardError; end
 
+    # Generates a RubyGems-compatible version string.
+    #
     # Concatenates the MAJOR, MINOR, and PATCH constant values with PRERELEASE
     # and BUILD (if available) to generate a modified semantic version string
     # compatible with Rubygems. The major, minor, patch, prerelease, and build
@@ -38,16 +46,17 @@ module SleepingKingStudios::Tools::Toolbox
     #     PATCH = 4
     #     PRERELEASE = 'beta'
     #     BUILD = 1
-    #   end # module
+    #   end
     #
     #   VERSION = Version.to_gem_version
     #   #=> '3.1.4.beta.1'
     #
-    # @return [String] The modified semantic version string.
+    # @return [String] the modified semantic version string.
     #
-    # @raise InvalidVersionError If MAJOR, MINOR, or PATCH is undefined.
+    # @raise [SleepingKingStudios::Tools::Toolbox::SemanticVersion::InvalidVersionError]
+    #   if MAJOR, MINOR, or PATCH is undefined.
     def to_gem_version
-      str = +"#{const_fetch :MAJOR}.#{const_fetch :MINOR}.#{const_fetch :PATCH}"
+      str = "#{const_fetch :MAJOR}.#{const_fetch :MINOR}.#{const_fetch :PATCH}"
 
       prerelease = const_fetch(:PRERELEASE, nil)
       str << ".#{prerelease}" unless prerelease.nil? || prerelease.empty?
@@ -58,6 +67,8 @@ module SleepingKingStudios::Tools::Toolbox
       str
     end
 
+    # Generates a standard Semver version string.
+    #
     # Concatenates the MAJOR, MINOR, and PATCH constant values with PRERELEASE
     # and BUILD (if available) to generate a semantic version string. The
     # major, minor, and patch values are separated by dots (.), then the
@@ -73,16 +84,17 @@ module SleepingKingStudios::Tools::Toolbox
     #     PATCH = 4
     #     PRERELEASE = 'beta'
     #     BUILD = 1
-    #   end # module
+    #   end
     #
     #   VERSION = Version.to_version
     #   #=> '3.1.4-beta+1'
     #
-    # @return [String] The semantic version string.
+    # @return [String] the semantic version string.
     #
-    # @raise InvalidVersionError If MAJOR, MINOR, or PATCH is undefined.
+    # @raise [SleepingKingStudios::Tools::Toolbox::SemanticVersion::InvalidVersionError]
+    #   if MAJOR, MINOR, or PATCH is undefined.
     def to_version
-      str = +"#{const_fetch :MAJOR}.#{const_fetch :MINOR}.#{const_fetch :PATCH}"
+      str = "#{const_fetch :MAJOR}.#{const_fetch :MINOR}.#{const_fetch :PATCH}"
 
       prerelease = const_fetch(:PRERELEASE, nil)
       str << "-#{prerelease}" unless prerelease.nil? || prerelease.empty?
@@ -95,12 +107,10 @@ module SleepingKingStudios::Tools::Toolbox
 
     private
 
-    FETCH_DEFAULT = Object.new.freeze
-
-    def const_fetch(name, default = FETCH_DEFAULT)
+    def const_fetch(name, default = UNDEFINED)
       return const_get(name).to_s if const_defined?(name)
 
-      return nil unless default == FETCH_DEFAULT
+      return nil unless default == UNDEFINED
 
       raise InvalidVersionError,
         "undefined constant for #{name.downcase} version"

data/lib/sleeping_king_studios/tools/toolbox/subclass.rb

@@ -24,14 +24,14 @@ module SleepingKingStudios::Tools::Toolbox
   module Subclass
     # Creates a subclass with partially applied constructor parameters.
     #
-    # @param class_arguments [Array] The arguments, if any, to apply to the
+    # @param class_arguments [Array] the arguments, if any, to apply to the
     #   constructor. These arguments will be added before any args passed
     #   directly to the constructor.
-    # @param class_keywords [Hash] The keywords, if any, to apply to the
+    # @param class_keywords [Hash] the keywords, if any, to apply to the
     #   constructor. These keywords will be added before any kwargs passed
     #   directly to the constructor.
     #
-    # @yield The block, if any, to pass to the constructor. This will be
+    # @yield the block, if any, to pass to the constructor. This will be
     #   overriden by a block passed directly to the constructor.
     #
     # @return [Class] the generated subclass.
@@ -44,7 +44,7 @@ module SleepingKingStudios::Tools::Toolbox
           *args,
           **class_keywords,
           **kwargs,
-          &(block || class_block)
+          &(block || class_block) # rubocop:disable Style/RedundantParentheses
         )
       end
 

data/lib/sleeping_king_studios/tools/toolbox.rb

@@ -3,9 +3,7 @@
 require 'sleeping_king_studios/tools'
 
 module SleepingKingStudios::Tools
-  # Namespace for common objects or patterns that are useful across projects but
-  # are larger than or do not fit the functional paradigm of the tools.*
-  # pattern.
+  # Namespace for defining common objects outside the tools.* pattern.
   module Toolbox
     autoload :ConstantMap,
       'sleeping_king_studios/tools/toolbox/constant_map'

data/lib/sleeping_king_studios/tools/version.rb

@@ -13,13 +13,13 @@ module SleepingKingStudios
       # Major version.
       MAJOR = 1
       # Minor version.
-      MINOR = 1
+      MINOR = 2
       # Patch version.
-      PATCH = 1
+      PATCH = 0
       # Prerelease version.
-      PRERELEASE = nil
+      PRERELEASE = :rc
       # Build metadata.
-      BUILD = nil
+      BUILD = 0
     end
 
     # The current version of the gem.