nuggets 1.4.0 → 1.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: b8bc4223cf7e497022aa29613c8fddce9a757b69
-  data.tar.gz: 3f1f0159203157d4fbcded7cf3dc5aeb25972df2
+SHA256:
+  metadata.gz: 1918bdc23725b5833549da651c379edda6a6e070753571e0037e7a7147be67ca
+  data.tar.gz: e48e2395d1366f14bfba167be73e36a4f2050ea64419918eca3b1f095d0fb37c
 SHA512:
-  metadata.gz: aedaaac17d00e186d8219ba67495fc1b5f73033251cff451b8f38e5e454cee49a4eac56922c2ae2b34c2ff3d87ba1bf922285a512f879e197552ea7219084733
-  data.tar.gz: 99ed4373f5c96cd6a0f42a0ee55e4ee5a8d99f166245fb2ff6f54330dfbeac503f021868bda9569bf8149b05aea31cb3ec7c6855c30a5509fbbabeff9a03678d
+  metadata.gz: 6719bf7667073a9bb9eb8c6f667a1715ebce7dff48b4cc4d514dbfbb6a245fafbfe3101a4f6426cb96e9820b072c8431d5b88c8f51a8201c143166eb65be4daf
+  data.tar.gz: de3a4dad5dcd6e5d238c92ea95ee4d4964c79c10df4b634c0b533e2e7f93e7107516c3d147c856dccb40f556911791b11b515c4ce427c6dd8f256036b5bd7c91

data/ChangeLog

@@ -2,6 +2,20 @@
 
 = Revision history for nuggets
 
+== 1.6.1 [2022-05-18]
+
+* Ruby 3.1 compatibility.
+
+== 1.6.0 [2018-07-12]
+
+* Added <tt>JSON.*_{multi,canonical}</tt>.
+
+== 1.5.0 [2016-04-19]
+
+* Added String#format.
+* Added String#highlight.
+* Dropped IO::NULL, available as File::NULL since Ruby 1.9.3.
+
 == 1.4.0 [2015-10-02]
 
 * Added File.open_file.

data/README

@@ -2,13 +2,13 @@
 
 == VERSION
 
-This documentation refers to nuggets version 1.4.0.
+This documentation refers to nuggets version 1.6.1.
 
 
 == DESCRIPTION
 
 Nuggets provides a collection of extensions to Ruby classes.
