ronin 0.2.1 → 0.2.2

data/History.txt

@@ -1,3 +1,28 @@
+=== 0.2.2 / 2009-03-26
+
+* Split out Ronin::Chars into the Chars library.
+* Split out ronin-overlay and ronin-ext sub-commands into the Ronin Gen
+  library.
+* Require chars >= 0.1.0.
+* Require repertoire >= 0.2.1.
+* Removed String#to_method_name, use Extlib instead.
+* Refactored Ronin::Platform::Overlay.
+  * Renamed Overlay#media_type to Overlay#media.
+  * Fixed parsing bugs in Overlay#initialize_metadata.
+* Allow Extensions to be accessed via constants.
+* Added the Creative Commons Zero license to Ronin::License.
+* Added the Integer#bytes method.
+* Added the String#hex_unescape method.
+* Added the String#unhexdump method.
+* Added Ronin::Static for managing static resources.
+* Added Ronin::Static::Finders for searching for static files.
+* Added static directories to Overlays and Extensions.
+* Added ronin/platform/tasks:
+  * Added ronin/platform/tasks/spec task for running RSpec tests in an
+    Overlay.
+* Added the ExtensionCache#reload! method.
+* Added more specs.
+
 === 0.2.1 / 2009-02-23
 
 * Added Ronin::UI::Verbose.

data/Manifest.txt

@@ -7,16 +7,17 @@ Rakefile
 bin/ronin
 bin/ronin-add
 bin/ronin-console
-bin/ronin-ext
 bin/ronin-help
 bin/ronin-install
 bin/ronin-ls
-bin/ronin-overlay
 bin/ronin-rm
 bin/ronin-uninstall
 bin/ronin-update
 lib/ronin.rb
 lib/ronin/config.rb
+lib/ronin/static.rb
+lib/ronin/static/static.rb
+lib/ronin/static/finders.rb
 lib/ronin/extensions.rb
 lib/ronin/extensions/meta.rb
 lib/ronin/extensions/meta/object.rb
@@ -41,9 +42,6 @@ lib/ronin/formatting/extensions/text.rb
 lib/ronin/formatting/extensions/text/string.rb
 lib/ronin/formatting/extensions/http.rb
 lib/ronin/formatting/extensions/http/string.rb
-lib/ronin/chars.rb
-lib/ronin/chars/char_set.rb
-lib/ronin/chars/chars.rb
 lib/ronin/translators.rb
 lib/ronin/translators/translator.rb
 lib/ronin/path.rb
@@ -122,6 +120,7 @@ lib/ronin/objectify/objectify.rb
 lib/ronin/models.rb
 lib/ronin/environment.rb
 lib/ronin/platform.rb
+lib/ronin/platform/tasks/spec.rb
 lib/ronin/platform/exceptions.rb
 lib/ronin/platform/exceptions/extension_not_found.rb
 lib/ronin/platform/exceptions/overlay_cached.rb
@@ -151,8 +150,6 @@ lib/ronin/ui/command_line/command.rb
 lib/ronin/ui/command_line/options.rb
 lib/ronin/ui/command_line/param_parser.rb
 lib/ronin/ui/command_line/commands/console.rb
-lib/ronin/ui/command_line/commands/overlay.rb
-lib/ronin/ui/command_line/commands/ext.rb
 lib/ronin/ui/command_line/commands/add.rb
 lib/ronin/ui/command_line/commands/install.rb
 lib/ronin/ui/command_line/commands/ls.rb
@@ -166,16 +163,42 @@ lib/ronin/version.rb
 tasks/spec.rb
 spec/helpers.rb
 spec/spec_helper.rb
+spec/static/helpers/static1/one.txt
+spec/static/helpers/static1/dir/two.txt
+spec/static/helpers/static2/dir/two.txt
+spec/static/helpers/static.rb
+spec/static/helpers/static_class.rb
+spec/static/finders_spec.rb
+spec/static/static_spec.rb
 spec/arch_spec.rb
 spec/author_spec.rb
-spec/chars/char_set_spec.rb
-spec/chars/chars_spec.rb
 spec/translators/translator_spec.rb
 spec/objectify/objectify_spec.rb
 spec/extensions/hash_spec.rb
 spec/extensions/string_spec.rb
 spec/extensions/uri/http_spec.rb
 spec/extensions/uri/query_params_spec.rb
