ronin 0.1.4 → 0.2.0

data/lib/ronin/version.rb

@@ -23,5 +23,5 @@
 
 module Ronin
   # Ronin version 
-  VERSION = '0.1.4'
+  VERSION = '0.2.0'
 end

data/spec/chars/chars_spec.rb

@@ -66,8 +66,6 @@ describe Chars do
   end
 
   it "should provide a symbols CharSet" do
-    pending "need to fix the testing regex" do
-      (@symbols_string =~ /[\@\#\$\%\^\&\*\_\+\=\|\\\<\>\/]{10}/).should_not be_nil
-    end
+    (@symbols_string =~ /[\@\#\$\%\^\&\*\_\+\=\|\\\<\>\/]/).should_not be_nil
   end
 end

data/spec/formatting/binary/integer_spec.rb

@@ -3,53 +3,65 @@ require 'ronin/formatting/binary'
 require 'spec_helper'
 
 describe Integer do
-  before(:all) do
-    @integer = 0x1337
-
-    @i386_packed_int = "7\023\000\000"
-    @i386_packed_short = "7\023"
-    @i386_packed_long = "7\023\000\000"
-    @i386_packed_quad = "7\023\000\000\000\000\000\000"
-
-    @ppc_packed_int = "\000\000\0237"
-    @ppc_packed_short = "\0237"
-    @ppc_packed_long = "\000\000\0237"
-    @ppc_packed_quad = "\000\000\000\000\000\000\0237"
-  end
-
   it "should provide Integer#pack" do
-    @integer.respond_to?('pack').should == true
+    Integer.instance_method('pack').should_not be_nil
   end
 
-  it "Integer#pack should pack itself for a little-endian architecture" do
-    @integer.pack(Arch.i386).should == @i386_packed_int
+  it "should provide Integer#hex_escape" do
+    Integer.instance_method('hex_escape').should_not be_nil
   end
 
-  it "Integer#pack should pack itself as a short for a little-endian architecture" do
-    @integer.pack(Arch.i386,2).should == @i386_packed_short
-  end
+  describe "pack" do
+    before(:all) do
+      @integer = 0x1337
 
-  it "Integer#pack should pack itself as a long for a little-endian architecture" do
-    @integer.pack(Arch.i386,4).should == @i386_packed_long
-  end
+      @i386_packed_int = "7\023\000\000"
+      @i386_packed_short = "7\023"
+      @i386_packed_long = "7\023\000\000"
+      @i386_packed_quad = "7\023\000\000\000\000\000\000"
 
-  it "Integer#pack should pack itself as a quad for a little-endian architecture" do
-    @integer.pack(Arch.i386,8).should == @i386_packed_quad
-  end
+      @ppc_packed_int = "\000\000\0237"
+      @ppc_packed_short = "\0237"
+      @ppc_packed_long = "\000\000\0237"
+      @ppc_packed_quad = "\000\000\000\000\000\000\0237"
+    end
 
-  it "Integer#pack should pack itself for a big-endian architecture" do
-    @integer.pack(Arch.ppc).should == @ppc_packed_int
-  end
+    it "should pack itself for a little-endian architecture" do
+      @integer.pack(Arch.i386).should == @i386_packed_int
+    end
 
-  it "Integer#pack should pack itself as a short for a big-endian architecture" do
-    @integer.pack(Arch.ppc,2).should == @ppc_packed_short
-  end
+    it "should pack itself as a short for a little-endian architecture" do
+      @integer.pack(Arch.i386,2).should == @i386_packed_short
+    end
+
+    it "Integer#pack should pack itself as a long for a little-endian architecture" do
+      @integer.pack(Arch.i386,4).should == @i386_packed_long
+    end
+
+    it "should pack itself as a quad for a little-endian architecture" do
+      @integer.pack(Arch.i386,8).should == @i386_packed_quad
+    end
+
+    it "should pack itself for a big-endian architecture" do
+      @integer.pack(Arch.ppc).should == @ppc_packed_int
+    end
+
+    it "should pack itself as a short for a big-endian architecture" do
+      @integer.pack(Arch.ppc,2).should == @ppc_packed_short
+    end
+
+    it "should pack itself as a long for a big-endian architecture" do
+      @integer.pack(Arch.ppc,4).should == @ppc_packed_long
+    end
 
-  it "Integer#pack should pack itself as a long for a big-endian architecture" do
-    @integer.pack(Arch.ppc,4).should == @ppc_packed_long
+    it "should pack itself as a quad for a big-endian architecture" do
+      @integer.pack(Arch.ppc,8).should == @ppc_packed_quad
+    end
   end
 
-  it "Integer#pack should pack itself as a quad for a big-endian architecture" do
-    @integer.pack(Arch.ppc,8).should == @ppc_packed_quad
+  describe "hex_escape" do
+    it "should hex escape an Integer" do
+      42.hex_escape.should == "\\x2a"
+    end
   end
 end

data/spec/formatting/binary/string_spec.rb

@@ -3,12 +3,74 @@ require 'ronin/formatting/binary'
 require 'spec_helper'
 
 describe String do
-  before(:all) do
-    @packed_integer = ""
+  it "should provide String#depack" do
+    String.instance_method('depack').should_not be_nil
   end
 
-  it "should provide String#depack" do
-    @packed_integer.respond_to?('depack').should == true
+  it "should provide String#hex_escape" do
+    String.instance_method('hex_escape').should_not be_nil
+  end
+
+  it "should provide String#xor" do
+    String.instance_method('xor').should_not be_nil
+  end
+
+  describe "pack" do
+    before(:all) do
+      @integer = 0x1337
+
+      @i386_packed_int = "7\023\000\000"
+      @i386_packed_short = "7\023"
+      @i386_packed_long = "7\023\000\000"
+      @i386_packed_quad = "7\023\000\000\000\000\000\000"
+
+      @ppc_packed_int = "\000\000\0237"
+      @ppc_packed_short = "\0237"
+      @ppc_packed_long = "\000\000\0237"
+      @ppc_packed_quad = "\000\000\000\000\000\000\0237"
+    end
+
+    it "should pack itself for a little-endian architecture" do
+      @i386_packed_int.depack(Arch.i386).should == @integer
+    end
+
+    it "should pack itself as a short for a little-endian architecture" do
+      @i386_packed_short.depack(Arch.i386,2).should == @integer
+    end
+
+    it "Integer#pack should pack itself as a long for a little-endian architecture" do
+      @i386_packed_long.depack(Arch.i386,4).should == @integer
+    end
+
+    it "should pack itself as a quad for a little-endian architecture" do
+      @i386_packed_quad.depack(Arch.i386,8).should == @integer
+    end
+
+    it "should pack itself for a big-endian architecture" do
+      @ppc_packed_int.depack(Arch.ppc).should == @integer
+    end
+
+    it "should pack itself as a short for a big-endian architecture" do
+      @ppc_packed_short.depack(Arch.ppc,2).should == @integer
+    end
+
+    it "should pack itself as a long for a big-endian architecture" do
+      @ppc_packed_long.depack(Arch.ppc,4).should == @integer
+    end
+
+    it "should pack itself as a quad for a big-endian architecture" do
+      @ppc_packed_quad.depack(Arch.ppc,8).should == @integer
+    end
+  end
+
+  describe "hex_escape" do
+    before(:all) do
+      @binary_string = "hello\x4e"
+    end
+
+    it "should hex escape a String" do
+      @binary_string.hex_escape.should == "\\x68\\x65\\x6c\\x6c\\x6f\\x4e"
+    end
   end
 
   describe "xor" do

data/spec/os_spec.rb

@@ -0,0 +1,24 @@
+require 'ronin/os'
+
+require 'helpers/database'
+
+describe OS do
+  it "should require os and version attributes" do
+    @os = OS.new
+    @os.should_not be_valid
+
+    @os.name = 'test'
+    @os.should_not be_valid
+
+    @os.version = '0.0.1'
+    @os.should be_valid
+  end
+
+  it "should provide methods for built-in OSes" do
+    OS.linux.should_not be_nil
+  end
+
+  it "should provide methods for creating OSes with versions" do
+    OS.linux_version('2.6.11').should be_valid
+  end
+end

data/spec/platform/extension_cache_spec.rb

@@ -0,0 +1,42 @@
+require 'ronin/platform/extension_cache'
+
+require 'platform/helpers/overlays'
+require 'spec_helper'
+
+describe Platform::ExtensionCache do
+  before(:all) do
+    Platform.load_overlays(overlay_cache_path)
+
+    @cache = Platform::ExtensionCache.new
+  end
+
+  it "should be able to load an extension from the overlays" do
+    ext = @cache.load_extension('test')
+
+    ext.should_not be_nil
+    ext.name.should == 'test'
+  end
+
+  it "should provide transparent caching of extensions" do
+    ext = @cache['test']
+    ext.should_not be_nil
+    ext.name.should == 'test'
+
+    @cache['test'].should == ext
+  end
+
+  it "should load together the extension from all overlays" do
+    ext = @cache.load_extension('test')
+
+    ext.should_not be_nil
+    ext.test1.should == 'test one'
+    ext.test2.should == 'test two'
+  end
+
+  it "should have loaded extensions with multiple paths" do
+    paths = @cache.load_extension('test').paths
+
+    paths.length.should == 2
+    paths.select { |path| path =~ /test$/ }.should == paths
+  end
+end

data/spec/platform/extension_spec.rb

@@ -0,0 +1,62 @@
+require 'ronin/platform/extension'
+
+require 'spec_helper'
+
+describe Platform::Extension do
+  before(:each) do
+    @ext = Platform::Extension.new('test') do
+      setup do
+        @var = :setup
+      end
+
+      teardown do
+        @var = :toredown
+      end
+
+      def test_method
+        :method
+      end
+
+      def run_method
+        @var = :running
+      end
+    end
+  end
+
+  it "should allow for custom methods" do
+    @ext.has_method?(:test_method).should == true
+    @ext.test_method.should == :method
+  end
+
+  it "should have a setup state" do
+    @ext.setup!
+    @ext.should be_setup
+  end
+
+  it "should have setup blocks" do
+    @ext.setup!
+    @ext.instance_eval { @var }.should == :setup
+  end
+
+  it "should have a toredown state" do
+    @ext.teardown!
+    @ext.should be_toredown
+  end
+
+  it "should have teardown blocks" do
+    @ext.setup!
+    @ext.teardown!
+    @ext.instance_eval { @var }.should == :toredown
+  end
+
+  it "should not be torendown before it is setup" do
+    @ext.teardown!
+    @ext.instance_eval { @var }.should be_nil
+  end
+
+  it "should be able to be ran" do
+    @ext.run do |ext|
+      ext.run_method.should == :running
+    end
+  end
+end

data/spec/platform/helpers/overlays.rb

@@ -0,0 +1,18 @@
+require 'tempfile'
+require 'erb'
+
+OVERLAY_CACHE = File.expand_path(File.join(File.dirname(__FILE__),'overlays'))
+
+def overlay_cache_path(&block)
+  file = Tempfile.new('overlays.yaml')
+  path = file.path
+
+  template_path = File.join(File.dirname(__FILE__),'overlays.yaml.erb')
+  template = ERB.new(File.read(template_path))
+
+  file.write(template.result(binding))
+  file.close
+  
+  block.call(path) if block
+  return path
+end

data/spec/platform/helpers/overlays.yaml.erb

@@ -0,0 +1,10 @@
+--- 
+- :media: 
+  :uri: 
+  :path: <%= File.join(OVERLAY_CACHE,'test1') %>
+- :media: 
+  :uri: 
+  :path: <%= File.join(OVERLAY_CACHE,'test2') %>
+- :media: 
+  :uri: 
+  :path: <%= File.join(OVERLAY_CACHE,'hello') %>

data/spec/platform/helpers/overlays/hello/hello/extension.rb

@@ -0,0 +1,7 @@
+ronin_extension do
+
+  def greatings
+    'hello'
+  end
+
+end

data/spec/platform/helpers/overlays/hello/ronin.xml

@@ -0,0 +1,26 @@
+<?xml version='1.0'?>
+<?xml-stylesheet type="text/xsl" href="http://ronin.rubyforge.org/dist/overlay.xsl"?>
+<ronin-overlay version='0.1.5'>
+  <title>
+    Hello World
+  </title>
+  <website>
+    http://ronin.rubyforge.org/
+  </website>
+  <license>
+    GPL-2
+  </license>
+  <maintainers>
+    <maintainer>
+      <name>
+        Postmodern
+      </name>
+      <email>
+        postmodern.mod3@gmail.com
+      </email>
+    </maintainer>
+  </maintainers>
+  <description>
+    This is a test overlay used in Ronin&apos;s specs.
+  </description>
+</ronin-overlay>

data/spec/platform/helpers/overlays/test1/ronin.xml

@@ -0,0 +1,26 @@
+<?xml version='1.0'?>
+<?xml-stylesheet type="text/xsl" href="http://ronin.rubyforge.org/dist/overlay.xsl"?>
+<ronin-overlay version='0.1.5'>
+  <title>
+    Test One
+  </title>
+  <website>
+    http://ronin.rubyforge.org/
+  </website>
+  <license>
+    GPL-2
+  </license>
+  <maintainers>
+    <maintainer>
+      <name>
+        Postmodern
+      </name>
+      <email>
+        postmodern.mod3@gmail.com
+      </email>
+    </maintainer>
+  </maintainers>
+  <description>
+    This is a test overlay used in Ronin&apos;s specs.
+  </description>
+</ronin-overlay>

data/spec/platform/helpers/overlays/test1/test/extension.rb

@@ -0,0 +1,7 @@
+ronin_extension do
+
+  def test1
+    "test one"
+  end
+
+end

data/spec/platform/helpers/overlays/test2/ronin.xml

@@ -0,0 +1,26 @@
+<?xml version='1.0'?>
+<?xml-stylesheet type="text/xsl" href="http://ronin.rubyforge.org/dist/overlay.xsl"?>
+<ronin-overlay version='0.1.5'>
+  <title>
+    Test Two
+  </title>
+  <website>
+    http://ronin.rubyforge.org/
+  </website>
+  <license>
+    GPL-2
+  </license>
+  <maintainers>
+    <maintainer>
+      <name>
+        Postmodern
+      </name>
+      <email>
+        postmodern.mod3@gmail.com
+      </email>
+    </maintainer>
+  </maintainers>
+  <description>
+    This is a test overlay used in Ronin&apos;s specs.
+  </description>
+</ronin-overlay>