ronin-support 0.5.1 → 1.0.0.beta1

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

@@ -1,137 +0,0 @@
-#
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of Ronin Support.
-#
-# 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,
-# 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/>.
-#
-
-class Array
-
-  #
-  # Decodes the bytes contained within the Array. The Array may contain
-  # both Integer and String objects.
-  #
-  # @return [Array]
-  #   The bytes contained within the Array.
-  #
-  # @example
-  #   [0x41, 0x41, 0x20].bytes
-  #   # => [0x41, 0x41, 0x20]
-  #
-  # @example
-  #   ['A', 'BB', 0x90].bytes
-  #   # => [0x41, 0x42, 0x42, 0x90]
-  #
-  # @api public
-  #
-  def bytes
-    bytes = []
-
-    each do |element|
-      case element
-      when Integer then bytes << element
-      else
-        element.to_s.each_byte do |b|
-          bytes << b
-        end
-      end
-    end
-
-    return bytes
-  end
-
-  #
-  # Decodes the characters contained within the Array. The Array may contain
-  # either Integer or String objects.
-  #
-  # @return [Array]
-  #   The characters generated from the array.
-  #
-  # @example
-  #   [0x41, 0x41, 0x20].chars
-  #   # => ["A", "A", " "]
-  #
-  # @api public
-  #
-  def chars
-    array_bytes = bytes
-    array_bytes.map! { |b| b.chr }
-
-    return array_bytes
-  end
-
-  #
-  # @return [String]
-  #   The String created from the characters within the Array.
-  #
-  # @example
-  #   [0x41, 0x41, 0x20].char_string
-  #   # => "AA "
-  #
-  # @api public
-  #
-  def char_string
-    chars.join
-  end
-
-  #
-  # Decodes the bytes contained with the Array, and escapes them as
-  # hexadecimal characters.
-  #
-  # @return [Array<String>]
-  #   The hexadecimal characters contained within the Array.
-  #
-  # @example
-  #   [0x41, 0x41, 0x20].bytes
-  #   # => ['\x41', '\x41', '\x20']
-  #
-  # @example
-  #   ['A', 'BB', 0x90].bytes
-  #   # => ['\x41', '\x42', '\x42', '\x90']
-  #
-  # @api public
-  #
-  def hex_chars
-    array_bytes = bytes
-    array_bytes.map! { |b| '\x%x' % b }
-
-    return array_bytes
-  end
-
-  #
-  # Decodes the bytes contained with the Array, and escapes them as
-  # hexadecimal integers.
-  #
-  # @return [Array<String>]
-  #   The hexadecimal integers contained within the Array.
-  #
-  # @example
-  #   [0x41, 0x41, 0x20].bytes
-  #   # => ['0x41', '0x41', '0x20']
-  #
-  # @example
-  #   ['A', 'BB', 0x90].bytes
-  #   # => ['0x41', '0x42', '0x42', '0x90']
-  #
-  # @api public
-  #
-  def hex_integers
-    array_bytes = bytes
-    array_bytes.map! { |b| '0x%x' % b }
-
-    return array_bytes
-  end
-
-end

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

