ronin 0.2.3 → 0.2.4

data/spec/os_spec.rb

@@ -3,14 +3,11 @@ require 'ronin/os'
 require 'helpers/database'
 
 describe OS do
-  it "should require os and version attributes" do
+  it "should require a name" 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
 
@@ -19,6 +16,6 @@ describe OS do
   end
 
   it "should provide methods for creating OSes with versions" do
-    OS.linux_version('2.6.11').should be_valid
+    OS.linux('2.6.11').should be_valid
   end
 end

data/spec/platform/maintainer_spec.rb

@@ -0,0 +1,30 @@
+require 'ronin/platform/maintainer'
+
+require 'spec_helper'
+
+describe Platform::Maintainer do
+  before(:all) do
+    @named = Platform::Maintainer.new('anonymous')
+    @name_with_email = Platform::Maintainer.new('anonymous','anonymous@example.com')
+  end
+
+  describe "to_s" do
+    it "should return the name when their is no email" do
+      @named.to_s.should == 'anonymous'
+    end
+
+    it "should return the name and email when both are present" do
+      @name_with_email.to_s.should == 'anonymous <anonymous@example.com>'
+    end
+  end
+
+  describe "inspect" do
+    it "should return the name when their is no email" do
+      @named.inspect.should == '#<Ronin::Platform::Maintainer: anonymous>'
+    end
+
+    it "should return the name and email when both are present" do
+      @name_with_email.inspect.should == '#<Ronin::Platform::Maintainer: anonymous <anonymous@example.com>>'
+    end
+  end
+end

data/spec/platform/ronin_spec.rb

@@ -21,7 +21,7 @@ describe Ronin do
   end
 
   it "should provide transparent access to extensions via methods" do
-    ext = Ronin.hello
+    ext = hello
 
     ext.should_not be_nil
     ext.name.should == 'hello'
@@ -29,6 +29,6 @@ describe Ronin do
   end
 
   it "should raise NoMethodError when accessing missing extensions" do
-    lambda { Ronin.nothing }.should raise_error(NoMethodError)
+    lambda { self.nothing }.should raise_error(NoMethodError)
   end
 end

data/spec/scanners/classes/another_scanner.rb

@@ -0,0 +1,16 @@
+require 'scanners/classes/example_scanner'
+
+class AnotherScanner < ExampleScanner
+
+  scanner(:test1) do |target,results|
+    results.call(1)
+  end
+
+  scanner(:test3) do |target,results|
+    results.call(3)
+  end
+
+  scanner(:fail) do |target,results|
+  end
+
+end

data/spec/scanners/classes/example_scanner.rb

@@ -0,0 +1,22 @@
+require 'ronin/scanners/scanner'
+
+class ExampleScanner
+
+  include Ronin::Scanners::Scanner
+
+  scanner(:test1) do |target,results|
+    results.call(1)
+  end
+
+  scanner(:test2) do |target,results|
+    results.call(2)
+  end
+
+  scanner(:test2) do |target,results|
+    results.call(4)
+  end
+
+  scanner(:fail) do |target,results|
+  end
+
+end

data/spec/scanners/scanner_spec.rb

