ronin 0.1.0 → 0.1.1

data/History.txt

@@ -1,3 +1,16 @@
+=== 0.1.1 / 2008-10-26
+
+* Depend on the newly renamed reverse-require (>= 0.1.2) gem.
+* Added Code::SymbolTable for DSLs to make use of.
+* Added String#common_prefix, String#common_postfix and
+  String#uncommon_substring, which will be useful when testing for
+  successful injections.
+* Added DataMapper column indexes to Author.name, Product.name, Platform.os
+  and Platform.version.
+* Renamed String#rand_case to String#random_case.
+* Removed the Runner namespace, renaming the Runner::Program namespace to
+  Ronin::Program.
+
 === 0.1.0 / 2008-09-28
 
 * Changed how Sessions are setup.

data/Manifest.txt

@@ -83,6 +83,8 @@ lib/ronin/network/telnet.rb
 lib/ronin/network/http.rb
 lib/ronin/network/http/exceptions.rb
 lib/ronin/network/http/exceptions/unknown_request.rb
+lib/ronin/code/reference.rb
+lib/ronin/code/symbol_table.rb
 lib/ronin/rpc.rb
 lib/ronin/rpc/exceptions.rb
 lib/ronin/rpc/exceptions/not_implemented.rb
@@ -135,26 +137,24 @@ lib/ronin/cache/extension.rb
 lib/ronin/cache/ronin.rb
 lib/ronin/console.rb
 lib/ronin/shell.rb
-lib/ronin/runner.rb
-lib/ronin/runner/program.rb
-lib/ronin/runner/program/exceptions.rb
-lib/ronin/runner/program/exceptions/unknown_command.rb
-lib/ronin/runner/program/command.rb
-lib/ronin/runner/program/options.rb
-lib/ronin/runner/program/commands.rb
-lib/ronin/runner/program/commands/add.rb
-lib/ronin/runner/program/commands/install.rb
-lib/ronin/runner/program/commands/list.rb
-lib/ronin/runner/program/commands/update.rb
-lib/ronin/runner/program/commands/remove.rb
-lib/ronin/runner/program/commands/uninstall.rb
-lib/ronin/runner/program/commands/help.rb
-lib/ronin/runner/program/program.rb
-lib/ronin/runner/program/runner.rb
+lib/ronin/program.rb
+lib/ronin/program/exceptions.rb
+lib/ronin/program/exceptions/unknown_command.rb
+lib/ronin/program/command.rb
+lib/ronin/program/options.rb
+lib/ronin/program/commands.rb
+lib/ronin/program/commands/add.rb
+lib/ronin/program/commands/install.rb
+lib/ronin/program/commands/list.rb
+lib/ronin/program/commands/update.rb
+lib/ronin/program/commands/remove.rb
+lib/ronin/program/commands/uninstall.rb
+lib/ronin/program/commands/help.rb
+lib/ronin/program/program.rb
 lib/ronin/ronin.rb
 lib/ronin/version.rb
 tasks/spec.rb
-spec/helpers/
+spec/helpers.rb
 spec/spec_helper.rb
 spec/arch_spec.rb
 spec/author_spec.rb
@@ -173,6 +173,8 @@ spec/formatting/digest_spec.rb
 spec/formatting/html_spec.rb
 spec/formatting/http_spec.rb
 spec/formatting/text_spec.rb
+spec/code/reference_spec.rb
+spec/code/symbol_table_spec.rb
 spec/license_spec.rb
 spec/path_spec.rb
 spec/platform_spec.rb

data/README.txt

@@ -94,16 +94,16 @@ of Ronin.
 == REQUIREMENTS:
 
 * Hpricot
-* Mechanize
+* WWW::Mechanize
 * DataMapper:
-  * dm-core
-  * data_objects
-  * do_sqlite3
-  * dm-types
-  * dm-serializer
-  * dm-aggregates
-* reverserequire
-* R'epertoire
+  * dm-core >= 0.9.3
+  * data_objects >= 0.9.3
+  * do_sqlite3 >= 0.9.3
+  * dm-types >= 0.9.3
+  * dm-serializer >= 0.9.3
+  * dm-aggregates >= 0.9.3
+* reverse-require >= 0.1.0
+* R'epertoire >= 0.1.2
 
 == INSTALL:
 

data/Rakefile

@@ -18,7 +18,7 @@ Hoe.new('ronin', Ronin::VERSION) do |p|
                   ['dm-serializer', '>=0.9.3'],
                   ['dm-aggregates', '>=0.9.3'],
                   ['dm-validations', '>=0.9.3'],
-                  ['reverserequire', '>=0.1.0'],
+                  ['reverse-require', '>=0.1.2'],
                   ['repertoire', '>=0.1.2']]
 end
 