@@ -1,297 +0,0 @@
-#
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of Ronin Support.
-#
-# 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,
-# 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/>.
-#
-
-require 'set'
-
-class String
-
-  #
-  # Creates a new String by formatting each byte.
-  #
-  # @param [Hash] options
-  #   Additional options.
-  #
-  # @option options [#include?] :include (0x00..0xff)
-  #   The bytes to format.
-  #
-  # @option options [#include?] :exclude
-  #   The bytes not to format.
-  #
-  # @yield [byte]
-  #   The block which will return the formatted version of each byte
-  #   within the String.
-  #
-  # @yieldparam [Integer] byte
-  #   The byte to format.
-  #
-  # @return [String]
-  #   The formatted version of the String.
-  #
-  # @example
-  #   "hello".format_bytes { |b| "%x" % b }
-  #   # => "68656c6c6f"
-  #
-  # @api public
-  #
-  def format_bytes(options={})
-    included  = (options[:include] || (0x00..0xff))
-    excluded  = (options[:exclude] || Set[])
-    formatted = ''
-
-    each_byte do |b|
-      formatted << if (included.include?(b) && !excluded.include?(b))
-                     yield(b)
-                   else
-                     b
-                   end
-    end
-
-    return formatted
-  end
-
-  #
-  # Creates a new String by formatting each character.
-  #
-  # @param [Hash] options
-  #   Additional options.
-  #
-  # @option options [#include?, Regexp] :include (/./m)
-  #   The bytes to format.
-  #
-  # @option options [#include?, Regexp] :exclude
-  #   The bytes not to format.
-  #
-  # @yield [char]
-  #   The block which will return the formatted version of each character
-  #   within the String.
-  #
-  # @yieldparam [String] char
-  #   The character to format.
-  #
-  # @return [String]
-  #   The formatted version of the String.
-  #
-  # @example
-  #   "hello".format_chars { |c| c * 3 }
-  #   # => "hhheeellllllooo"
-  #
-  # @api public
-  #
-  def format_chars(options={})
-    included  = (options[:include] || /./m)
-    excluded  = (options[:exclude] || Set[])
-    formatted = ''
-
-    matches = lambda { |filter,c|
-      if    filter.respond_to?(:include?) then filter.include?(c)
-      elsif filter.kind_of?(Regexp)       then c =~ filter
-      end
-    }
-
-    each_char do |c|
-      formatted << if (matches[included,c] && !matches[excluded,c])
-                     yield(c)
-                   else
-                     c
-                   end
-    end
-
-    return formatted
-  end
-
-  #
-  # Creates a new String by randomizing the case of each character in the
-  # String.
-  #
-  # @param [Hash] options
-  #   Additional options.
-  #
-  # @option options [Array, Range] :include (0x00..0xff)
-  #   The bytes to format.
-  #
-  # @option options [Array, Range] :exclude
-  #   The bytes not to format.
-  #
-  # @option options [Float] :probability (0.5)
-  #   The probability that a character will have it's case changed.
-  #
-  # @example
-  #   "get out your checkbook".random_case
-  #   # => "gEt Out YOur CHEckbook"
-  #
-  # @api public
-  #
-  def random_case(options={})
-    prob = (options[:probability] || 0.5)
-
-    format_chars(options) do |c|
-      if rand <= prob then c.swapcase 
-      else                 c
-      end
-    end
-  end
-
-  #
-  # Inserts data before the occurrence of a pattern.
-  #
-  # @param [String, Regexp] pattern
-  #   The pattern to search for.
-  #
-  # @param [String] data
-  #   The data to insert before the pattern.
-  #
-  # @return [String]
-  #   The new modified String.
-  #
-  # @api public
-  #
-  def insert_before(pattern,data)
-    string = dup
-    index  = string.index(pattern)
-
-    string.insert(index,data) if index
-    return string
-  end
-
-  #
-  # Inserts data after the occurrence of a pattern.
-  #
-  # @param [String, Regexp] pattern
-  #   The pattern to search for.
-  #
-  # @param [String] data
-  #   The data to insert after the pattern.
-  #
-  # @return [String]
-  #   The new modified String.
-  #
-  # @api public
-  #
-  def insert_after(pattern,data)
-    string = dup
-    match  = string.match(pattern)
-
-    if match
-      index = match.end(match.length - 1)
-
-      string.insert(index,data)
-    end
-
-    return string
-  end
-
-  #
-  # Creates a new String by padding the String with repeating text,
-  # out to a specified length.
-  #
-  # @param [String] padding
-  #   The text to pad the new String with.
-  #
-  # @param [String] max_length
-  #   The maximum length to pad the new String out to.
-  #
-  # @return [String]
-  #   The padded version of the String.
-  #
-  # @example
-  #   "hello".pad('A',50)
-  #   # => "helloAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
-  #
-  # @api public
-  #
-  def pad(padding,max_length=length)
-    padding = padding.to_s
-
-    if max_length > length
-      max_length -= length
-    else
-      max_length = 0
-    end
-
-    padded = self + (padding * (max_length / padding.length))
-
-    unless (remaining = (max_length % padding.length)) == 0
-      padded << padding[0,remaining]
-    end
-
-    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/extensions.rb

@@ -1,24 +0,0 @@
-#
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of Ronin Support.
-#
-# 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,
-# 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/>.
-#
-
-require 'ronin/formatting/extensions/binary'
-require 'ronin/formatting/extensions/text'
-require 'ronin/formatting/extensions/digest'
-require 'ronin/formatting/extensions/http'
-require 'ronin/formatting/extensions/html'

data/lib/ronin/formatting/text.rb

@@ -1,20 +0,0 @@
-#
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of Ronin Support.
-#
-# 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,
-# 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/>.
-#
-
-require 'ronin/formatting/extensions/text'

data/lib/ronin/formatting.rb