@@ -0,0 +1,148 @@
+require 'ronin/scanners/scanner'
+
+require 'spec_helper'
+require 'scanners/classes/example_scanner'
+require 'scanners/classes/another_scanner'
+
+describe Scanners::Scanner do
+  before(:all) do
+    @example_scanner = ExampleScanner.new
+    @another_scanner = AnotherScanner.new
+  end
+
+  it "should register scanner tests with a class" do
+    ExampleScanner.scanners.should_not be_empty
+  end
+
+  it "should group multiple scanner tests into categories by name" do
+    ExampleScanner.scanners[:test2].length.should == 2
+  end
+
+  it "should separate scanner tests between inherited classes" do
+    ExampleScanner.scanners[:test1].length.should == 1
+    ExampleScanner.scanners[:fail].length.should == 1
+    ExampleScanner.scanners[:test3].should be_nil
+
+    AnotherScanner.scanners[:test1].length.should == 1
+    AnotherScanner.scanners[:test3].length.should == 1
+    AnotherScanner.scanners[:fail].length.should == 1
+  end
+
+  it "should specify if the scanner defines a certain category of tests" do
+    ExampleScanner.scans_for?(:test1).should == true
+    AnotherScanner.scans_for?(:test2).should == true
+  end
+
+  it "should return all scanner tests within a category" do
+    tests = ExampleScanner.scanners_in(:test2)
+
+    tests.length.should == 2
+    tests.all? { |test| test.kind_of?(Proc) }.should == true
+  end
+
+  it "should specify the category names of all tests" do
+    ExampleScanner.scans_for.should == Set[:test1, :test2, :fail]
+    AnotherScanner.scans_for.should == Set[:test1, :test2, :test3, :fail]
+  end
+
+  it "should scan each target and return the discovered results" do
+    @example_scanner.scan.should == {
+      :test1 => [1],
+      :test2 => [2, 4],
+      :fail => []
+    }
+
+    @another_scanner.scan.should == {
+      :test1 => [1, 1],
+      :test2 => [2, 4],
+      :test3 => [3],
+      :fail => []
+    }
+  end
+
+  it "should scan each target and pass back results" do
+    results = {:test1 => [1], :test2 => [2, 4]}
+
+    @example_scanner.scan do |category,result|
+      results.has_key?(category).should == true
+      results[category].include?(result).should == true
+    end
+  end
+
+  it "should allow for the scanning for specific categories" do
+    @example_scanner.scan(:test1 => true).should == {:test1 => [1]}
+
+    @another_scanner.scan(:test1 => true, :test3 => true).should == {
+      :test1 => [1, 1],
+      :test3 => [3]
+    }
+  end
+
+  it "should return an empty Array for a failed scan" do
+    @example_scanner.scan(:fail => true).should == {:fail => []}
+  end
+
+  it "should not scan a category if the category information is false" do
+    @example_scanner.scan(:test1 => false).should == {}
+  end
+
+  it "should not scan a category if the category information is nil" do
+    @example_scanner.scan(:test1 => nil).should == {}
+  end
+
+  it "should raise an UnknownCategory for unknown scan categories" do
+    lambda {
+      @example_scanner.scan(:test3 => true)
+    }.should raise_error(Scanners::UnknownCategory)
+  end
+
+  describe "convenience methods" do
+    describe "category scan" do
+      it "should define the convenience method" do
+        ExampleScanner.method_defined?(:test1_scan).should == true
+      end
+
+      it "should return an Array of results" do
+        @example_scanner.test1_scan.should == [1]
+      end
+
+      it "should pass back results if a block is given" do
+        @example_scanner.test1_scan do |result|
+          result.should == 1
+        end
+      end
+
+      it "should return an empty Array for failed scans" do
+        @example_scanner.fail_scan.should == []
+      end
+    end
+
+    describe "first result" do
+      it "should define the convenience method" do
+        ExampleScanner.method_defined?(:first_test1).should == true
+      end
+
+      it "should define the convenience method" do
+        @example_scanner.first_test2.should == 2
+      end
+
+      it "should return nil when there is no first result" do
+        @example_scanner.first_fail.should be_nil
+      end
+    end
+
+    describe "has results" do
+      it "should define the convenience method" do
+        ExampleScanner.method_defined?(:has_test1?).should == true
+      end
+
+      it "should return true if there was a first result" do
+        @example_scanner.has_test1?.should == true
+      end
+
+      it "should return false if a scan has no results" do
+        @example_scanner.has_fail?.should == false
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -1,5 +1,5 @@
 require 'rubygems'
-gem 'rspec', '>=1.1.3'
+gem 'rspec', '>=1.1.12'
 require 'spec'
 
 require 'ronin/version'

data/spec/templates/classes/uses_erb.rb

@@ -0,0 +1,11 @@
+require 'ronin/templates/erb'
+
+class UsesErb
+
+  include Ronin::Templates::Erb
+
+  attr_accessor :x
+
+  attr_accessor :y
+
+end

data/spec/templates/erb_spec.rb

@@ -0,0 +1,20 @@
+require 'ronin/templates/erb'
+
+require 'spec_helper'
+require 'templates/classes/uses_erb'
+
+describe Templates::Erb do
+  before(:all) do
+    @uses_erb= UsesErb.new
+    @uses_erb.x = 2
+    @uses_erb.y = 3
+  end
+
+  it "should render inline ERB templates" do
+    @uses_erb.erb(%{<%= 'hello' %>}).should == 'hello'
+  end
+
+  it "should render ERB templates using the binding of the object" do
+    @uses_erb.erb(%{<%= @x %> <%= @y %>}).should == '2 3'
+  end
+end

data/static/ronin/platform/overlay.xsl

@@ -5,19 +5,42 @@
   <xsl:template match="/ronin-overlay">
     <html>
       <head>
-        <title>Ronin Overlay :: <xsl:value-of select="/ronin-overlay/name/." /></title>
+        <title>Ronin Overlay :: <xsl:value-of select="/ronin-overlay/title/." /></title>
         <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
         <style type="text/css">
           body {
+            font-family: sans-serif;
+            font-size: 0.9em;
+            margin: 0;
+            padding: 0;
           }
 
           #overlay {
-            margin: 0.5em;
-            padding: 0.2em;
+            margin: 1em;
+            padding: 1em;
             border: 20px solid black;
           }
 
-          #overlay-name {
+          #overlay p {
+            margin: 0.125em;
+            padding: 0;
+          }
+
+          #overlay strong {
+            margin-right: 1em;
+          }
+
+          #overlay a {
+            color: black;
+            font-weight: bold;
+            text-decoration: none;
+          }
+
+          #overlay a:hover {
+            color: #BD0000;
+          }
+
+          #overlay-title {
           }
 
           #overlay-license {
@@ -28,76 +51,132 @@
 
           #overlay-description {
           }
+        </style>
+        <style type="text/css" media="print">
+          #overlay {
+            border: none;
+          }
 
-          #overlay-description blockquote {
+          #overlay a {
+            font-weight: normal;
           }
         </style>
