ronin 0.2.1 → 0.2.2

data/lib/ronin/platform/overlay_cache.rb

@@ -286,7 +286,7 @@ module Ronin
           descriptions = overlays.map do |overlay|
             {
               :path => overlay.path,
-              :media => overlay.media_type,
+              :media => overlay.media,
               :uri => overlay.uri
             }
           end

data/lib/ronin/platform/platform.rb

@@ -96,10 +96,21 @@ module Ronin
     # <tt>:media</tt>:: The media of the overlay.
     #
     def Platform.install(options={},&block)
-      options = options.merge(:into => OverlayCache::CACHE_DIR)
+      unless options[:uri]
+        raise(ArgumentError,":uri must be passed to Platform.install",caller)
+      end
 
-      Repertoire.checkout(options) do |path,media,uri|
-        return Platform.add(:path => path, :media => media, :uri => uri)
+      uri = options[:uri].to_s
+      host = (URI(uri).host || 'localhost')
+      host_dir = File.join(OverlayCache::CACHE_DIR,host)
+      options = options.merge(:into => host_dir)
+
+      Repertoire.checkout(options) do |repo|
+        return Platform.add(
+          :path => repo.path,
+          :media => repo.media_name,
+          :uri => uri
+        )
       end
     end
 

data/lib/ronin/platform/ronin.rb

@@ -23,11 +23,30 @@
 
 require 'ronin/platform/platform'
 
+require 'extlib'
+
 module Ronin
   protected
 
   #
-  # Provides transparent access to Platform.extension.
+  # Provides transparent access to Platform.extension via constants.
+  #
+  #   Ronin::Shellcode
+  #   # => #<Ronin::Platform::Extension: ...>
+  #
+  def Ronin.const_missing(name)
+    name = name.to_s
+    ext_name = name.snake_case
+
+    if Platform.has_extension?(ext_name)
+      return Platform.extension(ext_name)
+    end
+
+    return super(name)
+  end
+
+  #
+  # Provides transparent access to Platform.extension via methods.
   #
   #   Ronin.shellcode
   #   # => #<Ronin::Platform::Extension: ...>

data/lib/ronin/platform/tasks/spec.rb

@@ -0,0 +1,9 @@
+require 'spec/rake/spectask'
+
+desc "Run all specifications"
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.libs += ['lib'] + Dir['**/lib'] + ['spec']
+  t.spec_opts = ['--colour', '--format', 'specdoc']
+end
+
+task :default => :spec

data/lib/ronin/{chars.rb → static.rb}

@@ -21,5 +21,5 @@
 #++
 #
 
-require 'ronin/chars/char_set'
-require 'ronin/chars/chars'
+require 'ronin/static/static'
+require 'ronin/static/finders'

data/lib/ronin/static/finders.rb