data/bin/ronin

@@ -7,6 +7,6 @@ unless $LOAD_PATH.include?(lib_dir)
   $LOAD_PATH << lib_dir
 end
 
-require 'ronin/runner/program'
+require 'ronin/program'
 
-Ronin::Runner.program(ARGV)
+Ronin::Program.run(*ARGV)

data/lib/ronin/author.rb

@@ -37,7 +37,7 @@ module Ronin
     property :id, Serial
 
     # Name of author
-    property :name, String
+    property :name, String, :index =>  true
 
     # Author's associated group
     property :organization, String

data/lib/ronin/cache/extension.rb

@@ -190,9 +190,7 @@ module Ronin
       #   end
       #
       def Extension.run_from(path,&block)
-        Extension.load_from(path) do |ext|
-          ext.run(&block)
-        end
+        Extension.load_from(path) { |ext| ext.run(&block) }
       end
 
       #
@@ -205,9 +203,7 @@ module Ronin
       #   end
       #
       def Extension.load(name,&block)
-        Extension.new(name) do |ext|
-          ext.include(name,&block)
-        end
+        Extension.new(name) { |ext| ext.include(name,&block) }
       end
 
       #
@@ -219,9 +215,7 @@ module Ronin
       #   end
       #
       def Extension.run(name,&block)
-        Extension.load(name) do |ext|
-          ext.run(&block)
-        end
+        Extension.load(name) { |ext| ext.run(&block) }
       end
 
       #
@@ -255,9 +249,7 @@ module Ronin
       #
       def include(name,&block)
         Extension.load_paths(name) do
-          Extension.each_path_for(name) do |path|
-            include_path(path)
-          end
+          Extension.each_path_for(name) { |path| include_path(path) }
         end
 
         block.call(self) if block

data/lib/ronin/cache/extension_cache.rb

@@ -38,9 +38,7 @@ module Ronin
         end
 
         catch('EXIT') do
-          each_extension do |ext|
-            ext.perform_teardown
-          end
+          each_extension { |ext| ext.perform_teardown }
         end
 
         block.call(self) if block

data/lib/ronin/cache/overlay.rb

@@ -146,7 +146,9 @@ module Ronin
       # <tt>:media</tt>:: The media of the Overlay.
       #
       def Overlay.install(options={},&block)
-        Repertoire.checkout(:media => options[:media], :uri => options[:uri], :into => Config::REPOSITORY_DIR) do |path,media,uri|
+        options = options.merge(:into => Config::REPOSITORY_DIR)
+
+        Repertoire.checkout(options) do |path,media,uri|
           return Overlay.add(path,media,uri,&block)
         end
       end
@@ -395,8 +397,6 @@ module Ronin
         if File.file?(metadata_path)
           metadata = REXML::Document.new(open(metadata_path))
 
-          #@authors = Author.from_xml(metadata,'/ronin-overlay/contributors/author')
-
           metadata.elements.each('/ronin-overlay') do |repo|
             @name = repo.elements['name'].get_text.to_s.strip
             @license = repo.elements['license'].get_text.to_s.strip

data/lib/ronin/cache/overlay_cache.rb

@@ -46,14 +46,12 @@ module Ronin
         @path = File.expand_path(path)
 
         if File.file?(@path)
-          File.open(@path) do |file|
-            descriptions = YAML.load(file)
-
-            if descriptions.kind_of?(Array)
-              descriptions.each do |repo|
-                if repo.kind_of?(Hash)
-                  add(Overlay.new(repo[:path],repo[:media],repo[:uri]))
-                end
+          descriptions = YAML.load(File.read(@path))
+
+          if descriptions.kind_of?(Array)
+            descriptions.each do |overlay|
+              if overlay.kind_of?(Hash)
+                add(Overlay.new(overlay[:path],overlay[:media],overlay[:uri]))
               end
             end
           end
@@ -135,11 +133,13 @@ module Ronin
       #   end
       #
       def add(repo,&block)
-        if has_overlay?(repo.name)
-          raise(OverlayCached,"overlay #{repo.to_s.dump} already present in the cache #{self.to_s.dump}",caller)
+        name = repo.name.to_s
+
+        if has_overlay?(name)
+          raise(OverlayCached,"overlay #{name.dump} already present in the cache #{self.to_s.dump}",caller)
         end
 
-        self[repo.name.to_s] = repo
+        self << repo
 
         block.call(self) if block
         return self
@@ -157,11 +157,13 @@ module Ronin
       #   end
       #
       def remove(repo,&block)
-        unless has_overlay?(repo.name)
-          raise(OverlayNotFound,"overlay #{repo.to_s.dump} is not present in the cache #{to_s.dump}",caller)
+        name = repo.name.to_s
+
+        unless has_overlay?(name)
+          raise(OverlayNotFound,"overlay #{name.dump} is not present in the cache #{self.to_s.dump}",caller)
         end
 
