ronin 0.0.9 → 0.1.0

data/spec/formatting/binary_spec.rb

@@ -0,0 +1,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
+  end
+
+  it "Integer#pack 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 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 "Integer#pack should pack itself as a quad for a little-endian architecture" do
+    @integer.pack(Arch.i386,8).should == @i386_packed_quad
+  end
+
+  it "Integer#pack should pack itself for a big-endian architecture" do
+    @integer.pack(Arch.ppc).should == @ppc_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 "Integer#pack 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 quad for a big-endian architecture" do
+    @integer.pack(Arch.ppc,8).should == @ppc_packed_quad
+  end
+end
+
+describe "String" do
+  before(:all) do
+    @packed_integer = ""
+  end
+
+  it "should provide String#depack" do
+    @packed_integer.respond_to?('depack').should == true
+  end
+end

data/spec/formatting/digest_spec.rb

@@ -0,0 +1,54 @@
+require 'ronin/formatting/digest'
+
+require 'spec_helper'
+
+describe String do
+  before(:all) do
+    @digest_plain_text = "test"
+    @digest_md5 = "098f6bcd4621d373cade4e832627b4f6"
+    @digest_sha1 = "a94a8fe5ccb19ba61c4c0873d391e987982fbbd3"
+    @digest_sha2 = "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
+    @digest_sha256 = "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
+    @digest_sha512 = "ee26b0dd4af7e749aa1a8ee3c10ae9923f618980772e473f8819a5d4940e0db27ac185f8a0e1d5f84f88bc887fd67b143732c304cc5fa9ad8e6f57f50028a8ff"
+  end
+
+  it "should provide String#md5" do
+    @digest_plain_text.respond_to?('md5').should == true
+  end
+
+  it "String#md5 should return the MD5 digest of itself" do
+    @digest_plain_text.md5.should == @digest_md5
+  end
+
+  it "should provide String#sha1" do
+    @digest_plain_text.respond_to?('sha1').should == true
+  end
+
+  it "String#sha1 should return the SHA1 digest of itself" do
+    @digest_plain_text.sha1.should == @digest_sha1
+  end
+
+  it "should provide String#sha2" do
+    @digest_plain_text.respond_to?('sha2').should == true
+  end
+
+  it "String#sha2 should return the SHA2 digest of itself" do
+    @digest_plain_text.sha2.should == @digest_sha2
+  end
+
+  it "should provide String#sha256" do
+    @digest_plain_text.respond_to?('sha256').should == true
+  end
+
+  it "String#sha256 should return the SHA256 digest of itself" do
+    @digest_plain_text.sha256.should == @digest_sha256
+  end
+
+  it "should provide String#sha512" do
+    @digest_plain_text.respond_to?('sha512').should == true
+  end
+
+  it "String#sha512 should return the SHA512 digest of itself" do
+    @digest_plain_text.sha512.should == @digest_sha512
+  end
+end

data/spec/formatting/html_spec.rb

@@ -0,0 +1,37 @@
+require 'ronin/formatting/html'
+
+require 'spec_helper'
+
+describe String do
+  before(:all) do
+    @raw_text = "x > y && y != 0"
+    @html_encoded_text = "x > y && y != 0"
+
+    @raw_html = "<p>Hello <strong>dude</strong></p>"
+    @stripped_text = "Hello dude"
+  end
+
+  it "should provide String#html_encode" do
+    @raw_text.respond_to?('html_encode').should == true
+  end
+
+  it "String#html_encode should HTML encode itself" do
+    @raw_text.html_encode.should == @html_encoded_text
+  end
+
+  it "should provide String#html_decode" do
+    @raw_text.respond_to?('html_decode').should == true
+  end
+
+  it "String#html_decode should HTML decode itself" do
+    @html_encoded_text.html_decode.should == @raw_text
+  end
+
+  it "should provide String#strip_html" do
+    @raw_text.respond_to?('strip_html').should == true
+  end
+
+  it "String#strip_html should strip any HTML from itself" do
+    @raw_html.strip_html.should == @stripped_text
+  end
+end

data/spec/formatting/http_spec.rb

@@ -0,0 +1,44 @@
+require 'ronin/formatting/http'
+
+require 'spec_helper'
+
+describe String do
+  before(:all) do
+    @uri_unencoded = "mod % 3"
+    @uri_encoded = "mod%20%25%203"
+    @uri_unescaped = "x + y"
+    @uri_escaped = "x+%2B+y"
+  end
+
+  it "should provide String#uri_encode" do
+    @uri_unencoded.respond_to?('uri_encode').should == true
+  end
+
+  it "String#uri_encode should URI encode itself" do
+    @uri_unencoded.uri_encode.should == @uri_encoded
+  end
+
+  it "should provide String#uri_decode" do
+    @uri_encoded.respond_to?('uri_decode').should == true
+  end
+
+  it "String#uri_decode should URI decode itself" do
+    @uri_encoded.uri_decode.should == @uri_unencoded
+  end
+
+  it "should provide String#uri_escape" do
+    @uri_unescaped.respond_to?('uri_escape').should == true
+  end
+
+  it "String#uri_escape should URI escape itself" do
+    @uri_unescaped.uri_escape.should == @uri_escaped
+  end
+
+  it "should provide String#uri_unescape" do
+    @uri_escaped.respond_to?('uri_unescape').should == true
+  end
+
+  it "String#uri_unescape should URI unescape itself" do
+    @uri_escaped.uri_unescape.should == @uri_unescaped
+  end
+end

data/spec/formatting/text_spec.rb