@@ -0,0 +1,144 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2009 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/static/static'
+
+module Ronin
+  module Static
+    module Finders
+      #
+      # Passes all possible static paths for the specified _path_,
+      # within the static directories, to the specified _block_.
+      #
+      def static_paths(path,&block)
+        Static.static_dirs.each do |dir|
+          block.call(File.join(dir,path))
+        end
+      end
+
+      #
+      # Returns the first matching static path for the specified _path_.
+      # If no matching static path can be found, +nil+ will be returned.
+      #
+      def static_find(path)
+        static_paths(path) do |full_path|
+          return full_path if File.exists?(full_path)
+        end
+
+        return nil
+      end
+
+      #
+      # Returns the first matching static file for the specified _path_.
+      # If no matching static file can be found, +nil+ will be returned.
+      #
+      def find_static_file(path)
+        static_paths(path) do |full_path|
+          return full_path if File.file?(full_path)
+        end
+
+        return nil
+      end
+
+      #
+      # Returns the first matching static directory for the specified
+      # _path_. If no matching static directory can be found, +nil+ will be
+      # returned.
+      #
+      def find_static_dir(path)
+        static_paths(path) do |full_path|
+          return full_path if File.directory?(full_path)
+        end
+
+        return nil
+      end
+
+      #
+      # Returns the first set of matching static paths for the specified
+      # _pattern_. If no matching static paths can be found, an empty
+      # Array will be returned.
+      #
+      def static_glob(pattern)
+        static_paths(pattern) do |full_path|
+          paths = Dir[full_path]
+
+          return paths unless paths.empty?
+        end
+
+        return []
+      end
+
+      #
+      # Returns all matching static paths for the specified _path_.
+      #
+      def static_find_all(path)
+        paths = []
+
+        static_paths(path) do |full_path|
+          paths << full_path if File.exists?(full_path)
+        end
+
+        return paths
+      end
+
+      #
+      # Returns all matching static files for the specified _path_.
+      #
+      def find_static_files(path)
+        paths = []
+
+        static_paths(path) do |full_path|
+          paths << full_path if File.file?(full_path)
+        end
+
+        return paths
+      end
+
+      #
+      # Returns all matching static directories for the specified _path_.
+      #
+      def find_static_dirs(path)
+        paths = []
+
+        static_paths(path) do |full_path|
+          paths << full_path if File.directory?(full_path)
+        end
+
+        return paths
+      end
+
+      #
+      # Returns all matching static paths for the specified _pattern_.
+      #
+      def static_glob_all(pattern)
+        paths = []
+
+        static_paths(pattern) do |full_path|
+          paths += Dir[full_path]
+        end
+
+        return paths
+      end
+    end
+  end
+end

data/lib/ronin/static/static.rb

@@ -0,0 +1,53 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2009 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 'set'
+
+module Ronin
+  module Static
+    #
+    # The Set of directories which contain static content.
+    #
+    def Static.static_dirs
+      @@ronin_static_dirs ||= Set[]
+    end
+
+    #
+    # Adds the specified _path_ to the Set of static directories.
+    #
+    def Static.directory(path)
+      path = File.expand_path(path)
+
+      unless File.directory?(path)
+        raise("#{path.dump} must be a directory")
+      end
+
+      Static.static_dirs << path
+      return path
+    end
+
+    protected
+
+    Static.directory(File.join(File.dirname(__FILE__),'..','..','..','static'))
+  end
+end

data/lib/ronin/ui/command_line/commands/add.rb

@@ -45,15 +45,31 @@ module Ronin
               end
 
               opts.on('-m','--media MEDIA','Spedify the media-type of the overlay') do |media|
-                @media = media
+                @media = media.to_sym
               end
 
-              opts.on('-U','--uri URI','Specify the source URI of the overlay') do |uri|
-                @uri = uri
+              opts.on('-L','--local','Similiar to: -m local') do
+                @media = nil
+              end
+
+              opts.on('--rsync','Alias for -m rsync') do
+                @media = :rsync
+              end
+
+              opts.on('--svn','Alias for -m svn') do
+                @media = :svn
               end
 
-              opts.on('-L','--local','Similiar to: --media local') do
-                @media = :local
+              opts.on('--hg','Alias for -m hg') do
+                @media = :hg
+              end
+
+              opts.on('--git','Alias for -m git') do
+                @media = :git
+              end
+
+              opts.on('-U','--uri URI','Specify the source URI of the overlay') do |uri|
+                @uri = uri
               end
             end
 

data/lib/ronin/ui/command_line/commands/install.rb

@@ -43,8 +43,24 @@ module Ronin
                 @cache = dir
               end
 
-              opts.on('-m','--media [MEDIA]','Spedify the media-type of the overlay') do |media|
-                @media = media
+              opts.on('-m','--media MEDIA','Spedify the media-type of the overlay') do |media|
+                @media = media.to_sym
+              end
+
+              opts.on('--rsync','Alias for -m rsync') do
+                @media = :rsync
+              end
+
+              opts.on('--svn','Alias for -m svn') do
+                @media = :svn
+              end
+
+              opts.on('--hg','Alias for -m hg') do
+                @media = :hg
+              end
+
+              opts.on('--git','Alias for -m git') do
+                @media = :git
               end
             end
 
@@ -57,7 +73,7 @@ module Ronin
             }
           end
 