-It's similar to projects like Facets[http://rubyworks.github.com/facets]
+It's similar to projects like Facets[https://rubyworks.github.io/facets]
 and Extensions[http://extensions.rubyforge.org] (or even
 Labrador[http://labrador.rubyforge.org]).
 
@@ -45,7 +45,7 @@ expected or cause other libraries to misbehave. Use at your own risk!
 
 == LINKS
 
-Documentation:: https://blackwinter.github.com/nuggets
+Documentation:: https://blackwinter.github.io/nuggets
 Source code::   https://github.com/blackwinter/nuggets
 RubyGem::       https://rubygems.org/gems/nuggets
 Travis CI::     https://travis-ci.org/blackwinter/nuggets
@@ -58,7 +58,7 @@ Travis CI::     https://travis-ci.org/blackwinter/nuggets
 
 == LICENSE AND COPYRIGHT
 
-Copyright (C) 2007-2015 Jens Wille
+Copyright (C) 2007-2022 Jens Wille
 
 nuggets is free software: you can redistribute it and/or modify it
 under the terms of the GNU Affero General Public License as published by

data/lib/nuggets/array/format.rb

@@ -40,7 +40,7 @@ class Array
   # Applies to string argument accordingly: First string in _array_ applied to
   # _str_; empty string if _str_ is empty.
   def %(args)
-    opts = { :sep => ', ' }
+    opts = { sep: ', ' }
     opts.update(pop) if last.is_a?(::Hash)
 
     default = lambda { |n| ['%s'] * n * opts[:sep] }

data/lib/nuggets/array/histogram_mixin.rb

@@ -39,10 +39,10 @@ module Nuggets
   #
   # The "numeric" variants format the item as a (decimal) number.
   FORMATS = {
-    :default         => '%-*s [%s]%*s %*d',
-    :percent         => '%-*s [%s]%*s %*d (%.2f%%)',
-    :numeric         =>  '%*d [%s]%*s %*d',
-    :numeric_percent =>  '%*d [%s]%*s %*d (%.2f%%)'
+    default:         '%-*s [%s]%*s %*d',
+    percent:         '%-*s [%s]%*s %*d (%.2f%%)',
+    numeric:          '%*d [%s]%*s %*d',
+    numeric_percent:  '%*d [%s]%*s %*d (%.2f%%)'
   }
 
   # Encapsulates a #histogram item and provides the following attributes (see

data/lib/nuggets/file/sub_mixin.rb

@@ -39,9 +39,9 @@ module Nuggets
   #
   # Calls String#sub! on file +name+'s contents with +args+ and (optional)
   # +block+ and returns the new content.
-  def sub(name, *args)
+  def sub(name, *args, &block)
     content = read(name)
-    content.sub!(*args, &block_given? ? ::Proc.new : nil)
+    content.sub!(*args, &block)
     content
   end
 
@@ -51,11 +51,11 @@ module Nuggets
   # Calls String#sub! on file +name+'s contents with +args+ and (optional)
   # +block+ and replaces the file with the new content. Returns the result
   # of the String#sub! call.
-  def sub!(name, *args)
+  def sub!(name, *args, &block)
     res = nil
 
     replace(name) { |content|
-      res = content.sub!(*args, &block_given? ? ::Proc.new : nil)
+      res = content.sub!(*args, &block)
       content
     }
 
@@ -67,9 +67,9 @@ module Nuggets
   #
   # Calls String#gsub! on file +name+'s contents with +args+ and (optional)
   # +block+ and returns the new content.
-  def gsub(name, *args)
+  def gsub(name, *args, &block)
     content = read(name)
-    content.gsub!(*args, &block_given? ? ::Proc.new : nil)
+    content.gsub!(*args, &block)
     content
   end
 
@@ -79,11 +79,11 @@ module Nuggets
   # Calls String#gsub! on file +name+'s contents with +args+ and (optional)
   # +block+ and replaces the file with the new content. Returns the result
   # of the String#gsub! call.
-  def gsub!(name, *args)
+  def gsub!(name, *args, &block)
     res = nil
 
     replace(name) { |content|
-      res = content.gsub!(*args, &block_given? ? ::Proc.new : nil)
+      res = content.gsub!(*args, &block)
       content
     }
 

data/lib/nuggets/hash/in_order.rb

@@ -34,8 +34,8 @@ class Hash
   # Returns <tt>hash#to_a</tt>, in forced order (cf. Array#in_order).
   #
   # Examples:
-  #   { :a => 1, :b => 2, :c => 3 }.in_order(:b, :c)  #=> [[:b, 2], [:c, 3], [:a, 1]]
-  #   { :a => 1, :b => 2, :c => 3 }.in_order(:b, :d)  #=> [[:b, 2], [:a, 1], [:c, 3]]
+  #   { a: 1, b: 2, c: 3 }.in_order(:b, :c)  #=> [[:b, 2], [:c, 3], [:a, 1]]
+  #   { a: 1, b: 2, c: 3 }.in_order(:b, :d)  #=> [[:b, 2], [:a, 1], [:c, 3]]
   def in_order(*ordered)
     keys.in_order(*ordered).map { |key| [key, self[key]] }
   end

data/lib/nuggets/hash/nest_mixin.rb

@@ -45,15 +45,15 @@ module Nuggets
   # Example:
   #
   #   hash = Hash.nest(2)
-  #   hash[:foo][:bar][:a] = { :x => 1, :y => 2 }
-  #   hash[:foo][:bar][:b] = { :x => 0, :y => 3 }
+  #   hash[:foo][:bar][:a] = { x: 1, y: 2 }
+  #   hash[:foo][:bar][:b] = { x: 0, y: 3 }
   #   hash
   #   #=> {:foo=>{:bar=>{:b=>{:y=>3, :x=>0}, :a=>{:y=>2, :x=>1}}}}
-  def nest(depth = 0, value = default = true)
+  def nest(depth = 0, value = default = true, &block)
     if depth.zero?
       if default
         if block_given?
-          new { |hash, key| hash[key] = yield(key) }
+          new { |hash, key| hash[key] = block[key] }
         else
           new { |hash, key| hash[key] = hash.default }
         end
@@ -62,11 +62,7 @@ module Nuggets
       end
     else
       if default
-        if block_given?
-          new { |hash, key| hash[key] = nest(depth - 1, &::Proc.new) }
-        else
-          new { |hash, key| hash[key] = nest(depth - 1) }
-        end
+        new { |hash, key| hash[key] = nest(depth - 1, &block) }
       else
         new { |hash, key| hash[key] = nest(depth - 1, value) }
       end

data/lib/nuggets/hash/unroll_mixin.rb

@@ -30,7 +30,7 @@ module Nuggets
 
   # call-seq:
   #   hash.unroll(*value_keys) => anArray
-  #   hash.unroll(*value_keys, :sort_by => ...) => anArray
+  #   hash.unroll(*value_keys, sort_by: ...) => anArray
   #   hash.unroll(*value_keys) { |value_hash| ... } => anArray
   #
   # "Unrolls" a nested hash, so that each path through _hash_ results in a
@@ -46,13 +46,13 @@ module Nuggets
   #
   # Examples:
   #
-  #   { :foo => { :bar => { :a => { :x => 1, :y => 2 }, :b => { :x => 0, :y => 3 } } } }.unroll
+  #   { foo: { bar: { a: { x: 1, y: 2 }, b: { x: 0, y: 3 } } } }.unroll
   #   #=> [[:foo, :bar, :b, 3, 0], [:foo, :bar, :a, 2, 1]]
   #
-  #   { :foo => { :bar => { :a => { :x => 1, :y => 2 }, :b => { :x => 0, :y => 3 } } } }.unroll(:sort_by => :to_s)
+  #   { foo: { bar: { a: { x: 1, y: 2 }, b: { x: 0, y: 3 } } } }.unroll(sort_by: :to_s)
   #   #=> [[:foo, :bar, :a, 1, 2], [:foo, :bar, :b, 0, 3]]
   #
-  #   { :foo => { :bar => { :a => { :x => 1, :y => 2 }, :b => { :x => 0, :y => 3 } } } }.unroll { |data| data[:x] = nil; data[:y] *= 2 }
+  #   { foo: { bar: { a: { x: 1, y: 2 }, b: { x: 0, y: 3 } } } }.unroll { |data| data[:x] = nil; data[:y] *= 2 }
   #   #=> [[:foo, :bar, :b, 6, nil], [:foo, :bar, :a, 4, nil]]
   def unroll(*value_keys, &block)
     args = value_keys.dup

data/lib/nuggets/io/modes.rb

@@ -38,8 +38,8 @@ class IO
     #
     # Opens +name+ with mode +r+. NOTE: With no associated block,
     # acts like the original IO::read, not like IO::new.
-    def read(name, *args)
-      return _nuggets_original_read(name, *args) unless block_given?
+    def read(name, *args, **opts, &block)
+      return _nuggets_original_read(name, *args, **opts) unless block_given?
 
       case args.size
         when 0
@@ -55,7 +55,7 @@ class IO
           raise ::ArgumentError, "wrong number of arguments (#{args.size + 1} for 1-2)"
       end
 
-      open_with_mode(name, 'r', binary, &::Proc.new)
+      open_with_mode(name, 'r', binary, &block)
     end
 
     # call-seq:
@@ -63,8 +63,8 @@ class IO
     #   IO.write(name[, binary]) { |io| ... } => anObject
     #
     # Opens +name+ with mode +w+.
-    def write(name, binary = false)
-      open_with_mode(name, 'w', binary, &block_given? ? ::Proc.new : nil)
+    def write(name, binary = false, &block)
+      open_with_mode(name, 'w', binary, &block)
     end
 
     # call-seq:
@@ -72,8 +72,8 @@ class IO
     #   IO.append(name[, binary]) { |io| ... } => anObject
     #
     # Opens +name+ with mode +a+.
-    def append(name, binary = false)
-      open_with_mode(name, 'a', binary, &block_given? ? ::Proc.new : nil)
+    def append(name, binary = false, &block)
+      open_with_mode(name, 'a', binary, &block)
     end
 
     # call-seq:
@@ -81,8 +81,8 @@ class IO
     #   IO.read_write(name[, binary]) { |io| ... } => anObject
     #
     # Opens +name+ with mode <tt>r+</tt>.
-    def read_write(name, binary = false)
-      open_with_mode(name, 'r+', binary, &block_given? ? ::Proc.new : nil)
+    def read_write(name, binary = false, &block)
+      open_with_mode(name, 'r+', binary, &block)
     end
 
     # call-seq:
@@ -90,8 +90,8 @@ class IO
     #   IO.write_read(name[, binary]) { |io| ... } => anObject
     #
     # Opens +name+ with mode <tt>w+</tt>.
-    def write_read(name, binary = false)
-      open_with_mode(name, 'w+', binary, &block_given? ? ::Proc.new : nil)
+    def write_read(name, binary = false, &block)
+      open_with_mode(name, 'w+', binary, &block)
     end
 
     # call-seq:
@@ -99,15 +99,15 @@ class IO
     #   IO.append_read(name[, binary]) { |io| ... } => anObject
     #
     # Opens +name+ with mode <tt>a+</tt>.
-    def append_read(name, binary = false)
-      open_with_mode(name, 'a+', binary, &block_given? ? ::Proc.new : nil)
+    def append_read(name, binary = false, &block)
+      open_with_mode(name, 'a+', binary, &block)
     end
 
     private
 
     # Just a helper to DRY things up.
-    def open_with_mode(name, mode, binary = false)
-      open(name, "#{mode}#{'b' if binary}", &block_given? ? ::Proc.new : nil)
+    def open_with_mode(name, mode, binary = false, &block)
+      open(name, "#{mode}#{'b' if binary}", &block)
     end
 
   end

data/lib/nuggets/io/redirect_mixin.rb

@@ -3,7 +3,7 @@
 #                                                                             #
 # nuggets -- Extending Ruby                                                   #
 #                                                                             #
-# Copyright (C) 2007-2012 Jens Wille                                          #
+# Copyright (C) 2007-2016 Jens Wille                                          #
 #                                                                             #
 # Authors:                                                                    #
 #     Jens Wille <jens.wille@gmail.com>                                       #
@@ -24,13 +24,11 @@
 ###############################################################################
 #++
 
-require 'nuggets/io/null_mixin'
-
 module Nuggets
   class IO
     module RedirectMixin
 
-  def redirect(target = NullMixin::NULL, mode = 'w')
+  def redirect(target = ::File::NULL, mode = 'w')
     unless target.is_a?(self.class)
       target = ::File.open(target, mode)
       close_target = true

data/lib/nuggets/json/canonical.rb

@@ -0,0 +1,5 @@
+require 'json'
+
+require_relative 'canonical_mixin'
+
+JSON.extend(Nuggets::JSON::CanonicalMixin)

data/lib/nuggets/{io/null_mixin.rb → json/canonical_mixin.rb}

@@ -3,7 +3,7 @@
 #                                                                             #
 # nuggets -- Extending Ruby                                                   #
 #                                                                             #
-# Copyright (C) 2007-2014 Jens Wille                                          #
+# Copyright (C) 2007-2018 Jens Wille                                          #
 #                                                                             #
 # Authors:                                                                    #
 #     Jens Wille <jens.wille@gmail.com>                                       #
@@ -24,18 +24,37 @@
 ###############################################################################
 #++
 
-require 'nuggets/ruby_mixin'
-
 module Nuggets
-  class IO
-    module NullMixin
-
-      NULL = case RubyMixin::RUBY_PLATFORM
-        when /mswin|mingw/i then 'NUL'
-        when /openvms/i     then 'NL:'
-        when /amiga/i       then 'NIL:'
-        else                     '/dev/null'
-      end.freeze
+  module JSON
+    module CanonicalMixin
+
+  def generate_canonical(obj, opts = {})
+    generate(_nuggets_json_canonical(obj), opts)
+  end
+
+  def pretty_generate_canonical(obj, opts = {})
+    pretty_generate(_nuggets_json_canonical(obj), opts)
+  end
+
+  def pretty_print_canonical(source, opts = {})
+    pretty_generate_canonical(parse_multi(source, opts), opts)
+  end
+
+  alias_method :pc, :pretty_print_canonical
+
+  private
+
+  def _nuggets_json_canonical(obj)
+    case obj
+      when ::Hash
+        obj.class.new.tap { |res|
+          obj.keys.sort.each { |k| res[k] = send(__method__, obj[k]) } }
+      when ::Array
+        obj.map { |v| send(__method__, v) }.sort_by(&:to_s)
+      else
+        obj
+    end
+  end
 
     end
   end

data/lib/nuggets/json/multi.rb

@@ -0,0 +1,5 @@
+require 'json'
+
+require_relative 'multi_mixin'
+
+JSON.extend(Nuggets::JSON::MultiMixin)

data/lib/nuggets/json/multi_mixin.rb

@@ -0,0 +1,71 @@
+#--
+###############################################################################
+#                                                                             #
+# nuggets -- Extending Ruby                                                   #
+#                                                                             #
+# Copyright (C) 2007-2018 Jens Wille                                          #
+#                                                                             #
+# Authors:                                                                    #
+#     Jens Wille <jens.wille@gmail.com>                                       #
+#                                                                             #
+# nuggets is free software; you can redistribute it and/or modify it under    #
+# the terms of the GNU Affero General Public License as published by the Free #
+# Software Foundation; either version 3 of the License, or (at your option)   #
+# any later version.                                                          #
+#                                                                             #
+# nuggets is distributed in the hope that it will be useful, but WITHOUT ANY  #
+# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS   #
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for     #
+# more details.                                                               #
+#                                                                             #
+# You should have received a copy of the GNU Affero General Public License    #
+# along with nuggets. If not, see <http://www.gnu.org/licenses/>.             #
+#                                                                             #
+###############################################################################
+#++
+
+module Nuggets
+  module JSON
+    module MultiMixin
+
+  # Preserves multiple (non-unique) names in
+  # {"non-interoperable"}[https://tools.ietf.org/html/rfc7159#section-4] JSON objects.
+  def parse_multi(source, opts = {})
+    parse(source, opts.merge(object_class: MULTI_OBJECT))
+  end
+
+  def pretty_print_multi(source, opts = {})
+    pretty_generate(parse_multi(source, opts), opts)
+  end
+
+  alias_method :pp, :pretty_print_multi
+
+  private
+
+  class MULTI_OBJECT < ::Hash
+
+    def []=(k, v)
+      super(MULTI_KEY.new(k), v)
+    end
+
+    def each_multi(k)
+      block_given? ? each { |l, v| yield v if k == l } : enum_for(__method__, k)
+    end
+
+    def fetch_multi(k)
+      each_multi(k).to_a
+    end
+
+  end
+
+  class MULTI_KEY < ::String
+
+    def eql?(*)
+      false
+    end
+
+  end
+
+    end
+  end
+end

data/lib/nuggets/log_parser/rails.rb

@@ -54,7 +54,7 @@ module Nuggets
       # Log line patterns
       ITEMS = [
         [:processing, {
-          :re => %r{
+          re: %r{
             #{PREFIX_RE}         #  pid, host
             Processing\s+
             (\w+)                #  controller
@@ -72,23 +72,23 @@ module Nuggets
               (\w+)              #  request_method
             \]
           }xo,
-          :keys => [:controller, :action, :ip, :datetime, :request_method]
+          keys: [:controller, :action, :ip, :datetime, :request_method]
         }],
         [:session_id, {
-          :re => %r{
+          re: %r{
             #{PREFIX_RE}         #  pid, host
             Session\sID:\s+
             (\S+)                #  sid
           }xo,
-          :keys => [:sid]
+          keys: [:sid]
         }],
         [:parameters, {
-          :re => %r{
+          re: %r{
             #{PREFIX_RE}         #  pid, host
             Parameters:\s+
             (\{.*\})             #  params
           }xo,  #}
-          :proc => lambda { |entry, md|
+          proc: lambda { |entry, md|
             entry[:params_hash] = md[3].hash
             entry[:params] = begin
               eval("$SAFE = 3\n#{md[3].gsub(/#<.*?>/, '%q{\&}')}", nil, __FILE__, __LINE__)  # !!!
@@ -98,7 +98,7 @@ module Nuggets
           }
         }],
         [:client_info, {
-          :re => %r{
+          re: %r{
             #{PREFIX_RE}         #  pid, host
             Client\sinfo:\s+
             UA\s+=\s+
@@ -107,18 +107,18 @@ module Nuggets
             LANG\s+=\s+
             (.*)                 #  accept_language
           }xo,
-          :keys => [:user_agent, :accept_language]
+          keys: [:user_agent, :accept_language]
         }],
         [:referer, {
-          :re => %r{
+          re: %r{
             #{PREFIX_RE}         #  pid, host
             Referer:\s+
             (.*)                 #  referer
           }xo,
-          :keys => [:referer]
+          keys: [:referer]
         }],
         [:meta, {
-          :re => %r{
+          re: %r{
             #{PREFIX_RE}         #  pid, host
             Meta:\s+
             User\s+=\s+
@@ -127,20 +127,20 @@ module Nuggets
             Institution\s+=\s+
             (.*)                 #  institution_id
           }xo,
-          :keys => [:user_id, :institution_id]
+          keys: [:user_id, :institution_id]
         }],
         [:stats, {
-          :re => %r{
+          re: %r{
             #{PREFIX_RE}         #  pid, host
             Stats:\s+
             (.*)                 # flags
           }xo,
-          :proc => lambda { |entry, md|
+          proc: lambda { |entry, md|
             entry[:flags] = md[3].split(SEPARATOR_RE)
           }
         }],
         [:oauth, {
-          :re => %r{
+          re: %r{
             #{PREFIX_RE}         #  pid, host
             OAuth:\s+
             Token\s+=\s+
@@ -152,10 +152,10 @@ module Nuggets
             Client\s+=\s+
             (.*)                 #  client_id
           }xo,
-          :keys => [:token_type, :token, :user_id, :client_id]
+          keys: [:token_type, :token, :user_id, :client_id]
         }],
         [:benchmark, {
-          :re => %r{
+          re: %r{
             #{PREFIX_RE}         #  pid, host
             Completed\sin\s+
             (\S+)                #  runtime
@@ -185,7 +185,7 @@ module Nuggets
               (.*)               #  request_uri
             \]
           }xo,
-          :keys => [:runtime, :rendering_runtime, :db_runtime, :status, :request_uri]
+          keys: [:runtime, :rendering_runtime, :db_runtime, :status, :request_uri]
         }]
       ]
 

data/lib/nuggets/string/format.rb

@@ -0,0 +1,5 @@
+require 'nuggets/string/format_mixin'
+
+class String
+  include Nuggets::String::FormatMixin
+end

data/lib/nuggets/string/format_mixin.rb

@@ -0,0 +1,59 @@
+#--
+###############################################################################
+#                                                                             #
+# nuggets -- Extending Ruby                                                   #
+#                                                                             #
+# Copyright (C) 2007-2016 Jens Wille                                          #
+#                                                                             #
+# Authors:                                                                    #
+#     Jens Wille <jens.wille@gmail.com>                                       #
+#                                                                             #
+# nuggets is free software; you can redistribute it and/or modify it under    #
+# the terms of the GNU Affero General Public License as published by the Free #
+# Software Foundation; either version 3 of the License, or (at your option)   #
+# any later version.                                                          #
+#                                                                             #
+# nuggets is distributed in the hope that it will be useful, but WITHOUT ANY  #
+# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS   #
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for     #
+# more details.                                                               #
+#                                                                             #
+# You should have received a copy of the GNU Affero General Public License    #
+# along with nuggets. If not, see <http://www.gnu.org/licenses/>.             #
+#                                                                             #
+###############################################################################
+#++
+
+module Nuggets
+  class String
+    module FormatMixin
+
+  PREFIX = '%'
+
+  FORMAT_RE = %r{#{PREFIX}(?:\{(.*?)\}|(.))}o
+
+  # call-seq:
+  #   str.format(hash) => aString
+  #   str.format { |directive| ... } => aString
+  #
+  # Replace format directives in _str_.
+  #
+  # If +hash+ given, uses value of directive key (String or Symbol)
+  # as replacement value. Raises KeyError if directive key not found.
+  #
+  # If block given, uses result of +directive+ yielded to block as
+  # replacement value. Raises ArgumentError if block returns no value.
+  def format(hash = nil)
+    replace = lambda { |&b| gsub(FORMAT_RE) {
+      (k = $1 || $2) == PREFIX ? k : b[k] } }
+
+    hash ? replace.() { |k| hash.fetch(k) {
+      hash.fetch(k.to_sym) { raise(KeyError, "key not found: #{k}") } } } :
+    block_given? ? replace.() { |k| yield k or
+      raise(ArgumentError, "malformed format string - #{$&}") } :
+      raise(ArgumentError, 'wrong number of arguments (given 0, expected 1)')
+  end
+
+    end
+  end
+end

data/lib/nuggets/string/highlight.rb

@@ -0,0 +1,5 @@
+require 'nuggets/string/highlight_mixin'
+
+class String
+  include Nuggets::String::HighlightMixin
+end