ronin-support 0.3.0 → 0.4.0.rc1

data/spec/fuzzing/string_spec.rb

@@ -0,0 +1,158 @@
+require 'spec_helper'
+require 'ronin/fuzzing/extensions/string'
+
+describe String do
+  it "should provide String.generate" do
+    described_class.should respond_to(:generate)
+  end
+
+  it "should provide String#repeating" do
+    subject.should respond_to(:repeating)
+  end
+
+  it "should provide String#fuzz" do
+    subject.should respond_to(:fuzz)
+  end
+
+  it "should provide String#mutate" do
+    subject.should respond_to(:mutate)
+  end
+
+  describe "generate" do
+    subject { described_class }
+
+    it "should generate Strings from CharSets" do
+      strings = subject.generate(:lowercase_hexadecimal, :numeric).to_a
+
+      strings.grep(/^[0-9a-f][0-9]$/).should == strings
+    end
+
+    it "should generate Strings from lengths of CharSets" do
+      strings = subject.generate([:numeric, 2]).to_a
+
+      strings.grep(/^[0-9]{2}$/).should == strings
+    end
+
+    it "should generate Strings from varying lengths of CharSets" do
+      strings = subject.generate([:numeric, 1..2]).to_a
+
+      strings.grep(/^[0-9]{1,2}$/).should == strings
+    end
+
+    it "should generate Strings from custom CharSets" do
+      strings = subject.generate([%w[a b c], 2]).to_a
+
+      strings.grep(/^[abc]{2}$/).should == strings
+    end
+
+    it "should generate Strings containing known Strings" do
+      strings = subject.generate('foo', [%w[a b c], 2]).to_a
+
+      strings.grep(/^foo[abc]{2}$/).should == strings
+    end
+
+    it "should raise a TypeError for non String, Symbol, Enumerable CharSets" do
+      lambda {
+        subject.generate([Object.new, 2]).to_a
+      }.should raise_error(TypeError)
+    end
+
+    it "should raise an ArgumentError for unknown CharSets" do
+      lambda {
+        subject.generate([:foo_bar, 2]).to_a
+      }.should raise_error(ArgumentError)
+    end
+
+    it "should raise a TypeError for non Integer,Array,Range lengths" do
+      lambda {
+        subject.generate([:numeric, 'foo']).to_a
+      }.should raise_error(TypeError)
+    end
+  end
+
+  describe "#repeating" do
+    subject { 'A' }
+
+    context "when n is an Integer" do
+      let(:n) { 100 }
+
+      it "should multiply the String by n" do
+        subject.repeating(n).should == (subject * n)
+      end
+    end
+
+    context "when n is Enumerable" do
+      let(:n) { [128, 512, 1024] }
+
+      it "should repeat the String by each length" do
+        strings = subject.repeating(n).to_a
+
+        strings.should == n.map { |length| subject * length }
+      end
+    end
+  end
+
+  describe "#fuzz" do
+    subject { 'GET /one/two/three' }
+
+    context "matching" do
+      it "should allow Regexps" do
+        fuzzed = subject.fuzz(/GET/ => ['get']).to_a
+
+        fuzzed.should == ['get /one/two/three']
+      end
+
+      it "should allow Strings" do
+        fuzzed = subject.fuzz('GET' => ['get']).to_a
+
+        fuzzed.should == ['get /one/two/three']
+      end
+
+      it "should match Symbols to Regexp constants" do
+        fuzzed = subject.fuzz(:absolute_path => ['../../../..']).to_a
+
+        fuzzed.should == ['GET ../../../..']
+      end
+    end
+
+    context "substitution" do
+      it "should allow Procs" do
+        fuzzed = subject.fuzz('GET' => [lambda { |s| s.downcase }]).to_a
+
+        fuzzed.should == ['get /one/two/three']
+      end
+
+      it "should allow Integers" do
+        fuzzed = subject.fuzz(' ' => [0x09]).to_a
+
+        fuzzed.should == ["GET\t/one/two/three"]
+      end
+
+      it "should map Symbols to Fuzzing methods" do
+        fuzzed = subject.fuzz(/\/.*/ => :format_strings).to_a
+
+        fuzzed.should_not == [subject]
+      end
+
+      it "should incrementally replace each occurrence" do
+        fuzzed = subject.fuzz('/' => ["\n\r"]).to_a
+
+        fuzzed.should == [
+          "GET \n\rone/two/three",
+          "GET /one\n\rtwo/three",
+          "GET /one/two\n\rthree"
+        ]
+      end
+
+      it "should replace each occurrence with each substitution" do
+        fuzzed = subject.fuzz('GET' => ["\n\rGET", "G\n\rET", "GET\n\r"]).to_a
+
+        fuzzed.should == [
+          "\n\rGET /one/two/three",
+          "G\n\rET /one/two/three",
+          "GET\n\r /one/two/three"
+        ]
+      end
+    end
+  end
+end

