ronin-support 0.1.0.pre1

data/spec/extensions/kernel_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+require 'ronin/extensions/kernel'
+
+describe Kernel do
+  it "should provide Kernel#attempt" do
+    Kernel.should respond_to('attempt')
+  end
+
+  describe "attempt" do
+    it "should return the result of the block if nothing is raised" do
+      attempt { 2 + 2 }.should == 4
+    end
+
+    it "should return nil if an exception is raised" do
+      attempt { 2 + 'a' }.should be_nil
+    end
+
+    it "should rescue RuntimeError exceptions" do
+      lambda {
+        attempt { raise(RuntimeError,"something happened",caller) }
+      }.should_not raise_error(RuntimeError)
+    end
+
+    it "should rescue StandardError exceptions" do
+      lambda {
+        attempt { raise(StandardError,"not allowed to do that",caller) }
+      }.should_not raise_error(StandardError)
+    end
+  end
+end

data/spec/extensions/string_spec.rb

@@ -0,0 +1,177 @@
+require 'spec_helper'
+require 'ronin/extensions/string'
+
+describe String do
+  describe "each_substring" do
+    subject { 'hello' }
+
+    it "should enumerate over each sub-string within the String" do
+      subject.each_substring do |sub_string|
+        should include(sub_string)
+      end
+    end
+
+    it "should allow passing the string index back" do
+      subject.each_substring do |sub_string,index|
+        subject[index,sub_string.length].should == sub_string
+
+        should include(sub_string)
+      end
+    end
+
+    it "should enumerate over each sub-string of a minimum length" do
+      subject.each_substring(2) do |sub_string|
+        sub_string.length.should >= 2
+
+        should include(sub_string)
+      end
+    end
+
+    it "should return an Enumerator when no block is given" do
+      substrings = subject.each_substring
+      
+      substrings.all? { |sub_string|
+        subject.include?(sub_string)
+      }.should == true
+    end
+  end
+
+  describe "each_unique_substring" do
+    subject { 'abablol' }
+
+    it "should enumerate over each unique sub-string within the String" do
+      seen = []
+
+      subject.each_unique_substring do |sub_string|
+        should include(sub_string)
+        seen.should_not include(sub_string)
+
+        seen << sub_string
+      end
+    end
+
+    it "should enumerate over each sub-string of a minimum length" do
+      seen = []
+
+      subject.each_unique_substring(2) do |sub_string|
+        sub_string.length.should >= 2
+
+        should include(sub_string)
+        seen.should_not include(sub_string)
+
+        seen << sub_string
+      end
+    end
+
+    it "should return an Enumerator when no block is given" do
+      seen = subject.each_unique_substring
+
+      seen.all? { |sub_string|
+        subject.include?(sub_string)
+      }.should == true
+
+      seen = seen.to_a
+      seen.uniq.should == seen
+    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'
+      two = 'What is puzzling you is the nature of my name'
+      common = 'What is puzzling you is the nature of my '
+
+      one.common_prefix(two).should == common
+    end
+
+    it "should return the common prefix between two Strings with no uncommon postfix" do
+      one = "1234"
+      two = "12345"
+      common = "1234"
+
+      one.common_prefix(two).should == common
+    end
+
+    it "should return an empty String if there is no common prefix" do
+      one = 'Tell me people'
+      two = 'Whats my name'
+
+      one.common_prefix(two).should == ''
+    end
+
+    it "should return an empty String if one of the strings is also empty" do
+      one = 'Haha'
+      two = ''
+
+      one.common_prefix(two).should == ''
+    end
+  end
+
+  describe "common_postfix" do
+    it "should find the common postfix between two Strings" do
+      one = 'Tell me baby whats my name'
+      two = "Can't you guess my name"
+      common = 's my name'
+
+      one.common_postfix(two).should == common
+    end
+
+    it "should return an empty String if there is no common postfix" do
+      one = 'You got to right up, stand up'
+      two = 'stand up for your rights'
+
+      one.common_postfix(two).should == ''
+    end
+
+    it "should return an empty String if one of the strings is also empty" do
+      one = 'You and I must fight for our rights'
+      two = ''
+
+      one.common_postfix(two).should == ''
+    end
+  end
+
+  describe "uncommon_substring" do
+    it "should find the uncommon substring between two Strings" do
+      one = "Tell me baby whats my name"
+      two = "Tell me honey whats my name"
+      uncommon = 'bab'
+
+      one.uncommon_substring(two).should == uncommon
+    end
+
+    it "should find the uncommon substring between two Strings with a common prefix" do
+      one = 'You and I must fight for our rights'
+      two = 'You and I must fight to survive'
+      uncommon = 'for our rights'
+
+      one.uncommon_substring(two).should == uncommon
+    end
+
+    it "should find the uncommon substring between two Strings with a common postfix" do
+      one = 'Tell me baby whats my name'
+      two = "Can't you guess my name"
+      uncommon = 'Tell me baby what'
+
+      one.uncommon_substring(two).should == uncommon
+    end
+  end
+
+  describe "dump" do
+    it "should dump printable strings" do
+      "hello".dump.should == '"hello"'
+    end
+
+    it "should dump strings containing control characters" do
+      "hello\n\b\a".dump.should == '"hello\n\b\a"'
+    end
+
+    it "should dump strings containing non-printable characters" do
+      "hello\x90\x05\xef".dump.should == '"hello\x90\x05\xef"'
+    end
+
+    it "should dump the string when calling the inspect method" do
+      "hello\x90\x05\xef".inspect.should == '"hello\x90\x05\xef"'
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+module Helpers
+  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
+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

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

