ronin-support 0.4.1 → 0.5.2

data/lib/ronin/formatting/extensions/text.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support 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 Lesser General Public License for more details.
 #
 # You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 require 'ronin/formatting/extensions/text/string'

data/lib/ronin/formatting/extensions/text/array.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support 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 Lesser General Public License for more details.
 #
 # You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 class Array
@@ -40,10 +40,12 @@ class Array
     bytes = []
 
     each do |element|
-      if element.kind_of?(Integer)
-        bytes << element
+      case element
+      when Integer then bytes << element
       else
-        element.to_s.each_byte { |b| bytes << b }
+        element.to_s.each_byte do |b|
+          bytes << b
+        end
       end
     end
 
@@ -65,8 +67,8 @@ class Array
   #
   def chars
     array_bytes = bytes
-
     array_bytes.map! { |b| b.chr }
+
     return array_bytes
   end
 
@@ -103,8 +105,8 @@ class Array
   #
   def hex_chars
     array_bytes = bytes
-    
     array_bytes.map! { |b| '\x%x' % b }
+
     return array_bytes
   end
 
@@ -127,8 +129,8 @@ class Array
   #
   def hex_integers
     array_bytes = bytes
-    
     array_bytes.map! { |b| '0x%x' % b }
+
     return array_bytes
   end
 

data/lib/ronin/formatting/extensions/text/string.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support 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 Lesser General Public License for more details.
 #
 # You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 require 'set'
@@ -99,10 +99,8 @@ class String
     formatted = ''
 
     matches = lambda { |filter,c|
-      if filter.respond_to?(:include?)
-        filter.include?(c)
-      elsif filter.kind_of?(Regexp)
-        c =~ filter
+      if    filter.respond_to?(:include?) then filter.include?(c)
+      elsif filter.kind_of?(Regexp)       then c =~ filter
       end
     }
 
@@ -143,10 +141,8 @@ class String
     prob = (options[:probability] || 0.5)
 
     format_chars(options) do |c|
-      if rand <= prob
-        c.swapcase 
-      else
-        c
+      if rand <= prob then c.swapcase 
+      else                 c
       end
     end
   end
@@ -237,4 +233,65 @@ class String
     return padded
   end
 
+  alias escape dump
+
+  # Common escaped characters.
+  UNESCAPE_CHARS = Hash.new do |hash,char|
+    if char[0,1] == '\\'
+      char[1,1]
+    else
+      char
+    end
+  end
+  UNESCAPE_CHARS['\0'] = "\0"
+  UNESCAPE_CHARS['\a'] = "\a"
+  UNESCAPE_CHARS['\b'] = "\b"
+  UNESCAPE_CHARS['\t'] = "\t"
+  UNESCAPE_CHARS['\n'] = "\n"
+  UNESCAPE_CHARS['\v'] = "\v"
+  UNESCAPE_CHARS['\f'] = "\f"
+  UNESCAPE_CHARS['\r'] = "\r"
+
+  #
+  # Unescapes the escaped String.
+  #
+  # @return [String]
+  #   The unescaped version of the hex escaped String.
+  #
+  # @example
+  #   "\\x68\\x65\\x6c\\x6c\\x6f".unescape
+  #   # => "hello"
+  #
+  # @api public
+  #
+  # @since 0.5.0
+  #
+  def unescape
+    buffer     = ''
+    hex_index  = 0
+    hex_length = length
+
+    while (hex_index < hex_length)
+      hex_substring = self[hex_index..-1]
+
+      if hex_substring =~ /^\\[0-7]{3}/
+        buffer    << hex_substring[0,4].to_i(8)
+        hex_index += 3
+      elsif hex_substring =~ /^\\x[0-9a-fA-F]{1,2}/
+        hex_substring[2..-1].scan(/^[0-9a-fA-F]{1,2}/) do |hex_byte|
+          buffer    << hex_byte.to_i(16)
+          hex_index += (2 + hex_byte.length)
+        end
+      elsif hex_substring =~ /^\\./
+        buffer    << UNESCAPE_CHARS[hex_substring[0,2]]
+        hex_index += 2
+      else
+        buffer    << hex_substring[0,1]
+        hex_index += 1
+      end
+    end
+
+    return buffer
+  end
+
 end

data/lib/ronin/formatting/html.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support 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 Lesser General Public License for more details.
 #
 # You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 require 'ronin/formatting/extensions/html'

data/lib/ronin/formatting/http.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support 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 Lesser General Public License for more details.
 #
 # You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 require 'ronin/formatting/extensions/http'

data/lib/ronin/formatting/sql.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support 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 Lesser General Public License for more details.
 #
 # You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 require 'ronin/formatting/extensions/sql'

data/lib/ronin/formatting/text.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support 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 Lesser General Public License for more details.
 #
 # You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 require 'ronin/formatting/extensions/text'

data/lib/ronin/fuzzing.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support 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 Lesser General Public License for more details.
 #
 # You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 require 'ronin/fuzzing/extensions'

data/lib/ronin/fuzzing/extensions.rb

@@ -1,20 +1,20 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support 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 Lesser General Public License for more details.
 #
 # You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
 require 'ronin/fuzzing/extensions/string'