+spec/formatting/binary/helpers/hexdumps.rb
+spec/formatting/binary/helpers/hexdumps/repeated.bin
+spec/formatting/binary/helpers/hexdumps/hexdump_octal_bytes.txt
+spec/formatting/binary/helpers/hexdumps/hexdump_octal_shorts.txt
+spec/formatting/binary/helpers/hexdumps/hexdump_decimal_shorts.txt
+spec/formatting/binary/helpers/hexdumps/hexdump_hex_bytes.txt
+spec/formatting/binary/helpers/hexdumps/hexdump_hex_shorts.txt
+spec/formatting/binary/helpers/hexdumps/hexdump_repeated.txt
+spec/formatting/binary/helpers/hexdumps/od_octal_bytes.txt
+spec/formatting/binary/helpers/hexdumps/od_octal_shorts.txt
+spec/formatting/binary/helpers/hexdumps/od_octal_ints.txt
+spec/formatting/binary/helpers/hexdumps/od_octal_quads.txt
+spec/formatting/binary/helpers/hexdumps/od_decimal_bytes.txt
+spec/formatting/binary/helpers/hexdumps/od_decimal_shorts.txt
+spec/formatting/binary/helpers/hexdumps/od_decimal_ints.txt
+spec/formatting/binary/helpers/hexdumps/od_decimal_quads.txt
+spec/formatting/binary/helpers/hexdumps/od_hex_bytes.txt
+spec/formatting/binary/helpers/hexdumps/od_hex_shorts.txt
+spec/formatting/binary/helpers/hexdumps/od_hex_ints.txt
+spec/formatting/binary/helpers/hexdumps/od_hex_quads.txt
+spec/formatting/binary/helpers/hexdumps/od_repeated.txt
 spec/formatting/binary/integer_spec.rb
 spec/formatting/binary/string_spec.rb
 spec/formatting/digest_spec.rb
@@ -197,7 +220,10 @@ spec/platform/helpers/overlays/test2/ronin.xml
 spec/platform/helpers/overlays/test2/test/extension.rb
 spec/platform/helpers/overlays/hello/ronin.xml
 spec/platform/helpers/overlays/hello/hello/extension.rb
+spec/platform/helpers/overlays/random/ronin.xml
+spec/platform/helpers/overlays/random/random/extension.rb
 spec/platform/extension_spec.rb
+spec/platform/overlay_spec.rb
 spec/platform/overlay_cache_spec.rb
 spec/platform/extension_cache_spec.rb
 spec/platform/platform_spec.rb
@@ -206,5 +232,4 @@ spec/ui/verbose_spec.rb
 spec/ui/command_line/helpers/example_command.rb
 spec/ui/command_line/param_parser_spec.rb
 spec/ronin_spec.rb
-static/overlay.xsl
-static/extension.rb
+static/ronin/platform/overlay.xsl

data/README.txt

@@ -29,7 +29,7 @@ users to pick and choose what functionality they want in Ronin.
 
 Ronin does not have a central repository of exploits and payloads which
 all developers contribute to. Instead Ronin has Overlays, repositories of
-code that can be hosted on any CVS/SVN/Git/Rsync server. Users can then use
+code that can be hosted on any SVN/Hg/Git/Rsync server. Users can then use
 Ronin to quickly install or update Overlays. This allows developers and
 users to form their own communities, independent of the main developers
 of Ronin.
@@ -38,11 +38,10 @@ of Ronin.
 
 * Supports installing/updating/uninstalling of Overlays.
   * Supports accessing Overlays from various media types:
-    * CVS
     * Subversion (SVN)
+    * Mercurial (Hg)
     * Git
     * Rsync
-    * Darcs
 * Allows for the loading of Extensions from one or more Overlays.
 * Provides persistent storage of objects using DataMapper.
 * Caches and mirrors objects stored in Overlays using DataMapper.
@@ -147,13 +146,12 @@ Google (tm) Dorks functionality.
 Ronin Exploits is a Ruby library for Ronin that provides exploitation and
 payload crafting functionality.
 
-=== Ronin HTML
+=== Ronin Gen
 
-* http://ronin.rubyforge.org/html/
-* http://github.com/postmodern/ronin-html
+* http://ronin.rubyforge.org/gen/
+* http://github.com/postmodern/ronin-gen
 
-Ronin HTML is a Ruby library for Ronin that provides support for generating
-complex HTML/JavaScript or crafting XSS/CSRF attacks.
+Ronin Gen is a Ruby library for Ronin that provides various generators.
 
 === Ronin SQL
 

data/Rakefile

@@ -19,10 +19,11 @@ Hoe.new('ronin', Ronin::VERSION) do |p|
     ['dm-aggregates', '>=0.9.9'],
     ['dm-validations', '>=0.9.9'],
     ['dm-predefined', '>=0.1.0'],