@@ -1,25 +0,0 @@
-#
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of Ronin Support.
-#
-# 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,
-# 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/>.
-#
-
-require 'ronin/formatting/extensions'
-require 'ronin/formatting/digest'
-require 'ronin/formatting/binary'
-require 'ronin/formatting/text'
-require 'ronin/formatting/http'
-require 'ronin/formatting/html'

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

@@ -1,209 +0,0 @@
-#
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of Ronin Support.
-#
-# 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,
-# 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/>.
-#
-
-require 'ronin/fuzzing/template'
-require 'ronin/fuzzing/repeater'
-require 'ronin/fuzzing/fuzzer'
-require 'ronin/fuzzing/mutator'
-require 'ronin/fuzzing/fuzzing'
-require 'ronin/extensions/regexp'
-
-class String
-
-  #
-  # Generate permutations of Strings from a format template.
-  #
-  # @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]
-  #   The given block will be passed each unique String.
-  #
-  # @yieldparam [String] string
-  #   A newly generated String.
-  #
-  # @return [Enumerator]
-  #   If no block is given, an Enumerator will be returned.
-  #
-  # @raise [ArgumentError]
-  #   A given character set name was unknown.
-  #
-  # @raise [TypeError]
-  #   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 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:
-  #   String.generate([:alpha, 2..4]) do |password|
-  #     puts password
-  #   end
-  #
-  # @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:
-  #   String.generate([['a', 'b', 'c'], 3], [['1', '2', '3'], 3]) do |password|
-  #     puts password
-  #   end
-  #
-  # @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:
-  #   String.generate(['/AA', (1..100).step(5)]) do |path|
-  #     puts path
-  #   end
-  #
-  # @since 0.3.0
-  #
-  # @api public
-  #
-  def self.generate(*fields,&block)
-    Ronin::Fuzzing::Template.new(fields).each(&block)
-  end
-
-  #
-  # Repeats the String.
-  #
-  # @param [Enumerable<Integer>, Integer] lengths
-  #   The number of times to repeat the String.
-  #
-  # @yield [repeated]
-  #   The given block will be passed every repeated String.
-  #
-  # @yieldparam [String] repeated
-  #   A repeated version of the String.
-  #
-  # @return [Enumerator]
-  #   If no block is given, an Enumerator will be returned.
-  #
-  # @raise [TypeError]
-  #   `n` must either be Enumerable or an Integer.
-  #
-  # @example
-  #   'A'.repeating(100)
-  #   # => "AAAAAAAAAAAAA..."
-  #
-  # @example Generates 100 upto 700 `A`s, increasing by 100 at a time:
-  #   'A'.repeating((100..700).step(100)) do |str|
-  #     # ...
-  #   end
-  #
-  # @example Generates 128, 1024, 65536 `A`s:
-  #   'A'.repeating([128, 1024, 65536]) do |str|
-  #     # ...
-  #   end
-  #
-  # @api public
-  #
-  # @since 0.4.0
-  #
-  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
-  end
-
-  #
-  # Incrementally fuzzes the String.
-  #
-  # @param [Hash{Regexp,String,Symbol => Enumerable,Symbol}] substitutions
-  #   Patterns and their substitutions.
-  #
-  # @yield [fuzz]
-  #   The given block will be passed every fuzzed String.
-  #
-  # @yieldparam [String] fuzz
-  #   A fuzzed String.
-  #
-  # @return [Enumerator]
-  #   If no block is given, an Enumerator will be returned.
-  #
-  # @example Replace every `e`, `i`, `o`, `u` with `(`, 100 `A`s and a `\0`:
-  #   "the quick brown fox".fuzz(/[eiou]/ => ['(', ('A' * 100), "\0"]) do |str|
-  #     p str
-  #   end
-  #
-  # @example {String.generate} with {String#fuzz}:
-  #   "GET /".fuzz('/' => String.generate(['A', 1..100])) do |str|
-  #     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={},&block)
-    Ronin::Fuzzing::Fuzzer.new(substitutions).each(self,&block)
-  end
-
-  #
-  # Permutes over every possible mutation of the String.
-  #
-  # @param [Hash{Regexp,String,Symbol => Enumerable,Symbol}] mutations
-  #   The patterns and substitutions to mutate the String with.
-  #
-  # @yield [mutant]
-  #   The given block will be yielded every possible mutant String.
-  #
-  # @yieldparam [String] mutant
-  #   A mutated 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
-  #   end
-  #
-  # @since 0.4.0
-  #
-  # @api public
-  #
-  def mutate(mutations={},&block)
-    Ronin::Fuzzing::Mutator.new(mutations).each(self,&block)
-  end
-
-end