-          def arguments(args)
+          def arguments(*args)
             unless args.length == 1
               fail('only one overlay URI maybe specified')
             end

data/lib/ronin/ui/command_line/commands/rm.rb

@@ -60,7 +60,7 @@ module Ronin
 
             args.each do |name|
               Platform.remove(name) do |overlay|
-                puts "Removing #{overlay.name.dump} ..."
+                puts "Removing Overlay #{overlay.name.dump} ..."
               end
             end
           end

data/lib/ronin/ui/command_line/commands/uninstall.rb

@@ -60,7 +60,7 @@ module Ronin
 
             args.each do |name|
               Platform.uninstall(name) do |overlay|
-                puts "Uninstalling #{overlay.name.dump} ..."
+                puts "Uninstalling Overlay #{overlay.name.dump} ..."
               end
             end
           end

data/lib/ronin/ui/command_line/commands/update.rb

@@ -58,10 +58,17 @@ module Ronin
           def arguments(*args)
             Platform.load_overlays(@cache) if @cache
 
+            update = lambda { |overlay|
+              puts "Updating Overlay #{overlay.name.dump} ..."
+              overlay.update
+            }
+
             if args.empty?
-              Platform.overlays.each_overlay { |overlay| overlay.update }
+              Platform.overlays.each_overlay(&update)
             else
-              args.each { |name| Platform.overlays.update(name) }
+              args.each do |name|
+                update.call(Platform.overlays.update(name))
+              end
             end
           end
 

data/lib/ronin/version.rb

@@ -23,5 +23,5 @@
 
 module Ronin
   # Ronin version 
-  VERSION = '0.2.1'
+  VERSION = '0.2.2'
 end

data/spec/extensions/string_spec.rb

@@ -3,16 +3,6 @@ require 'ronin/extensions/string'
 require 'spec_helper'
 
 describe String do
-  describe "to_method_name" do
-    it "should be able to convert proper names to method names" do
-      "Proper Name".to_method_name.should == 'proper_name'
-    end
-
-    it "should be able to convert Class names to method names" do
-      "Namespace::Test".to_method_name.should == 'namespace_test'
-    end
-  end
-
   describe "common_prefix" do
     it "should find the common prefix between two Strings" do
       one = 'What is puzzling you is the nature of my game'

data/spec/formatting/binary/helpers/hexdumps.rb

@@ -0,0 +1,14 @@
+def load_binary_data(name)
+  path = File.join(File.dirname(__FILE__),'hexdumps',"#{name}.bin")
+  buffer = []
+
+  File.open(path) do |file|
+    file.each_byte { |b| buffer << b }
+  end
+
+  return buffer
+end
+
+def load_hexdump(name)
+  File.read(File.join(File.dirname(__FILE__),'hexdumps',"#{name}.txt"))
+end

data/spec/formatting/binary/helpers/hexdumps/hexdump_decimal_shorts.txt

@@ -0,0 +1,17 @@
+0000000   00256   00770   01284   01798   02312   02826   03340   03854
+0000010   04368   04882   05396   05910   06424   06938   07452   07966
+0000020   08480   08994   09508   10022   10536   11050   11564   12078
+0000030   12592   13106   13620   14134   14648   15162   15676   16190
+0000040   16704   17218   17732   18246   18760   19274   19788   20302
+0000050   20816   21330   21844   22358   22872   23386   23900   24414
+0000060   24928   25442   25956   26470   26984   27498   28012   28526
+0000070   29040   29554   30068   30582   31096   31610   32124   32638
+0000080   33152   33666   34180   34694   35208   35722   36236   36750
+0000090   37264   37778   38292   38806   39320   39834   40348   40862
+00000a0   41376   41890   42404   42918   43432   43946   44460   44974
+00000b0   45488   46002   46516   47030   47544   48058   48572   49086
+00000c0   49600   50114   50628   51142   51656   52170   52684   53198
+00000d0   53712   54226   54740   55254   55768   56282   56796   57310
+00000e0   57824   58338   58852   59366   59880   60394   60908   61422
+00000f0   61936   62450   62964   63478   63992   64506   65020   65534
+0000100