ronin 0.1.1 → 0.1.2

data/lib/ronin/{extensions/kernel.rb → hexdump/extensions/file.rb}

@@ -21,14 +21,16 @@
 #++
 #
 
-require 'reverse_require'
+require 'ronin/hexdump/hexdump'
+
+class File
 
-module Kernel
   #
-  # Requires the specified _path_ from all RubyGems that both depends on
-  # Ronin and contains the specified _path_.
+  # Hexdumps the contents of the File at the specified _path_
+  # to the given _output_ stream.
   #
-  def ronin_require(path)
-    reverse_require(:ronin,path)
+  def self.hexdump(path,output=STDOUT)
+    Ronin::Hexdump.dump(self.open(path),output)
   end
+
 end

data/lib/ronin/{persistence.rb → hexdump/extensions/kernel.rb}

@@ -21,12 +21,13 @@
 #++
 #
 
-require 'ronin/extensions/kernel'
-require 'ronin/database'
+require 'ronin/hexdump/hexdump'
 
-module Ronin
-  Database.setup do
-    ronin_require 'ronin/models'
-    ronin_require 'ronin/objects'
+module Kernel
+  #
+  # Hexdumps the specified _object_ to the given _output_ stream.
+  #
+  def hexdump(object,output=STDOUT)
+    Ronin::Hexdump.dump(object,output)
   end
 end

data/lib/ronin/hexdump/hexdump.rb

@@ -0,0 +1,76 @@
+#
+#--
+# 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 Hexdump
+    #
+    # Hexdumps the specified _object_ to the given _output_ stream.
+    #
+    def Hexdump.dump(object,output=STDOUT)
+      index = 0
+      offset = 0
+      hex_segment = nil
+      print_segment = nil
+
+      segment = lambda {
+        output.printf(
+          "%.8x  %s  |%s|\n",
+          index,
+          hex_segment.join(' ').ljust(47).insert(23,' '),
+          print_segment
+        )
+      }
+
+      object.each_byte do |b|
+        if offset == 0
+          hex_segment = []
+          print_segment = []
+        end
+
+        hex_segment << ("%.2x" % b)
+
+        print_segment[offset] = case b
+                                when (0x20..0x7e)
+                                  b.chr
+                                else
+                                  '.'
+                                end
+
+        offset += 1
+
+        if (offset >= 16)
+          segment.call
+
+          offset = 0
+          index += 16
+        end
+      end
+
+      unless offset == 0
+        segment.call
+      end
+
+      return nil
+    end
+  end
+end

data/lib/ronin/license.rb

@@ -66,9 +66,11 @@ module Ronin
       url = options[:url].to_s
 
       meta_def(name.to_method_name) do
-        License.first_or_create(:name => name,
-                                :description => description,
-                                :url => url)
+        License.first_or_create(
+          :name => name,
+          :description => description,
+          :url => url
+        )
       end
 
       return nil

data/lib/ronin/model.rb

@@ -21,8 +21,6 @@
 #++
 #
 
-require 'ronin/extensions/meta'
-
 require 'dm-core'
 require 'dm-types'
 require 'dm-serializer'
@@ -41,10 +39,14 @@ module Ronin
         include DataMapper::Resource
         include DataMapper::AutoMigrations
 
+        #
+        # Returns the default repository name for the model.
+        #
         def self.default_repository_name
           Model::REPOSITORY_NAME
         end
 
+        # The class type property
         property :type, Discriminator
       end
     end

data/lib/ronin/models.rb

@@ -21,7 +21,13 @@
 #++
 #
 
-require 'ronin/extensions/kernel'
+require 'ronin/database'
 require 'ronin/model'
 
-ronin_require 'ronin/models'
+require 'reverse_require'
+
+module Ronin
+  Database.setup do
+    require_all 'ronin/models'
+  end
+end

data/lib/ronin/object_context.rb

@@ -25,8 +25,9 @@ require 'ronin/exceptions/unknown_object_context'
 require 'ronin/exceptions/object_context_not_found'
 require 'ronin/extensions/meta'
 require 'ronin/context'
+require 'ronin/model'
 
-require 'dm-core'
+require 'parameters'
 
 module Ronin
   module ObjectContext
@@ -34,19 +35,20 @@ module Ronin
 
     def self.included(base)
       base.class_eval do
-        include Model
         include Context
+        include Parameters
+        include Model
 
-        metaclass_def(:object_contextify) do |name|
-          ObjectContext.object_contexts[name] = self
+        # The Path to the object context
+        property :object_path, String, :key => true
 
-          contextify name
+        # The modification timestamp of the object context
+        property :object_timestamp, EpochTime
 
-          # The Path to the object context
-          property :object_path, String, :key => true
+        metaclass_def(:objectify) do |name|
+          ObjectContext.object_contexts[name] = self
 