@@ -0,0 +1,17 @@
+00000000  00 01 02 03 04 05 06 07  08 09 0a 0b 0c 0d 0e 0f  |................|
+00000010  10 11 12 13 14 15 16 17  18 19 1a 1b 1c 1d 1e 1f  |................|
+00000020  20 21 22 23 24 25 26 27  28 29 2a 2b 2c 2d 2e 2f  | !"#$%&'()*+,-./|
+00000030  30 31 32 33 34 35 36 37  38 39 3a 3b 3c 3d 3e 3f  |0123456789:;<=>?|
+00000040  40 41 42 43 44 45 46 47  48 49 4a 4b 4c 4d 4e 4f  |@ABCDEFGHIJKLMNO|
+00000050  50 51 52 53 54 55 56 57  58 59 5a 5b 5c 5d 5e 5f  |PQRSTUVWXYZ[\]^_|
+00000060  60 61 62 63 64 65 66 67  68 69 6a 6b 6c 6d 6e 6f  |`abcdefghijklmno|
+00000070  70 71 72 73 74 75 76 77  78 79 7a 7b 7c 7d 7e 7f  |pqrstuvwxyz{|}~.|
+00000080  80 81 82 83 84 85 86 87  88 89 8a 8b 8c 8d 8e 8f  |................|
+00000090  90 91 92 93 94 95 96 97  98 99 9a 9b 9c 9d 9e 9f  |................|
+000000a0  a0 a1 a2 a3 a4 a5 a6 a7  a8 a9 aa ab ac ad ae af  |................|
+000000b0  b0 b1 b2 b3 b4 b5 b6 b7  b8 b9 ba bb bc bd be bf  |................|
+000000c0  c0 c1 c2 c3 c4 c5 c6 c7  c8 c9 ca cb cc cd ce cf  |................|
+000000d0  d0 d1 d2 d3 d4 d5 d6 d7  d8 d9 da db dc dd de df  |................|
+000000e0  e0 e1 e2 e3 e4 e5 e6 e7  e8 e9 ea eb ec ed ee ef  |................|
+000000f0  f0 f1 f2 f3 f4 f5 f6 f7  f8 f9 fa fb fc fd fe ff  |................|
+00000100

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

@@ -0,0 +1,17 @@
+0000000    0100    0302    0504    0706    0908    0b0a    0d0c    0f0e
+0000010    1110    1312    1514    1716    1918    1b1a    1d1c    1f1e
+0000020    2120    2322    2524    2726    2928    2b2a    2d2c    2f2e
+0000030    3130    3332    3534    3736    3938    3b3a    3d3c    3f3e
+0000040    4140    4342    4544    4746    4948    4b4a    4d4c    4f4e
+0000050    5150    5352    5554    5756    5958    5b5a    5d5c    5f5e
+0000060    6160    6362    6564    6766    6968    6b6a    6d6c    6f6e
+0000070    7170    7372    7574    7776    7978    7b7a    7d7c    7f7e
+0000080    8180    8382    8584    8786    8988    8b8a    8d8c    8f8e
+0000090    9190    9392    9594    9796    9998    9b9a    9d9c    9f9e
+00000a0    a1a0    a3a2    a5a4    a7a6    a9a8    abaa    adac    afae
+00000b0    b1b0    b3b2    b5b4    b7b6    b9b8    bbba    bdbc    bfbe
+00000c0    c1c0    c3c2    c5c4    c7c6    c9c8    cbca    cdcc    cfce
+00000d0    d1d0    d3d2    d5d4    d7d6    d9d8    dbda    dddc    dfde
+00000e0    e1e0    e3e2    e5e4    e7e6    e9e8    ebea    edec    efee
+00000f0    f1f0    f3f2    f5f4    f7f6    f9f8    fbfa    fdfc    fffe
+0000100

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

@@ -0,0 +1,17 @@
+0000000 000 001 002 003 004 005 006 007 010 011 012 013 014 015 016 017
+0000010 020 021 022 023 024 025 026 027 030 031 032 033 034 035 036 037
+0000020 040 041 042 043 044 045 046 047 050 051 052 053 054 055 056 057
+0000030 060 061 062 063 064 065 066 067 070 071 072 073 074 075 076 077
+0000040 100 101 102 103 104 105 106 107 110 111 112 113 114 115 116 117
+0000050 120 121 122 123 124 125 126 127 130 131 132 133 134 135 136 137
+0000060 140 141 142 143 144 145 146 147 150 151 152 153 154 155 156 157
+0000070 160 161 162 163 164 165 166 167 170 171 172 173 174 175 176 177
+0000080 200 201 202 203 204 205 206 207 210 211 212 213 214 215 216 217
+0000090 220 221 222 223 224 225 226 227 230 231 232 233 234 235 236 237
+00000a0 240 241 242 243 244 245 246 247 250 251 252 253 254 255 256 257
+00000b0 260 261 262 263 264 265 266 267 270 271 272 273 274 275 276 277
+00000c0 300 301 302 303 304 305 306 307 310 311 312 313 314 315 316 317
+00000d0 320 321 322 323 324 325 326 327 330 331 332 333 334 335 336 337
+00000e0 340 341 342 343 344 345 346 347 350 351 352 353 354 355 356 357
+00000f0 360 361 362 363 364 365 366 367 370 371 372 373 374 375 376 377
+0000100

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

@@ -0,0 +1,17 @@
+0000000  000400  001402  002404  003406  004410  005412  006414  007416
+0000010  010420  011422  012424  013426  014430  015432  016434  017436
+0000020  020440  021442  022444  023446  024450  025452  026454  027456
+0000030  030460  031462  032464  033466  034470  035472  036474  037476
+0000040  040500  041502  042504  043506  044510  045512  046514  047516
+0000050  050520  051522  052524  053526  054530  055532  056534  057536
+0000060  060540  061542  062544  063546  064550  065552  066554  067556
+0000070  070560  071562  072564  073566  074570  075572  076574  077576
+0000080  100600  101602  102604  103606  104610  105612  106614  107616
+0000090  110620  111622  112624  113626  114630  115632  116634  117636
+00000a0  120640  121642  122644  123646  124650  125652  126654  127656
+00000b0  130660  131662  132664  133666  134670  135672  136674  137676
+00000c0  140700  141702  142704  143706  144710  145712  146714  147716
+00000d0  150720  151722  152724  153726  154730  155732  156734  157736
+00000e0  160740  161742  162744  163746  164750  165752  166754  167756
+00000f0  170760  171762  172764  173766  174770  175772  176774  177776
+0000100

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

@@ -0,0 +1,6 @@
+00000000  68 65 6c 6c 6f 20 20 20  20 20 20 20 20 20 20 20  |hello           |
+00000010  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
+*
+00000030  20 20 20 20 20 20 20 20  20 20 20 67 6f 6f 64 62  |           goodb|
+00000040  79 65 0a                                          |ye.|
+00000043

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

@@ -0,0 +1,17 @@
+0000000   0   1   2   3   4   5   6   7   8   9  10  11  12  13  14  15
+0000020  16  17  18  19  20  21  22  23  24  25  26  27  28  29  30  31
+0000040  32  33  34  35  36  37  38  39  40  41  42  43  44  45  46  47
+0000060  48  49  50  51  52  53  54  55  56  57  58  59  60  61  62  63
+0000100  64  65  66  67  68  69  70  71  72  73  74  75  76  77  78  79
+0000120  80  81  82  83  84  85  86  87  88  89  90  91  92  93  94  95
+0000140  96  97  98  99 100 101 102 103 104 105 106 107 108 109 110 111
+0000160 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127
+0000200 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143
+0000220 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159
+0000240 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175
+0000260 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191
+0000300 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207
+0000320 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223
+0000340 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239
+0000360 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255
+0000400

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

@@ -0,0 +1,17 @@
+0000000   50462976  117835012  185207048  252579084
+0000020  319951120  387323156  454695192  522067228
+0000040  589439264  656811300  724183336  791555372
+0000060  858927408  926299444  993671480 1061043516
+0000100 1128415552 1195787588 1263159624 1330531660
+0000120 1397903696 1465275732 1532647768 1600019804
+0000140 1667391840 1734763876 1802135912 1869507948
+0000160 1936879984 2004252020 2071624056 2138996092
+0000200 2206368128 2273740164 2341112200 2408484236
+0000220 2475856272 2543228308 2610600344 2677972380
+0000240 2745344416 2812716452 2880088488 2947460524
+0000260 3014832560 3082204596 3149576632 3216948668
+0000300 3284320704 3351692740 3419064776 3486436812
+0000320 3553808848 3621180884 3688552920 3755924956
+0000340 3823296992 3890669028 3958041064 4025413100
+0000360 4092785136 4160157172 4227529208 4294901244
+0000400

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

@@ -0,0 +1,17 @@
+0000000   506097522914230528  1084818905618843912
+0000020  1663540288323457296  2242261671028070680
+0000040  2820983053732684064  3399704436437297448
+0000060  3978425819141910832  4557147201846524216
+0000100  5135868584551137600  5714589967255750984
+0000120  6293311349960364368  6872032732664977752
+0000140  7450754115369591136  8029475498074204520
+0000160  8608196880778817904  9186918263483431288
+0000200  9765639646188044672 10344361028892658056
+0000220 10923082411597271440 11501803794301884824
+0000240 12080525177006498208 12659246559711111592
+0000260 13237967942415724976 13816689325120338360
+0000300 14395410707824951744 14974132090529565128
+0000320 15552853473234178512 16131574855938791896
+0000340 16710296238643405280 17289017621348018664
+0000360 17867739004052632048 18446460386757245432
+0000400

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

@@ -0,0 +1,17 @@
+0000000   256   770  1284  1798  2312  2826  3340  3854
+0000020  4368  4882  5396  5910  6424  6938  7452  7966
+0000040  8480  8994  9508 10022 10536 11050 11564 12078
+0000060 12592 13106 13620 14134 14648 15162 15676 16190
+0000100 16704 17218 17732 18246 18760 19274 19788 20302
+0000120 20816 21330 21844 22358 22872 23386 23900 24414
+0000140 24928 25442 25956 26470 26984 27498 28012 28526
+0000160 29040 29554 30068 30582 31096 31610 32124 32638
+0000200 33152 33666 34180 34694 35208 35722 36236 36750
+0000220 37264 37778 38292 38806 39320 39834 40348 40862
+0000240 41376 41890 42404 42918 43432 43946 44460 44974
+0000260 45488 46002 46516 47030 47544 48058 48572 49086
+0000300 49600 50114 50628 51142 51656 52170 52684 53198
+0000320 53712 54226 54740 55254 55768 56282 56796 57310
+0000340 57824 58338 58852 59366 59880 60394 60908 61422
+0000360 61936 62450 62964 63478 63992 64506 65020 65534
+0000400

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

@@ -0,0 +1,17 @@
+0000000 00 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f
+0000020 10 11 12 13 14 15 16 17 18 19 1a 1b 1c 1d 1e 1f
+0000040 20 21 22 23 24 25 26 27 28 29 2a 2b 2c 2d 2e 2f
+0000060 30 31 32 33 34 35 36 37 38 39 3a 3b 3c 3d 3e 3f
+0000100 40 41 42 43 44 45 46 47 48 49 4a 4b 4c 4d 4e 4f
+0000120 50 51 52 53 54 55 56 57 58 59 5a 5b 5c 5d 5e 5f
+0000140 60 61 62 63 64 65 66 67 68 69 6a 6b 6c 6d 6e 6f
+0000160 70 71 72 73 74 75 76 77 78 79 7a 7b 7c 7d 7e 7f
+0000200 80 81 82 83 84 85 86 87 88 89 8a 8b 8c 8d 8e 8f
+0000220 90 91 92 93 94 95 96 97 98 99 9a 9b 9c 9d 9e 9f
+0000240 a0 a1 a2 a3 a4 a5 a6 a7 a8 a9 aa ab ac ad ae af
+0000260 b0 b1 b2 b3 b4 b5 b6 b7 b8 b9 ba bb bc bd be bf
+0000300 c0 c1 c2 c3 c4 c5 c6 c7 c8 c9 ca cb cc cd ce cf
+0000320 d0 d1 d2 d3 d4 d5 d6 d7 d8 d9 da db dc dd de df
+0000340 e0 e1 e2 e3 e4 e5 e6 e7 e8 e9 ea eb ec ed ee ef
+0000360 f0 f1 f2 f3 f4 f5 f6 f7 f8 f9 fa fb fc fd fe ff
+0000400

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

@@ -0,0 +1,17 @@
+0000000 03020100 07060504 0b0a0908 0f0e0d0c
+0000020 13121110 17161514 1b1a1918 1f1e1d1c
+0000040 23222120 27262524 2b2a2928 2f2e2d2c
+0000060 33323130 37363534 3b3a3938 3f3e3d3c
+0000100 43424140 47464544 4b4a4948 4f4e4d4c
+0000120 53525150 57565554 5b5a5958 5f5e5d5c
+0000140 63626160 67666564 6b6a6968 6f6e6d6c
+0000160 73727170 77767574 7b7a7978 7f7e7d7c
+0000200 83828180 87868584 8b8a8988 8f8e8d8c
+0000220 93929190 97969594 9b9a9998 9f9e9d9c
+0000240 a3a2a1a0 a7a6a5a4 abaaa9a8 afaeadac
+0000260 b3b2b1b0 b7b6b5b4 bbbab9b8 bfbebdbc
+0000300 c3c2c1c0 c7c6c5c4 cbcac9c8 cfcecdcc
+0000320 d3d2d1d0 d7d6d5d4 dbdad9d8 dfdedddc
+0000340 e3e2e1e0 e7e6e5e4 ebeae9e8 efeeedec
+0000360 f3f2f1f0 f7f6f5f4 fbfaf9f8 fffefdfc
+0000400