-        <script type="text/javascript" src="http://ronin.rubyforge.org/scripts/jquery.min.js"></script>
-        <script type="text/javascript" src="http://ronin.rubyforge.org/scripts/jquery.expander.js"></script>
-        <script type="text/javascript">
-          $(document).ready(function() {
-            $("#overlay-description/blockquote").expander({
-              expandText: '[ more ]',
-              userCollapseText: '[ less ]'
-            });
-          });
-        </script>
       </head>
 
       <body>
-        <div id="overlay">
+        <table id="overlay">
           <xsl:apply-templates />
-        </div>
+        </table>
       </body>
     </html>
   </xsl:template>
 
-  <xsl:template match="/ronin-overlay/name">
-    <p id="overlay-name">
-      <strong>Name:</strong> <xsl:value-of select="." />
-    </p>
+  <xsl:template match="/ronin-overlay/title">
+    <tr id="overlay-title">
+      <td valign="top">
+        <p><strong>Title:</strong></p>
+      </td>
+      <td valign="top">
+        <p><xsl:value-of select="." /></p>
+      </td>
+    </tr>
   </xsl:template>
 
   <xsl:template match="/ronin-overlay/license">
-    <p id="overlay-license">
-      <strong>License:</strong> <xsl:value-of select="." />
-    </p>
+    <tr id="overlay-license">
+      <td valign="top">
+        <p><strong>License:</strong></p>
+      </td>
+      <td valign="top">
+        <p><xsl:value-of select="." /></p>
+      </td>
+    </tr>
   </xsl:template>
 
   <xsl:template match="/ronin-overlay/source">
-    <p id="overlay-source">
-      <strong>Source:</strong>
-      <a>
-        <xsl:attribute name="href"><xsl:value-of select="." /></xsl:attribute>
-        <xsl:value-of select=".">
-      </a>
-    </p>
+    <tr id="overlay-source">
+      <td valign="top">
+        <p><strong>Source:</strong></p>
+      </td>
+      <td valign="top">
+        <p>
+          <a>
+            <xsl:attribute name="href"><xsl:value-of select="." /></xsl:attribute>
+            <xsl:value-of select="." />
+          </a>
+        </p>
+      </td>
+    </tr>
   </xsl:template>
 
-  <xsl:template match="/ronin-overlay/source-browse">
-    <p id="overlay-source-browse">
-      <strong>Source Browser:</strong>
-      <a>
-        <xsl:attribute name="href"><xsl:value-of select="." /></xsl:attribute>
-        <xsl:value-of select=".">
-      </a>
-    </p>
+  <xsl:template match="/ronin-overlay/source-view">
+    <tr id="overlay-source-view">
+      <td valign="top">
+        <p><strong>View Source:</strong></p>
+      </td>
+      <td valign="top">
+        <p>
+          <a>
+            <xsl:attribute name="href"><xsl:value-of select="." /></xsl:attribute>
+            <xsl:value-of select="." />
+          </a>
+        </p>
+      </td>
+    </tr>
   </xsl:template>
 
   <xsl:template match="/ronin-overlay/website">
-    <p id="overlay-website">
-      <strong>Website:</strong>
-      <a>
-        <xsl:attribute name="href"><xsl:value-of select="." /></xsl:attribute>
-        <xsl:value-of select=".">
-      </a>
+    <tr id="overlay-website">
+      <td valign="top">
+        <p><strong>Website:</strong></p>
+      </td>
+      <td valign="top">
+        <p>
+          <a>
+            <xsl:attribute name="href"><xsl:value-of select="." /></xsl:attribute>
+            <xsl:value-of select="." />
+          </a>
+        </p>
+      </td>
+    </tr>
+  </xsl:template>
+
+  <xsl:template match="/ronin-overlay/maintainers">
+    <tr id="overlay-maintainers">
+      <td valign="top">
+        <p><strong>Maintainers:</strong></p>
+      </td>
+      <td valign="top">
+        <xsl:apply-templates />
+      </td>
+    </tr>
+  </xsl:template>
+
+  <xsl:template match="/ronin-overlay/maintainers/maintainer">
+    <p class="maintainer">
+      <xsl:choose>
+        <xsl:when test="email">
+          <a>
+            <xsl:attribute name="href">mailto:<xsl:value-of select="email/." /></xsl:attribute>
+            <xsl:value-of select="name/." />
+          </a>
+        </xsl:when>
+
+        <xsl:otherwise>
+          <strong><xsl:value-of select="name/." /></strong>
+        </xsl:otherwise>
+      </xsl:choose>
     </p>
   </xsl:template>
 
   <xsl:template match="/ronin-overlay/description">
-    <div id="overlay-description">
-      <p><strong>Description:</strong></p>
-      <blockquote><xsl:value-of select="." /></blockquote>
-    </div>
+    <tr id="overlay-description">
+      <td valign="top">
+        <p><strong>Description:</strong></p>
+      </td>
+      <td valign="top">
+        <p><xsl:value-of select="." /></p>
+      </td>
+    </tr>
   </xsl:template>
 </xsl:stylesheet>