-        delete_if { |key,value| key==repo.name }
+        delete_if { |key,value| key == name }
 
         block.call(self) if block
         return self
@@ -200,7 +202,11 @@ module Ronin
 
         File.open(output_path,'w') do |output|
           descriptions = overlays.map do |repo|
-            {:media_type => repo.media_type, :path => repo.path, :uri => repo.uri}
+            {
+              :media_type => repo.media_type,
+              :path => repo.path,
+              :uri => repo.uri
+            }
           end
 
           YAML.dump(descriptions,output)

data/lib/ronin/chars/char_set.rb

@@ -26,26 +26,20 @@ module Ronin
     class CharSet < Array
 
       #
-      # Creates a new CharSet object with the given _characters_.
+      # Creates a new CharSet object with the given _chars_.
       #
-      def initialize(*characters)
+      def initialize(*chars)
         format_char = lambda { |char|
-          if char.kind_of?(Integer)
+          if (char.kind_of?(Array) || char.kind_of?(Range))
+            char.map(&format_char)
+          elsif char.kind_of?(Integer)
             char.chr
           else
             char.to_s
           end
         }
 
-        characters = characters.flatten.map do |char|
-          if char.kind_of?(Range)
-            char.to_a.map(&format_char)
-          else
-            format_char.call(char)
-          end
-        end
-
-        super(characters.flatten.uniq)
+        super(chars.map(&format_char).flatten.uniq)
       end
 
       #

data/lib/ronin/code/reference.rb

@@ -0,0 +1,142 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program 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 General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+#++
+#
+
+module Ronin
+  module Code
+    class Reference
+
+      # Object that is being referenced
+      attr_accessor :value
+
+      #
+      # Creates a new Reference object with the specified _value_ that will
+      # be referenced.
+      #
+      def initialize(value=nil)
+        @value = value
+      end
+
+      #
+      # Returns the class of the referenced object.
+      #
+      def class
+        @value.class
+      end
+
+      #
+      # Returns +true+ if the referenced object is a kind of _base_ class,
+      # returns +false+ otherwise.
+      #
+      def is_a?(base)
+        @value.is_a?(base) || super(base)
+      end
+
+      #
+      # Returns +true+ if the referenced object is a kind of _base_ class,
+      # returns +false+ otherwise.
+      #
+      def kind_of?(base)
+        @value.kind_of?(base) || super(base)
+      end
+
+      #
+      # Returns +true+ if the referenced object is an instance of the
+      # specified _base_ class, returns +false+ otherwise.
+      #
+      def instance_of?(base)
+        @value.instance_of?(base) || super(base)
+      end
+
+      #
+      # Returns +true+ if the referenced object responds to the specified
+      # method _name_, returns +false+ otherwise.
+      #
+      def respond_to?(name)
+        @value.respond_to?(name) || super(name)
+      end
+
+      #
+      # Extends the referenced object with the specified _base_ module.
+      #
+      def extend(base)
+        @value.extend(base) if @value
+        return self
+      end
+
+      #
+      # Evaluates the given _code_ within the referenced object. If a
+      # _block_ is given, it will be evaluated within the referenced
+      # object.
+      #
+      def eval(code,&block)
+        @value.eval(code,&block)
+      end
+
+      #
+      # Evaluates the given _block_ within the referenced object.
+      #
+      def instance_eval(&block)
+        @value.instance_eval(&block)
+      end
+
+      #
+      # Returns +true+ if the referenced object equals the specified
+      # _value_, returns +false+ otherwise.
+      #
+      def eql?(value)
+        @value.eql?(value) || super(value)
+      end
+
+      alias == eql?
+      alias === eql?
+
+      #
+      # Returns the String form of the referenced object.
+      #
+      def to_s
+        @value.to_s
+      end
+
+      #
+      # Inspects the referenced object.
+      #
+      def inspect
+        @value.inspect
+      end
+
+      protected
+
+      #
+      # Relays method calls to the referenced object.
+      #
+      def method_missing(name,*arguments,&block)
+        if @value.class.public_method_defined?(name)
+          return @value.send(name,*arguments,&block)
+        end
+
+        raise(NoMethodError,name.id2name)
+      end
+
+    end
+  end
+end

data/lib/ronin/code/symbol_table.rb