+    ['chars', '>=0.1.0'],
     ['parameters', '>=0.1.3'],
     ['contextify', '>=0.1.2'],
     ['reverse-require', '>=0.3.1'],
-    ['repertoire', '>=0.1.2']
+    ['repertoire', '>=0.2.1']
   ]
 end
 

data/lib/ronin/config.rb

@@ -31,9 +31,6 @@ module Ronin
     # Ronin home directory
     PATH = FileUtils.mkdir_p(File.join(HOME,'.ronin'))
 
-    # Path to static directory
-    STATIC_DIR = File.expand_path(File.join(File.dirname(__FILE__),'..','..','static'))
-
     # Main configuration file
     CONFIG_PATH = File.join(PATH,'config.rb')
 

data/lib/ronin/environment.rb

@@ -24,13 +24,13 @@
 require 'ronin/config'
 require 'ronin/extensions'
 require 'ronin/formatting'
-require 'ronin/chars'
 require 'ronin/path'
 require 'ronin/network'
 require 'ronin/models'
 require 'ronin/ui'
 require 'ronin/ronin'
 
+require 'chars'
 require 'pp'
 
 Ronin::Config.load

data/lib/ronin/extensions/string.rb

@@ -23,17 +23,6 @@
 
 class String
 
-  #
-  # Converts the +String+ into an appropriate method name.
-  #
-  #   'GPL 2'.to_method_name # => "gpl_2"
-  #
-  #   'Ronin::Arch' # => "ronin_arch"
-  #
-  def to_method_name
-    downcase.gsub(/(::|[\s\-])/,'_')
-  end
-
   #
   # Returns the common prefix of the string and the specified _other_
   # string. If no common prefix can be found an empty string will be

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

@@ -26,29 +26,28 @@ require 'ronin/arch'
 class Integer
 
   #
-  # Packs the integer using the specified _arch_ and the given
-  # _address_length_. The _address_length_ will default to the address
-  # length of the _arch_.
-  #
-  #   0x41.pack(Arch.i686) # => "A\000\000\000"
+  # Returns an Array of bytes which represent the integer, using the
+  # specified _address_length_ and given _endian_.
   #
-  #   0x41.pack(Arch.ppc,2) # => "\000A"
+  # _endian_ must be either <tt>:little</tt>, <tt>:big</tt> or
+  # <tt>:net</tt>.
   #
-  def pack(arch,address_length=arch.address_length)
-    buffer = ""
+  def bytes(address_length,endian=:little)
+    endian = endian.to_s
+    buffer = []
 
-    if arch.endian=='little'
+    if (endian == 'little' || endian == 'net')
       mask = 0xff
 
       address_length.times do |i|
-        buffer+=((self & mask) >> (i*8)).chr
+        buffer << ((self & mask) >> (i*8))
         mask <<= 8
       end
-    elsif arch.endian=='big'
+    elsif endian == 'big'
       mask = (0xff << ((address_length-1)*8))
 
       address_length.times do |i|
-        buffer+=((self & mask) >> ((address_length-i-1)*8)).chr
+        buffer << ((self & mask) >> ((address_length-i-1)*8))
         mask >>= 8
       end
     end
@@ -56,6 +55,19 @@ class Integer
     return buffer
   end
 
+  #
+  # Packs the integer using the specified _arch_ and the given
+  # _address_length_. The _address_length_ will default to the address
+  # length of the _arch_.
+  #
+  #   0x41.pack(Arch.i686) # => "A\000\000\000"
+  #
+  #   0x41.pack(Arch.ppc,2) # => "\000A"
+  #
+  def pack(arch,address_length=arch.address_length)
+    bytes(address_length,arch.endian).map { |b| b.chr }.join
+  end
+
   #
   # Returns the hex escaped form of the integer.
   #

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

@@ -21,6 +21,7 @@
 #++
 #
 
+require 'ronin/formatting/extensions/binary/integer'
 require 'ronin/formatting/extensions/text'
 require 'ronin/arch'
 
@@ -67,6 +68,61 @@ class String
     format_bytes(options) { |b| "\\x%.2x" % b }
   end
 
+  #
+  # Returns an unescaped version of the hex escaped string.
+  #
+  #   "\\x68\\x65\\x6c\\x6c\\x6f".hex_unescape
+  #   # => "hello"
+  #
+  def hex_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..3].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 =~ /^\\./
+        escaped_char = hex_substring[1..1]
+
+        buffer << case escaped_char
+                  when '0'
+                    "\0"
+                  when 'a'
+                    "\a"
+                  when 'b'
+                    "\b"
+                  when 't'
+                    "\t"
+                  when 'n'
+                    "\n"
+                  when 'v'
+                    "\v"
+                  when 'f'
+                    "\f"
+                  when 'r'
+                    "\r"
+                  else
+                    escaped_char
+                  end
+        hex_index += 2
+      else
+        buffer << hex_substring[0]
+        hex_index += 1
+      end
+    end
+
+    return buffer
+  end
+
   #
   # XOR encodes the string using the specified _key_.
   #
