ronin-support 0.5.1 → 1.0.0.beta1

data/lib/ronin/formatting/extensions/html/integer.rb

@@ -1,142 +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 'cgi'
-
-class Integer
-
-  # Special JavaScript bytes and their escaped Strings.
-  JS_ESCAPE_BYTES = {
-    0x00 => '\u0000',
-    0x01 => '\u0001',
-    0x02 => '\u0002',
-    0x03 => '\u0003',
-    0x04 => '\u0004',
-    0x05 => '\u0005',
-    0x06 => '\u0006',
-    0x07 => '\u0007',
-    0x08 =>  '\b',
-    0x09 =>  '\t',
-    0x0a =>  '\n',
-    0x0b => '\u000b',
-    0x0c =>  '\f',
-    0x0d =>  '\r',
-    0x0e => '\u000e',
-    0x0f => '\u000f',
-    0x10 => '\u0010',
-    0x11 => '\u0011',
-    0x12 => '\u0012',
-    0x13 => '\u0013',
-    0x14 => '\u0014',
-    0x15 => '\u0015',
-    0x16 => '\u0016',
-    0x17 => '\u0017',
-    0x18 => '\u0018',
-    0x19 => '\u0019',
-    0x1a => '\u001a',
-    0x1b => '\u001b',
-    0x1c => '\u001c',
-    0x1d => '\u001d',
-    0x1e => '\u001e',
-    0x1f => '\u001f',
-    0x22 =>  '\"',
-    0x5c =>  '\\\\',
-  }
-
-  #
-  # Escapes the Integer as an HTML String.
-  #
-  # @return [String]
-  #   The escaped HTML String.
-  #
-  # @example
-  #   0x26.html_escape
-  #   # => "&amp;"
-  #
-  # @since 0.2.0
-  #
-  # @api public
-  #
-  def html_escape
-    CGI.escapeHTML(chr)
-  end
-
-  #
-  # Formats the Integer as a HTML String.
-  #
-  # @return [String]
-  #   The HTML String.
-  #
-  # @example
-  #   0x41.format_html
-  #   # => "&#65;"
-  #
-  # @since 0.2.0
-  #
-  # @api public
-  #
-  def format_html
-    "&#%d;" % self
-  end
-
-  #
-  # Escapes the Integer as a JavaScript String.
-  #
-  # @return [String]
-  #   The escaped JavaScript String.
-  #
-  # @example 
-  #   0x22.js_escape
-  #   # => "\\\""
-  #
-  # @example
-  #   0x7f.js_escape
-  #   # => "\x7F"
-  #
-  # @since 0.2.0
-  #
-  # @api public
-  #
-  def js_escape
-    if self > 0xff then format_js
-    else                JS_ESCAPE_BYTES.fetch(self,chr)
-    end
-  end
-
-  #
-  # Formats the Integer as a JavaScript escaped String.
-  #
-  # @return [String]
-  #   The escaped JavaScript String.
-  #
-  # @example
-  #   0x41.format_js
-  #   # => "%41"
-  #
-  # @since 0.2.0
-  #
-  # @api public
-  #
-  def format_js
-    if self > 0xff then "\\u%.4X" % self
-    else                "\\x%.2X" % self
-    end
-  end
-
-end

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