-          # The modification timestamp of the object context
-          property :object_timestamp, EpochTime
+          contextify name
 
           meta_def(:load_object) do |path,*args|
             ObjectContext.load_object(context_name,path,*args)
@@ -71,50 +73,6 @@ module Ronin
             all(*attribs).map { |obj| obj.object }
           end
 
-          class_def(:object) do
-            self.class.load_object(self.object_path)
-          end
-
-          class_def(:missing?) do
-            if self.object_path
-              return !(File.file?(self.object_path))
-            end
-
-            return false
-          end
-
-          class_def(:stale?) do
-            if self.object_timestamp
-              return File.mtime(self.object_path) > self.object_timestamp
-            end
-
-            return false
-          end
-
-          class_def(:cache) do
-            if self.object_path
-              self.object_timestamp = File.mtime(self.object_path)
-              return save
-            end
-
-            return false
-          end
-
-          class_def(:mirror) do
-            if self.object_path
-              unless File.file?(self.object_path)
-                return destroy
-              else
-                if (!(dirty?) && stale?)
-                  destroy
-                  return object.cache
-                end
-              end
-            end
-
-            return false
-          end
-
           # define Repo-level object loader method
           Ronin.module_eval %{
             def ronin_load_#{name}(path,*args,&block)
@@ -196,7 +154,11 @@ module Ronin
     # Cache all objects loaded from the specified _path_.
     #
     def ObjectContext.cache_objects(path)
-      ObjectContext.load_objects(path).each { |obj| obj.cache }
+      ObjectContext.load_objects(path).each do |obj|
+        obj.cache
+      end
+
+      return nil
     end
 
     #
@@ -207,10 +169,7 @@ module Ronin
       directory = File.expand_path(directory)
       paths = Dir[File.join(directory,'**','*.rb')]
 
-      paths.each do |path|
-        ObjectContext.load_objects(path).each { |obj| obj.cache }
-      end
-
+      paths.each { |path| ObjectContext.cache_objects(path) }
       return nil
     end
 
@@ -221,17 +180,18 @@ module Ronin
     #
     def ObjectContext.mirror_objects_in(directory)
       directory = File.expand_path(directory)
-      paths = Dir[File.join(directory,'**','*.rb')]
+      new_paths = Dir[File.join(directory,'**','*.rb')]
 
       ObjectContext.object_contexts.each_value do |base|
         objects = base.all(:object_path.like => "#{directory}%")
-        paths -= objects.map { |obj| obj.object_path }
+        new_paths -= objects.map { |obj| obj.object_path }
 
+        # mirror existing objects
         objects.each { |obj| obj.mirror }
       end
 
-      paths.each { |path| ObjectContext.cache_objects(path) }
-
+      # cache the remaining new paths
+      new_paths.each { |path| ObjectContext.cache_objects(path) }
       return nil
     end
 
@@ -247,5 +207,72 @@ module Ronin
 
       return nil
     end
+
+    #
+    # Returns a new object loaded from the file pointed to by the
+    # +object_path+ property.
+    #
+    def object
+      self.class.load_object(self.object_path)
+    end
+
+    #
+    # Returns +true+ if the file pointed to by the +object_path+
+    # property is missing, returns +false+ otherwise.
+    #
+    def missing?
+      if self.object_path
+        return !(File.file?(self.object_path))
+      end
+
+      return false
+    end
+
+    #
+    # Returns +true+ if the +object_timestamp+ property is older than
+    # the modification time on the file pointed to by the +object_path+
+    # property, returns +false+ otherwise.
+    #
+    def stale?
+      if self.object_timestamp
+        return File.mtime(self.object_path) > self.object_timestamp
+      end
+
+      return false
+    end
+
+    #
+    # Sets the +object_timestamp+ property to the modification time of the
+    # file pointed to by the +object_path+ property and saves the object.
+    #
+    def cache
+      if self.object_path
+        self.object_timestamp = File.mtime(self.object_path)
+        return save
+      end
+
+      return false
+    end
+
+    #
+    # If the file pointed to by the +object_path+ property is missing, the
+    # object will be destroyed. If the object has not been changed and
+    # is stale?, a newly loaded object from the file pointed to by the
+    # +object_path+ property will be cached.
+    #
+    def mirror
+      if self.object_path
+        unless File.file?(self.object_path)
+          return destroy
+        else
+          if (!(dirty?) && stale?)
+            destroy
+            return object.cache
+          end
+        end
+      end
+
+      return false
+    end
   end
 end

data/lib/ronin/rpc/console.rb

@@ -22,7 +22,7 @@
 #
 
 require 'ronin/rpc/service'
-require 'ronin/rpc/interactive_console'
+require 'ronin/ui/shell'
 
 module Ronin
   module RPC
@@ -58,11 +58,13 @@ module Ronin
       end
 
       #
-      # Starts an InteractiveConsole that allows a user to evaluate code
-      # and inspect the return-value.
+      # Starts a Shell that allows a user to execute PHP expressions and
+      # observe their results.
       #
       def interact
-        InteractiveConsole.start(self)
+        UI::Shell.start(:prompt => '>>') do |shell,line|
+          shell.puts "=> #{inspect(line)}"
+        end
       end
 
       protected

data/lib/ronin/rpc/shell.rb

@@ -22,7 +22,7 @@
 #
 
 require 'ronin/rpc/service'
-require 'ronin/rpc/interactive_shell'
+require 'ronin/ui/shell'
 
 module Ronin
   module RPC
@@ -45,11 +45,11 @@ module Ronin
       end
 
       #
-      # Starts an InteractiveShell that allows a user to execute commands
-      # and observe their output.
+      # Starts a Shell that allows a user to execute commands and observe
+      # their output.
       #
       def interact
-        InteractiveShell.start(self)
+        UI::Shell.start(:prompt => '$') { |shell,line| system(line) }
       end
 
       protected

data/lib/ronin/sessions/http.rb

@@ -0,0 +1,144 @@
+#
+#--
+# Ronin - A ruby development 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/sessions/session'
+require 'ronin/network/http'
+require 'ronin/network/extensions/http'
+
+module Ronin
+  module Sessions
+    module HTTP
+      include Session
+
+      setup_session do
+        parameter :http_user, :description => 'HTTP user'
+        parameter :http_password, :description => 'HTTP password'
+
+        parameter :http_proxy, :description => 'HTTP Proxy'
+
+        parameter :http_user_agent, :description => 'Web User-Agent'
+      end
+
+      protected
+
+      #
+      # Resets the HTTP proxy settings.
+      #
+      def disable_http_proxy
+        @http_proxy = nil
+      end
+
+      #
+      # Connects to the HTTP server using the given _options_. If a _block_
+      # is given it will be passed the newly created <tt>Net::HTTP</tt>
+      # object.
+      #
+      # _options_ may contain the following keys:
+      # <tt>:host</tt>:: The host the HTTP server is running on.
+      # <tt>:port</tt>:: The port the HTTP server is running on. Defaults to
+      #                  <tt>Net::HTTP.default_port</tt>.
+      # <tt>:url</tt>:: The full URL to request.
+      # <tt>:user</tt>:: The user to authenticate with when connecting to the
+      #                  HTTP server.
+      # <tt>:password</tt>:: The password to authenticate with when
+      #                      connecting to the HTTP server.
+      # <tt>:path</tt>:: The path to request from the HTTP server.
+      #
+      def http_session(options={},&block)
+        Net.http_session(http_merge_options(options),&block)
+      end
+
+      def http_copy(options={},&block)
+        Net.http_copy(http_merge_options(options),&block)
+      end
+
+      def http_delete(options={},&block)
+        Net.http_delete(http_merge_options(options),&block)
+      end
+
+      def http_get(options={},&block)
+        Net.http_get(http_merge_options(options),&block)
+      end
+
+      def http_get_body(options={},&block)
+        Net.http_get_body(http_merge_options(options),&block)
+      end
+
+      def http_head(options={},&block)
+        Net.http_head(http_merge_options(options),&block)
+      end
+
+      def http_lock(options={},&block)
+        Net.http_lock(http_merge_options(options),&block)
+      end
+
+      def http_mkcol(options={},&block)
+        Net.http_mkcol(http_merge_options(options),&block)
+      end
+
+      def http_move(options={},&block)
+        Net.http_move(http_merge_options(options),&block)
+      end
+
+      def http_options(options={},&block)
+        Net.http_options(http_merge_options(options),&block)
+      end
+
+      def http_post(options={},&block)
+        Net.http_post(http_merge_options(options),&block)
+      end
+
+      def http_post_body(options={},&block)
+        Net.http_post_body(http_merge_options(options),&block)
+      end
+
+      def http_prop_find(options={},&block)
+        Net.http_prop_find(http_merge_options(options),&block)
+      end
+
+      def http_prop_path(options={},&block)
+        Net.http_prop_path(http_merge_options(options),&block)
+      end
+
+      def http_trace(options={},&block)
+        Net.http_trace(http_merge_options(options),&block)
+      end
+
+      def http_unlock(options={},&block)
+        Net.http_unlock(http_merge_options(options),&block)
+      end
+
+      private
+
+      def http_merge_options(options={})
+        options[:user] ||= @http_user if @http_user
+        options[:password] ||= @http_password if @http_password
+
+        options[:proxy] ||= @http_proxy if @http_proxy
+        options[:user_agent] ||= @http_user_agent if @http_user_agent
+
+        return options
+      end
+    end
+  end
+end