@@ -91,4 +147,114 @@ class String
     Base64.decode64(self)
   end
 
+  #
+  # Converts a multitude of hexdump formats back into the original
+  # raw-data using the given _options_.
+  #
+  # _options_ may contain the following keys:
+  # <tt>:format</tt>:: The expected format of the hexdump. Must be either
+  #                    <tt>:od</tt> or <tt>:hexdump</tt>.
+  # <tt>:encoding</tt>:: Denotes the encoding used for the bytes within the
+  #                      hexdump. Must be one of the following:
+  #                      <tt>:binary</tt>:: Binary encoded bytes.
+  #                      <tt>:octal</tt>:: Octal encoding.
+  #                      <tt>:octal_bytes</tt>:: Octal encoded bytes.
+  #                      <tt>:octal_shorts</tt>:: Octal encoded shorts.
+  #                      <tt>:octal_ints</tt>:: Octal encoded integers.
+  #                      <tt>:octal_quads</tt>:: Octal encoded quads.
+  #                      <tt>:decimal</tt>:: Unsigned decimal encoding.
+  #                      <tt>:decimal_bytes</tt>:: Unsigned decimal bytes.
+  #                      <tt>:decimal_shorts</tt>:: Unsigned decimal shorts.
+  #                      <tt>:decimal_ints</tt>:: Unsigned decimal ints.
+  #                      <tt>:decimal_quads</tt>:: Unsigned decimal quads.
+  #                      <tt>:hex</tt>:: Hexadecimal encoding.
+  #                      <tt>:hex_bytes</tt>:: Hexadecimal bytes.
+  #                      <tt>:hex_shorts</tt>:: Hexadecimal shorts.
+  #                      <tt>:hex_ints</tt>:: Hexadecimal ints.
+  #                      <tt>:hex_quads</tt>:: Hexadecimal quads.
+  # <tt>:segment</tt>:: The length in bytes of each segment in the hexdump.
+  #                     Defaults to 16, if not specified.
+  #
+  def unhexdump(options={})
+    case (format = options[:format])
+    when :od
+      address_base = base = 8
+      word_size = 2
+    when :hexdump
+      address_base = base = 16
+      word_size = 2
+    else
+      address_base = base = 16
+      word_size = 1
+    end
+
+    case options[:encoding]
+    when :binary
+      base = 2
+    when :octal, :octal_bytes, :octal_shorts, :octal_ints, :octal_quads
+      base = 8
+    when :decimal, :decimal_bytes, :decimal_shorts, :decimal_ints, :decimal_quads
+      base = 10
+    when :hex, :hex_bytes, :hex_shorts, :hex_ints, :hex_quads
+      base = 16
+    end
+
+    case options[:encoding]
+    when :binary, :octal_bytes, :decimal_bytes, :hex_bytes
+      word_size = 1
+    when :octal_shorts, :decimal_shorts, :hex_shorts
+      word_size = 2
+    when :octal_ints, :decimal_ints, :hex_ints
+      word_size = 4
+    when :octal_quads, :decimal_quads, :hex_quads
+      word_size = 8
+    end
+
+    current_addr = last_addr = first_addr = nil
+    repeated = false
+
+    segment_length = (options[:segment] || 16)
+    segment = []
+    buffer = []
+
+    each_line do |line|
+      if format == :hexdump
+        line = line.gsub(/\s+\|.+\|\s*$/,'')
+      end
+
+      words = line.split
+
+      if words.first == '*'
+        repeated = true
+      elsif words.length > 0
+        current_addr = words.shift.to_i(address_base)
+        first_addr ||= current_addr
+
+        if repeated
+          (((current_addr - last_addr) / segment.length) - 1).times do
+            buffer += segment
+          end
+
+          repeated = false
+        end
+
+        segment.clear
+
+        words.each do |word|
+          if (base != 10 && word =~ /^(\\[0abtnvfr\\]|.)$/)
+            word.hex_unescape.each_byte { |b| segment << b }
+          else
+            segment += word.to_i(base).bytes(word_size)
+          end
+        end
+
+        segment = segment[0...segment_length]
+        buffer += segment
+        last_addr = current_addr
+      end
+    end
+
+    return buffer[0...(last_addr - first_addr)]
+  end
+
 end