@@ -0,0 +1,21 @@
+require 'ronin/formatting/text'
+
+require 'spec_helper'
+
+describe String do
+  before(:all) do
+    @string = ""
+  end
+
+  it "should provide String#format_chars" do
+    @string.respond_to?('format_chars').should == true
+  end
+
+  it "should provide String#format_bytes" do
+    @string.respond_to?('format_bytes').should == true
+  end
+
+  it "should provide String#rand_case" do
+    @string.respond_to?('rand_case').should == true
+  end
+end

data/spec/license_spec.rb

@@ -0,0 +1,20 @@
+require 'ronin/license'
+
+require 'spec_helper'
+
+describe License do
+  it "should require name and description attributes" do
+    @license = License.new
+    @license.should_not be_valid
+
+    @license.name = 'joke'
+    @license.should_not be_valid
+
+    @license.description = "yep, it's a joke."
+    @license.should be_valid
+  end
+
+  it "should provide built-in licenses"do
+    License.cc_by.should_not be_nil
+  end
+end

data/spec/parameters/parameters_spec.rb

@@ -0,0 +1,109 @@
+require 'ronin/parameters'
+
+require 'spec_helper'
+
+describe Parameters do
+  before(:all) do
+    class TestParameters
+      include Parameters
+
+      parameter :var, :description => 'Test parameter'
+
+      parameter :var_with_default,
+                :default => 'thing',
+                :description => 'This parameter has a default value'
+
+    end
+
+    class InheritedParameters < TestParameters
+
+      parameter :child_var, :description => 'Child parameter'
+
+    end
+  end
+
+  describe "in a Class" do
+    it "should provide parameters" do
+      TestParameters.params.should_not be_empty
+    end
+
+    it "can have default values for parameters" do
+      TestParameters.param_value(:var_with_default).should == 'thing'
+    end
+
+    it "should provide class methods for paremters" do
+      TestParameters.var = 1
+      TestParameters.var.should == 1
+    end
+
+    it "should inherite the super-classes parameters" do
+      InheritedParameters.has_param?(:var).should == true
+      InheritedParameters.has_param?(:child_var).should == true
+    end
+
+    it "should provide direct access to the parameter objects" do
+      @param = TestParameters.get_param(:var)
+
+      @param.should_not be_nil
+      @param.name.should == :var
+    end
+
+    it "raise a ParamNotFound exception when directly accessing non-existent parameter objects" do
+      lambda { TestParameters.get_param(:unknown) }.should raise_error(Parameters::ParamNotFound)
+    end
+
+    it "should provide descriptions for parameters" do
+      TestParameters.describe_param(:var).should_not be_empty
+    end
+  end
+
+  describe "in an Object" do
+    before(:all) do
+      @test = TestParameters.new
+      @test_inherited = InheritedParameters.new
+    end
+
+    it "can have default values for parameters" do
+      @test.param_value(:var_with_default).should == 'thing'
+    end
+
+    it "should provide instance methods for parameters" do
+      @test.var = 2
+      @test.var.should == 2
+    end
+
+    it "should set instance variables for paramters" do
+      @test.instance_variable_get('@var_with_default').should == 'thing'
+
+      @test.var = 3
+      @test.instance_variable_get('@var').should == 3
+    end
+
+    it "should contain the parameters from all ancestors" do
+      @test_inherited.has_param?(:var).should == true
+      @test_inherited.has_param?(:child_var).should == true
+    end
+
+    it "should provide direct access to the parameter objects" do
+      @param = @test.get_param(:var)
+
+      @param.should_not be_nil
+      @param.name.should == :var
+    end
+
+    it "should raise a ParamNotFound exception when directly accessing non-existent parameter objects" do
+      lambda { @test.get_param(:unknown) }.should raise_error(Parameters::ParamNotFound)
+    end
+
+    it "should allow for setting parameters en-mass" do
+      @test.set_params(:var => 3, :var_with_default => 7)
+
+      @test.param_value(:var).should == 3
+      @test.param_value(:var_with_default).should == 7
+    end
+
+    it "should provide descriptions for parameters" do
+      @test.describe_param(:var).should_not be_empty
+    end
+  end
+end

data/spec/path_spec.rb

@@ -0,0 +1,34 @@
+require 'ronin/path'
+
+require 'spec_helper'
+
+describe Ronin do
+  describe Path do
+    before(:all) do
+      @n = 7
+      @range = (7..10)
+      @sub_path = File.join('one','two')
+      @sub_directory = 'three'
+    end
+
+    it "should inherit from Pathname" do
+      Path.superclass.should == Pathname
+    end
+
+    it "should create directory-escaping paths" do
+      Path.up(@n).to_s.should == File.join(*(['..'] * @n))
+    end
+
+    it "should create a range of directory-escaping paths" do
+      Path.up(@range).should == @range.map { |i| Path.up(i) }
+    end
+
+    it "should join with sub-paths" do
+      Path.up(@n).join(@sub_path).to_s.should == File.join(Path.up(@n),@sub_path)
+    end
+
+    it "should join with a sub-directory" do
+      (Path.up(@n) / @sub_directory).to_s.should == File.join(Path.up(@n),@sub_directory)
+    end
+  end
+end

data/spec/platform_spec.rb

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

data/spec/product_spec.rb

@@ -0,0 +1,16 @@
+require 'ronin/product'
+
+require 'spec_helper'
+
+describe Product do
+  it "should require name and version attributes" do
+    @product = Product.new
+    @product.should_not be_valid
+
+    @product.name = 'test'
+    @product.should_not be_valid
+
+    @product.version = '0.1.0'
+    @product.should be_valid
+  end
+end

data/spec/ronin_spec.rb

@@ -0,0 +1,11 @@
+require 'ronin/version'
+
+require 'spec_helper'
+
+describe Ronin do
+  it "should have a version constant" do
+    @version = Ronin.const_get('VERSION')
+    @version.should_not be_nil
+    @version.should_not be_empty
+  end
+end