@@ -0,0 +1,90 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2008 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program 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 General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+#++
+#
+
+require 'ronin/code/reference'
+
+module Ronin
+  module Code
+    class SymbolTable
+
+      #
+      # Creates a new SymbolTable object with a given Hash of symbol names
+      # and their initial values.
+      #
+      def initialize(symbols={})
+        @table = Hash.new { |hash,key| hash[key] = Reference.new }
+
+        self.symbols = symbols
+      end
+
+      #
+      # Returns +true+ if the table has the symbol with the specified
+      # _name_, returns +false+ otherwise.
+      #
+      def has_symbol?(name)
+        @table.has_key?(name.to_s)
+      end
+
+      #
+      # Returns the symbol with the specified _name_.
+      #
+      def symbol(name)
+        @table[name.to_s]
+      end
+
+      #
+      # Sets the symbol values en-mass using the specified _hash_ of
+      # symbol names and their values.
+      #
+      def symbols=(hash)
+        hash.each do |name,value|
+          self[name] = value
+        end
+      end
+
+      #
+      # Returns the value of the symbol with the specified _name_.
+      #
+      def [](name)
+        @table[name.to_s].value
+      end
+
+      #
+      # Sets the _value_ of the symbol with the specified _name_.
+      #
+      def []=(name,value)
+        @table[name.to_s].value = value
+      end
+
+      #
+      # Inspects the symbol table.
+      #
+      def inspect
+        '{' + @table.map { |name,symbol|
+          "#{name.inspect}=>#{symbol.inspect}"
+        }.join(', ') + '}'
+      end
+
+    end
+  end
+end

data/lib/ronin/context.rb

@@ -216,7 +216,7 @@ module Ronin
       new_objs = []
 
       Context.load_blocks(path) do |pending|
-        pending.blocks.each do |name,context_block|
+        pending.each_block do |name,context_block|
           if Context.is_context?(name)
             new_obj = Context.contexts[name].new
             new_obj.instance_eval(&context_block)

data/lib/ronin/database.rb

@@ -80,6 +80,13 @@ module Ronin
       @@ronin_database_config = configuration
     end
 
+    #
+    # Returns the current Database log.
+    #
+    def Database.log
+      @@ronin_database_log ||= nil
+    end
+
     #
     # Setup the Database log with the given _options_.
     #
@@ -94,8 +101,7 @@ module Ronin
       stream = (options[:stream] || File.new(path,'w+'))
       level = (options[:level] || DEFAULT_LOG_LEVEL)
 
-      DataMapper::Logger.new(stream,level)
-      return nil
+      return @@ronin_database_log = DataMapper::Logger.new(stream,level)
     end
 
     #
@@ -104,7 +110,10 @@ module Ronin
     # the Database.
     #
     def Database.setup(configuration=Database.config,&block)
-      Database.setup_log
+      # setup the database log
+      Database.setup_log unless Database.log
+
+      # setup the database repository
       DataMapper.setup(Model::REPOSITORY_NAME, configuration)
 
       block.call if block

data/lib/ronin/extensions/string.rb

@@ -34,4 +34,53 @@ class String
     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
+  # returned.
+  #
+  def common_prefix(other)
+    min_length = [length, other.length].min
+
+    min_length.times do |i|
+      if self[i] != other[i]
+        return self[0...i]
+      end
+    end
+
+    return self[0...min_length]
+  end
+
+  #
+  # Returns the common postfix of the string and the specified _other_
+  # string. If no common postfix can be found an empty string will be
+  # returned.
+  #
+  def common_postfix(other)
+    min_length = [length, other.length].min
+
+    (min_length - 1).times do |i|
+      index = (length - i -1)
+      other_index = (other.length - i -1)
+
+      if self[index] != other[other_index]
+        return self[(index + 1)..-1]
+      end
+    end
+
+    return ''
+  end
+
+  #
+  # Returns the uncommon substring within the specified _other_ string,
+  # which does not occur within the string. If no uncommon substring can be
+  # found, an empty string will be returned.
+  #
+  def uncommon_substring(other)
+    prefix = common_prefix(other)
+    postfix = self[prefix.length..-1].common_postfix(other[prefix.length..-1])
+
+    return self[prefix.length...(length - postfix.length)]
+  end
+
 end

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

@@ -39,14 +39,19 @@ class String
     excluded = (options[:excluded] || [])
 
     formatted = included - excluded
+    formatted = ''
+
+    self.each_byte do |b|
+      c = b.chr
 
-    return self.scan(/./m).map { |c|
       if formatted.include?(c)
-        block.call(c)
+        formatted_chars << block.call(c)
       else
-        c
+        formatted_chars << c
       end
-    }.join
+    end
+
+    return formatted
   end
 
   #
@@ -81,7 +86,7 @@ class String
   # "get out your checkbook".rand_case
   # # => "gEt Out YOur CHEckbook"
   #
-  def rand_case(options={})
+  def random_case(options={})
     prob = (options[:probability] || 0.5)
 
     format_chars(options) do |c|