data/lib/ronin/fuzzing/extensions/string.rb

@@ -1,37 +1,36 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support 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 Lesser General Public License for more details.
 #
 # You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
-require 'ronin/extensions/regexp'
+require 'ronin/fuzzing/template'
+require 'ronin/fuzzing/repeater'
+require 'ronin/fuzzing/fuzzer'
+require 'ronin/fuzzing/mutator'
 require 'ronin/fuzzing/fuzzing'
-
-require 'combinatorics/generator'
-require 'combinatorics/list_comprehension'
-require 'combinatorics/power_set'
-require 'chars'
+require 'ronin/extensions/regexp'
 
 class String
 
   #
   # Generate permutations of Strings from a format template.
   #
-  # @param [Array(<String,Symbol,Enumerable>, <Integer,Array,Range>)] template
-  #   The template which defines the string or character sets which will
+  # @param [Array(<String,Symbol,Enumerable>, <Integer,Array,Range>)] fields
+  #   The fields which defines the string or character sets which will
   #   make up parts of the String.
   #
   # @yield [string]
@@ -50,34 +49,34 @@ class String
   #   A given string set was not a String, Symbol or Enumerable.
   #   A given string set length was not an Integer or Enumerable.
   #
-  # @example Generate Strings with ranges of repeating sub-strings.
+  # @example Generate Strings with ranges of repeating sub-strings:
   #
-  # @example Generate Strings with three alpha chars and one numeric chars.
+  # @example Generate Strings with three alpha chars and one numeric chars:
   #   String.generate([:alpha, 3], :numeric) do |password|
   #     puts password
   #   end
   #
-  # @example Generate Strings with two to four alpha chars.
+  # @example Generate Strings with two to four alpha chars:
   #   String.generate([:alpha, 2..4]) do |password|
   #     puts password
   #   end
   #
-  # @example Generate Strings using alpha and punctuation chars.
+  # @example Generate Strings using alpha and punctuation chars:
   #   String.generate([Chars.alpha + Chars.punctuation, 4]) do |password|
   #     puts password
   #   end
   #
-  # @example Generate Strings from a custom char set.
+  # @example Generate Strings from a custom char set:
   #   String.generate([['a', 'b', 'c'], 3], [['1', '2', '3'], 3]) do |password|
   #     puts password
   #   end
   #
-  # @example Generate Strings containing known Strings.
+  # @example Generate Strings containing known Strings:
   #   String.generate("rock", [:numeric, 4]) do |password|
   #     puts password
   #   end
   #
-  # @example Generate Strings with ranges of repeating sub-strings.
+  # @example Generate Strings with ranges of repeating sub-strings:
   #   String.generate(['/AA', (1..100).step(5)]) do |path|
   #     puts path
   #   end
@@ -86,69 +85,14 @@ class String
   #
   # @api public
   #
-  def self.generate(*template)
-    return enum_for(:generate,*template) unless block_given?
-
-    sets = []
-
-    template.each do |pattern|
-      set, length = pattern
-      set = case set
-            when String
-              [set].each
-            when Symbol
-              name = set.to_s.upcase
-
-              unless Chars.const_defined?(name)
-                raise(ArgumentError,"unknown charset #{set.inspect}")
-              end
-
-              Chars.const_get(name).each_char
-            when Enumerable
-              set
-            else
-              raise(TypeError,"set must be a String, Symbol or Enumerable")
-            end
-
-      case length
-      when Integer
-        length.times { sets << set.dup }
-      when Array, Range
-        sets << Combinatorics::Generator.new do |g|
-          length.each do |sublength|
-            superset = Array.new(sublength) { set.dup }
-
-            superset.comprehension { |strings| g.yield strings.join }
-          end
-        end
-      when nil
-        sets << set
-      else
-        raise(TypeError,"length must be an Integer, Range or Array")
-      end
-    end
-
-    sets.comprehension do |strings|
-      new_string = ''
-
-      strings.each do |string|
-        new_string << case string
-                      when Integer
-                        string.chr
-                      else
-                        string.to_s
-                      end
-      end
-
-      yield new_string
-    end
-    return nil
+  def self.generate(*fields,&block)
+    Ronin::Fuzzing::Template.new(fields).each(&block)
   end
 
   #
   # Repeats the String.
   #
-  # @param [Enumerable, Integer] n
+  # @param [Enumerable<Integer>, Integer] lengths
   #   The number of times to repeat the String.
   #
   # @yield [repeated]
@@ -181,32 +125,23 @@ class String
   #
   # @since 0.4.0
   #
-  def repeating(n)
-    if n.kind_of?(Integer)
-      # if n is an Integer, simply multiply the String and return
-      repeated = (self * n)
+  def repeating(lengths,&block)
+    case lengths
+    when Integer
+      # if lengths is an Integer, simply multiply the String and return
+      repeated = (self * lengths)
 
       yield repeated if block_given?
       return repeated
+    else
+      return Ronin::Fuzzing::Repeater.new(lengths).each(self,&block)
     end