data/spec/wordlist_spec.rb

@@ -0,0 +1,65 @@
+require 'spec_helper'
+require 'ronin/wordlist'
+
+require 'tempfile'
+
+describe Wordlist do
+  let(:words) { %w[foo bar baz] }
+
+  before(:all) do
+    Tempfile.open('ronin-support-wordlist') do |file|
+      words.each { |word| file.puts word }
+
+      @path = file.path
+    end
+  end
+
+  subject { described_class.new(words) }
+
+  describe "#initialize" do
+    it "should accept a list of words" do
+      subject.to_a.should == words
+    end
+
+    it "should accept a path to a wordlist file" do
+      file = described_class.new(@path)
+
+      file.to_a.should == words
+    end
+  end
+
+  describe "#each_word" do
+    it "should raise a TypeError for non-String / non-Enumerable objects" do
+      wordlist = described_class.new(Object.new)
+
+      lambda {
+        wordlist.each_word { |word| }
+      }.should raise_error(TypeError)
+    end
+  end
+
+  describe "#each" do
+    it "should rewind file lists" do
+      subject.each { |word| }
+
+      subject.to_a.should == words
+    end
+
+    it "should apply additional mutation rules" do
+      wordlist = described_class.new(words)
+      wordlist.mutations['o'] = ['0']
+
+      wordlist.to_a.should == %w[foo f0o fo0 f00 bar baz]
+    end
+  end
+
+  describe "#each_n_words" do
+    it "should enumerate over every combination of N words" do
+      subject.each_n_words(2).to_a.should == %w[
+        foofoo foobar foobaz
+        barfoo barbar barbaz
+        bazfoo bazbar bazbaz
+      ]
+    end
+  end
+end

metadata

@@ -1,19 +1,19 @@
 --- !ruby/object:Gem::Specification
 name: ronin-support
 version: !ruby/object:Gem::Version
-  version: 0.3.0
-  prerelease: 
+  version: 0.4.0.rc1
+  prerelease: 6
 platform: ruby
 authors:
 - Postmodern
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-10-17 00:00:00.000000000Z
+date: 2011-12-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: chars
-  requirement: &13653760 !ruby/object:Gem::Requirement
+  requirement: &11794840 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,10 +21,10 @@ dependencies:
         version: '0.2'
   type: :runtime
   prerelease: false
-  version_requirements: *13653760
+  version_requirements: *11794840
 - !ruby/object:Gem::Dependency
   name: hexdump
-  requirement: &13615160 !ruby/object:Gem::Requirement
+  requirement: &11792620 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +32,10 @@ dependencies:
         version: '0.1'
   type: :runtime
   prerelease: false
-  version_requirements: *13615160
+  version_requirements: *11792620
 - !ruby/object:Gem::Dependency
   name: combinatorics
-  requirement: &13608820 !ruby/object:Gem::Requirement
+  requirement: &11791900 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,24 +43,21 @@ dependencies:
         version: '0.4'
   type: :runtime
   prerelease: false
-  version_requirements: *13608820
+  version_requirements: *11791900
 - !ruby/object:Gem::Dependency
   name: uri-query_params
-  requirement: &13381960 !ruby/object:Gem::Requirement
+  requirement: &11791120 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '0.5'
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: 0.5.2
+        version: '0.6'
   type: :runtime
   prerelease: false
-  version_requirements: *13381960
+  version_requirements: *11791120
 - !ruby/object:Gem::Dependency
   name: data_paths
-  requirement: &12320000 !ruby/object:Gem::Requirement
+  requirement: &11789140 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -68,24 +65,21 @@ dependencies:
         version: '0.3'
   type: :runtime
   prerelease: false
-  version_requirements: *12320000
+  version_requirements: *11789140
 - !ruby/object:Gem::Dependency
   name: parameters
-  requirement: &12317320 !ruby/object:Gem::Requirement
+  requirement: &11788500 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '0.2'
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: 0.2.3
+        version: '0.4'
   type: :runtime
   prerelease: false