@@ -1,194 +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/html/integer'
-require 'ronin/formatting/extensions/text/string'
-
-require 'cgi'
-
-class String
-
-  # JavaScript characters that must be back-slashed.
-  JS_BACKSLASHED_CHARS = {
-    "\\b"  => "\b",
-    "\\t"  => "\t",
-    "\\n"  => "\n",
-    "\\f"  => "\f",
-    "\\r"  => "\r",
-    "\\\"" => "\"",
-    "\\\\" => "\\"
-  }
-
-  #
-  # HTML escapes the String.
-  #
-  # @return [String]
-  #   The HTML escaped String.
-  #
-  # @example
-  #   "one & two".html_escape
-  #   # => "one &amp; two"
-  #
-  # @see http://rubydoc.info/stdlib/cgi/1.9.2/CGI.escapeHTML
-  #
-  # @since 0.2.0
-  #
-  # @api public
-  #
-  def html_escape
-    CGI.escapeHTML(self)
-  end
-
-  #
-  # Unescapes the HTML encoded String.
-  #
-  # @return [String]
-  #   The unescaped String.
-  #
-  # @example
-  #   "&lt;p&gt;one &lt;span&gt;two&lt;/span&gt;&lt;/p&gt;".html_unescape
-  #   # => "<p>one <span>two</span></p>"
-  #
-  # @see http://rubydoc.info/stdlib/cgi/1.9.2/CGI.unescapeHTML
-  #
-  # @since 0.2.0
-  #
-  # @api public
-  #
-  def html_unescape
-    CGI.unescapeHTML(self)
-  end
-
-  #
-  # Formats the chars in the String for HTML.
-  #
-  # @param [Hash] options
-  #   Additional options for {#format_chars}.
-  #
-  # @return [String]
-  #   The formatted HTML String.
-  #
-  # @example
-  #   "abc".format_html
-  #   # => "&#97;&#98;&#99;"
-  #
-  # @see Integer#format_html
-  #
-  # @since 0.2.0
-  #
-  # @api public
-  #
-  def format_html(options={})
-    # String#ord was not backported to Ruby 1.8.7
-    formatter = if RUBY_VERSION < '1.9.' then lambda { |c| c[0].format_html  }
-                else                          lambda { |c| c.ord.format_html }
-                end
-
-    format_chars(options,&formatter)
-  end
-
-  #
-  # Escapes a String for JavaScript.
-  #
-  # @param [Hash] options
-  #   Additional options for {#format_chars}.
-  #
-  # @return [String]
-  #   The JavaScript escaped String.
-  #
-  # @example
-  #   "hello\nworld\n".js_escape
-  #   # => "hello\\nworld\\n"
-  #
-  # @see Integer#js_escape
-  #
-  # @since 0.2.0
-  #
-  # @api public
-  #
-  def js_escape(options={})
-    # String#ord was not backported to Rub 1.8.7
-    formatter = if RUBY_VERSION < '1.9.' then lambda { |c| c[0].js_escape  }
-                else                          lambda { |c| c.ord.js_escape }
-                end
-
-    format_chars(options,&formatter)
-  end
-
-  #
-  # Unescapes a JavaScript escaped String.
-  #
-  # @return [String]
-  #   The unescaped JavaScript String.
-  #
-  # @example
-  #   "\\u0068\\u0065\\u006C\\u006C\\u006F world".js_unescape
-  #   # => "hello world"
-  #
-  # @since 0.2.0
-  #
-  # @api public
-  #
-  def js_unescape
-    unescaped = ''
-
-    scan(/[\\%]u[0-9a-fA-F]{1,4}|[\\%][0-9a-fA-F]{1,2}|\\[btnfr"\\]|./) do |c|
-      unescaped << JS_BACKSLASHED_CHARS.fetch(c) do
-        if (c.start_with?("\\u") || c.start_with?("%u"))
-          c[2..-1].to_i(16)
-        elsif (c.start_with?("\\") || c.start_with?("%"))
-          c[1..-1].to_i(16)
-        else
-          c
-        end
-      end
-    end
-
-    return unescaped
-  end
-
-  #
-  # Escapes a String for JavaScript.
-  #
-  # @param [Hash] options
-  #   Additional options for {#format_chars}.
-  #
-  # @return [String]
-  #   The JavaScript escaped String.
-  #
-  # @example
-  #   "hello".js_escape
-  #   # => "\\u0068\\u0065\\u006C\\u006C\\u006F"
-  #
-  # @see Integer#js_escape
-  #
-  # @since 0.2.0
-  #
-  # @api public
-  #
-  def format_js(options={})
-    # String#ord was not backported to Rub 1.8.7
-    formatter = if RUBY_VERSION < '1.9.' then lambda { |c| c[0].format_js  }
-                else                          lambda { |c| c.ord.format_js }
-                end
-
-    format_chars(options,&formatter)
-  end
-
-end

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

@@ -1,21 +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/html/integer'
-require 'ronin/formatting/extensions/html/string'

data/lib/ronin/formatting/extensions/http/integer.rb

@@ -1,69 +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 'uri/common'
-require 'cgi'
-
-class Integer
-
-  #
-  # URI encodes the byte.
-  #
-  # @return [String]
-  #   The URI encoded byte.
-  #
-  # @api public
-  #
-  def uri_encode
-    URI.encode(chr)
-  end
-
-  #
-  # URI escapes the byte.
-  #
-  # @return [String]
-  #   The URI escaped byte.
-  #
-  # @example
-  #   0x3d.uri_escape
-  #   # => "%3D"
-  #
-  # @api public
-  #
-  def uri_escape
-    CGI.escape(chr)
-  end
-
-  #
-  # Formats the byte for HTTP.
-  #
-  # @return [String]
-  #   The formatted byte.
-  #
-  # @example
-  #   0x41.format_http
-  #   # => "%41"
-  #
-  # @api public
-  #
-  def format_http
-    "%%%X" % self
-  end
-
-end

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

@@ -1,110 +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/http/integer'
-require 'ronin/formatting/extensions/text'
-
-require 'uri/common'
-require 'cgi'
-
-class String
-
-  #
-  # URI encodes the String.
-  #
-  # @return [String]
-  #   The URI encoded form of the String.
-  #
-  # @example
-  #   "art is graffiti".uri_encode
-  #   # => "art%20is%20graffiti"
-  #
-  # @api public
-  #
-  def uri_encode
-    URI.encode(self)
-  end
-
-  #
-  # URI decodes the String.
-  #
-  # @return [String]
-  #   The decoded URI form of the String.
-  #
-  # @example
-  #   "genre%3f".uri_decode
-  #   # => "genre?"
-  #
-  # @api public
-  #
-  def uri_decode
-    URI.decode(self)
-  end
-
-  #
-  # URI escapes the String.
-  #
-  # @return [String]
-  #   The URI escaped form of the String.
-  #
-  # @example
-  #   "x > y".uri_escape
-  #   # => "x+%3E+y"
-  #
-  # @api public
-  #
-  def uri_escape
-    CGI.escape(self)
-  end
-
-  #
-  # URI unescapes the String.
-  #
-  # @return [String]
-  #   The unescaped URI form of the String.
-  #
-  # @example
-  #   "sweet+%26+sour".uri_unescape
-  #   # => "sweet & sour"
-  #
-  # @api public
-  #
-  def uri_unescape
-    CGI.unescape(self)
-  end
-
-  #
-  # Formats the bytes of the String.
-  #
-  # @return [String]
-  #   The HTTP hexadecimal encoded form of the String.
-  #
-  # @example
-  #   "hello".format_http
-  #   # => "%68%65%6c%6c%6f"
-  #
-  # @see String#format_bytes
-  #
-  # @api public
-  #
-  def format_http(options={})
-    format_bytes(options) { |b| b.format_http }
-  end
-
-end

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

@@ -1,21 +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/http/integer'
-require 'ronin/formatting/extensions/http/string'

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

@@ -1,128 +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 String
-
-  #
-  # Escapes an String for SQL.
-  #
-  # @param [Symbol] quotes (:single)
-  #   Specifies whether to create a single or double quoted string.
-  #   May be either `:single` or `:double`.
-  #
-  # @return [String]
-  #   The escaped String.
-  #
-  # @raise [ArgumentError]
-  #   The quotes argument was neither `:single` nor `:double`.
-  #
-  # @example
-  #   "O'Brian".sql_escape
-  #   # => "'O''Brian'"
-  #
-  # @since 0.3.0
-  #
-  def sql_escape(quotes=:single)
-    case quotes
-    when :single then "'#{gsub(/'/,"''")}'"
-    when :double then "\"#{gsub(/"/,'""')}\""
-    else
-      raise(ArgumentError,"invalid quoting style #{quotes.inspect}")
-    end
-  end
-
-  #
-  # Returns the SQL hex-string encoded form of the String.
-  #
-  # @example
-  #   "/etc/passwd".sql_encode
-  #   # => "0x2f6574632f706173737764"
-  #
-  def sql_encode
-    return '' if empty?
-
-    hex_string = '0x'
-
-    each_byte do |b|
-      hex_string << ('%.2x' % b)
-    end
-
-    return hex_string
-  end
-
-  #
-  # Returns the SQL decoded form of the String.
-  #
-  # @example
-  #   "'Conan O''Brian'".sql_decode
-  #   # => "Conan O'Brian"
-  #
-  # @example
-  #  "0x2f6574632f706173737764".sql_decode
-  #  # => "/etc/passwd"
-  #
-  def sql_decode
-    if (start_with?('0x') && (length % 2 == 0))
-      raw = ''
-
-      self[2..-1].scan(/../) do |hex_char|
-        raw << hex_char.to_i(16).chr
-      end
-
-      return raw
-    elsif (start_with?("'") && end_with?("'"))
-      self[1..-2].gsub(/\\'|''/,"'")
-    else
-      return self
-    end
-  end
-
-  #
-  # Prepares the String for injection into a SQL expression.
-  #
-  # @return [String]
-  #   The SQL injection ready String.
-  #
-  # @example
-  #   "'1' OR '1'='1'".sql_inject
-  #   # => "1' OR '1'='1"
-  #
-  # @example
-  #   "'1' OR 1=1".sql_inject
-  #   # => "1' OR 1=1 OR '"
-  #
-  # @example
-  #   "'1' OR 1=1".sql_inject(:terminate => true)
-  #   # => "1' OR 1=1 --"
-  #
-  # @api public
-  #
-  # @since 0.4.0
-  #
-  def sql_inject
-    if (start_with?("'") || start_with?('"') || start_with?('`'))
-      if self[0,1] == self[-1,1] then self[1..-2]
-      else                            "#{self[1..-1]}--"
-      end
-    else
-      self
-    end
-  end
-
-end

data/lib/ronin/formatting/extensions/sql.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/sql/string'