-
-    return enum_for(:repeating,n) unless block_given?
-
-    unless n.kind_of?(Enumerable)
-      raise(TypeError,"argument must be Enumerable or an Integer")
-    end
-
-    n.each do |length|
-      yield(self * length)
-    end
-
-    return self
   end
 
   #
   # Incrementally fuzzes the String.
   #
-  # @param [Hash{Regexp,String => #each}] substitutions
+  # @param [Hash{Regexp,String,Symbol => Enumerable,Symbol}] substitutions
   #   Patterns and their substitutions.
   #
   # @yield [fuzz]
@@ -228,64 +163,21 @@ class String
   #     p str
   #   end
   #
+  # @example Replace a {Regexp::UNIX_PATH} with {Ronin::Fuzzing#format_strings}:
+  #   "GET /downloads/".fuzz(:unix_path => :format_string)
+  #
   # @since 0.3.0
   #
   # @api public
   #
-  def fuzz(substitutions={})
-    return enum_for(:fuzz,substitutions) unless block_given?
-
-    substitutions.each do |pattern,substitution|
-      pattern = case pattern
-                when Regexp
-                  pattern
-                when String
-                  Regexp.new(Regexp.escape(pattern))
-                when Symbol
-                  Regexp.const_get(pattern.to_s.upcase)
-                else
-                  raise(TypeError,"cannot convert #{pattern.inspect} to a Regexp")
-                end
-
-      substitution = case substitution
-                      when Enumerable
-                        substitution
-                      when Symbol
-                        Ronin::Fuzzing[substitution]
-                      else
-                        raise(TypeError,"substitutions must be Enumerable or a Symbol")
-                      end
-
-      scanner = StringScanner.new(self)
-      indices = []
-
-      while scanner.scan_until(pattern)
-        indices << [scanner.pos - scanner.matched_size, scanner.matched_size]
-      end
-
-      indices.each do |index,length|
-        substitution.each do |substitute|
-          substitute = case substitute
-                       when Proc
-                         substitute.call(self[index,length])
-                       when Integer
-                         substitute.chr
-                       else
-                         substitute.to_s
-                       end
-
-          fuzzed = dup
-          fuzzed[index,length] = substitute
-          yield fuzzed
-        end
-      end
-    end
+  def fuzz(substitutions={},&block)
+    Ronin::Fuzzing::Fuzzer.new(substitutions).each(self,&block)
   end
 
   #
   # Permutes over every possible mutation of the String.
   #
-  # @param [Hash{Regexp,String,Symbol => Symbol,#each}] mutations
+  # @param [Hash{Regexp,String,Symbol => Enumerable,Symbol}] mutations
   #   The patterns and substitutions to mutate the String with.
   #
   # @yield [mutant]
@@ -297,6 +189,10 @@ class String
   # @return [Enumerator]
   #   If no block is given, an Enumerator will be returned.
   #
+  # @raise [TypeError]
+  #   A mutation pattern was not a Regexp, String or Symbol.
+  #   A mutation substitution was not a Symbol or Enumerable.
+  #
   # @example
   #   "hello old dog".mutate('e' => ['3'], 'l' => ['1'], 'o' => ['0']) do |str|
   #     puts str
@@ -306,75 +202,8 @@ class String
   #
   # @api public
   #
-  def mutate(mutations={})
-    return enum_for(:mutate,mutations) unless block_given?
-
-    matches = Set[]
-
-    mutations.each do |pattern,mutation|
-      pattern = case pattern
-                when Regexp
-                  pattern
-                when String
-                  Regexp.new(Regexp.escape(pattern))
-                when Symbol
-                  Regexp.const_get(pattern.to_s.upcase)
-                else
-                  raise(TypeError,"cannot convert #{pattern.inspect} to a Regexp")
-                end
-
-      scanner = StringScanner.new(self)
-
-      while scanner.scan_until(pattern)
-        length   = scanner.matched_size
-        index    = scanner.pos - length
-        original = scanner.matched
-
-        mutator = Combinatorics::Generator.new do |g|
-                    mutation.each do |mutate|
-                      g.yield case mutate
-                              when Proc
-                                mutate.call(original)
-                              when Integer
-                                mutate.chr
-                              else
-                                mutate.to_s
-                              end
-                    end
-                  end
-
-        matches << [index, length, mutator]
-      end
-    end
-
-    matches.powerset do |submatches|
-      # ignore the empty Set
-      next if submatches.empty?
-
-      # sort the submatches by index
-      submatches = submatches.sort_by { |index,length,mutator| index }
-      sets       = []
-      prev_index = 0
-
-      submatches.each do |index,length,mutator|
-        # add the previous substring to the set of Strings
-        if index > prev_index
-          sets << [self[prev_index,index - prev_index]]
-        end
-
-        # add the mutator to the set of Strings
-        sets << mutator
-
-        prev_index = index + length
-      end
-
-      # add the remaining substring to the set of Strings
-      if prev_index < self.length
-        sets << [self[prev_index..-1]]
-      end
-
-      sets.comprehension { |strings| yield strings.join }
-    end
+  def mutate(mutations={},&block)
+    Ronin::Fuzzing::Mutator.new(mutations).each(self,&block)
   end
 
 end