-  version_requirements: *12317320
+  version_requirements: *11788500
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &15940760 !ruby/object:Gem::Requirement
+  requirement: &11787520 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -93,10 +87,10 @@ dependencies:
         version: 1.0.10
   type: :development
   prerelease: false
-  version_requirements: *15940760
+  version_requirements: *11787520
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &15973540 !ruby/object:Gem::Requirement
+  requirement: &11787040 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -104,7 +98,7 @@ dependencies:
         version: 0.7.0
   type: :development
   prerelease: false
-  version_requirements: *15973540
+  version_requirements: *11787040
 description: Ronin Support is a support library for Ronin. Ronin Support contains
   many of the convenience methods used by Ronin and additional libraries.
 email: postmodern.mod3@gmail.com
@@ -159,6 +153,10 @@ files:
 - lib/ronin/formatting/http.rb
 - lib/ronin/formatting/sql.rb
 - lib/ronin/formatting/text.rb
+- lib/ronin/fuzzing.rb
+- lib/ronin/fuzzing/extensions.rb
+- lib/ronin/fuzzing/extensions/string.rb
+- lib/ronin/fuzzing/fuzzing.rb
 - lib/ronin/mixin.rb
 - lib/ronin/network.rb
 - lib/ronin/network/esmtp.rb
@@ -192,6 +190,7 @@ files:
 - lib/ronin/network/mixins/esmtp.rb
 - lib/ronin/network/mixins/http.rb
 - lib/ronin/network/mixins/imap.rb
+- lib/ronin/network/mixins/mixin.rb
 - lib/ronin/network/mixins/pop3.rb
 - lib/ronin/network/mixins/smtp.rb
 - lib/ronin/network/mixins/tcp.rb
@@ -210,6 +209,7 @@ files:
 - lib/ronin/spec/ui/output.rb
 - lib/ronin/support.rb
 - lib/ronin/support/inflector.rb
+- lib/ronin/support/support.rb
 - lib/ronin/support/version.rb
 - lib/ronin/templates.rb
 - lib/ronin/templates/erb.rb
@@ -221,11 +221,13 @@ files:
 - lib/ronin/ui/output/terminal/color.rb
 - lib/ronin/ui/output/terminal/raw.rb
 - lib/ronin/ui/shell.rb
+- lib/ronin/wordlist.rb
 - ronin-support.gemspec
 - spec/extensions/enumerable_spec.rb
 - spec/extensions/file_spec.rb
 - spec/extensions/ip_addr_spec.rb
 - spec/extensions/kernel_spec.rb
+- spec/extensions/regexp_spec.rb
 - spec/extensions/resolv_spec.rb
 - spec/extensions/string_spec.rb
 - spec/formatting/binary/helpers/hexdumps.rb
@@ -260,6 +262,7 @@ files:
 - spec/formatting/sql/string_spec.rb
 - spec/formatting/text/array_spec.rb
 - spec/formatting/text/string_spec.rb
+- spec/fuzzing/string_spec.rb
 - spec/mixin_spec.rb
 - spec/network/http/http_spec.rb
 - spec/network/http/proxy_spec.rb
@@ -280,6 +283,7 @@ files:
 - spec/ui/classes/test_shell.rb
 - spec/ui/output_spec.rb
 - spec/ui/shell_spec.rb
+- spec/wordlist_spec.rb
 homepage: http://github.com/ronin-ruby/ronin-support
 licenses:
 - LGPL-3
@@ -310,6 +314,7 @@ test_files:
 - spec/extensions/file_spec.rb
 - spec/extensions/ip_addr_spec.rb
 - spec/extensions/kernel_spec.rb
+- spec/extensions/regexp_spec.rb
 - spec/extensions/resolv_spec.rb
 - spec/extensions/string_spec.rb
 - spec/formatting/binary/integer_spec.rb
@@ -322,6 +327,7 @@ test_files:
 - spec/formatting/sql/string_spec.rb
 - spec/formatting/text/array_spec.rb
 - spec/formatting/text/string_spec.rb
+- spec/fuzzing/string_spec.rb
 - spec/mixin_spec.rb
 - spec/network/http/http_spec.rb
 - spec/network/http/proxy_spec.rb
@@ -335,3 +341,5 @@ test_files:
 - spec/templates/template_spec.rb
 - spec/ui/output_spec.rb
 - spec/ui/shell_spec.rb
+- spec/wordlist_spec.rb
+has_rdoc: