ronin-support 0.4.1 → 0.5.2

data/lib/ronin/wordlist.rb

@@ -1,23 +1,25 @@
 #
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
-# This file is part of Ronin Support.
+# This file is part of ronin-support.
 #
-# Ronin Support is free software: you can redistribute it and/or modify
+# ronin-support is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# Ronin Support is distributed in the hope that it will be useful,
+# ronin-support is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU Lesser General Public License for more details.
 #
 # You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+# along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 #
 
-require 'ronin/fuzzing/extensions'
+require 'ronin/fuzzing/template'
+require 'ronin/fuzzing/mutator'
+require 'ronin/extensions/regexp'
 
 require 'set'
 
@@ -31,8 +33,15 @@ module Ronin
 
     include Enumerable
 
-    # The path to the wordlist file or a list of words
-    attr_accessor :list
+    # The path to the wordlist file
+    #
+    # @since 0.5.0
+    attr_reader :path
+
+    # The words for the list
+    #
+    # @since 0.5.0
+    attr_reader :words
 
     # Mutation rules to apply to every word in the list
     attr_reader :mutations
@@ -40,7 +49,7 @@ module Ronin
     #
     # Initializes the wordlist.
     #
-    # @param [String, Enumerable] list
+    # @param [String, Enumerable] wordlist
     #   The path of the wordlist or list of words.
     #
     # @param [Hash{Regexp,String,Symbol => Symbol,#each}] mutations
@@ -52,6 +61,9 @@ module Ronin
     # @yieldparam [Wordlist] wordlist
     #   The new wordlist object.
     #
+    # @raise [TypeError]
+    #   The list was not a path to a wordlist file, nor a list of words.
+    #
     # @example Use a file wordlist
     #   wordlist = Wordlist.new('passwords.txt')
     #
@@ -65,10 +77,19 @@ module Ronin
     #
     # @api public
     #
-    def initialize(list,mutations={})
-      @list      = list
-      @mutations = {}
-      @mutations.merge!(mutations)
+    def initialize(wordlist,mutations={})
+      case wordlist
+      when String
+        @path  = wordlist
+        @words = nil
+      when Enumerable
+        @path  = nil
+        @words = wordlist
+      else
+        raise(TypeError,"wordlist must be a path or Enumerable")
+      end
+
+      @mutations = mutations
 
       yield self if block_given?
     end
@@ -86,14 +107,14 @@ module Ronin
     # @yieldparam [String] word
     #   A unique word from the text.
     #
-    # @return [SortedSet]
+    # @return [Set]
     #   The unique set of words from the text.
     #
     def self.parse(text)
-      words_seen = SortedSet[]
+      words_seen = Set[]
 
       text.each_line do |line|
-        line.split.each do |word|
+        line.scan(Regexp::WORD) do |word|
           if block_given?
             yield word unless words_seen.include?(word)
           end
@@ -121,6 +142,41 @@ module Ronin
       new(parse(text),mutations)
     end
 
+    #
+    # Creates a new wordlist file.
+    #
+    # @param [String] path
+    #   The path to the wordlist file.
+    #
+    # @param [String] text
+    #   The text to parse.
+    #
+    # @param [Hash{Regexp,String,Symbol => Symbol,#each}] mutations
+    #   Additional mutations for the wordlist.
+    #
+    # @return [Wordlist]
+    #   The newly built wordlist.
+    #
+    # @since 0.5.0
+    #
+    def self.create(path,text,mutations={})
+      wordlist = build(text,mutations)
+
+      return wordlist.save(path)
+    end
+
+    #
+    # The wordlist file or list of words.
+    #
+    # @return [String, Enumerable]
+    #   The path to the wordlist file or list of words.
+    #
+    # @api semipublic
+    #
+    def list
+      @path || @words
+    end
+
     #
     # Iterates over each word in the list.
     #
@@ -133,25 +189,22 @@ module Ronin
     # @return [Enumerator]
     #   If no block is given, an Enumerator will be returned.
     #
-    # @raise [TypeError]
-    #   The list was not a path to a wordlist file, nor a list of words.
+    # @raise [RuntimeError]
+    #   {#path} or {#words} must be set.
     #
     # @api public
     #
     def each_word(&block)
-      return enum_for(:each_word) unless block
+      return enum_for(__method__) unless block
 
-      case @list
-      when String
-        File.open(@list) do |file|
+      if @path
+        File.open(@path) do |file|
           file.each_line do |line|
             yield line.chomp
           end
         end
-      when Enumerable
-        @list.each(&block)
-      else
-        raise(TypeError,"list must be a path or Enumerable")
+      elsif @words
+        @words.each(&block)
       end
     end
 
@@ -170,14 +223,18 @@ module Ronin
     # @api public
     #
     def each(&block)
-      return enum_for(:each) unless block
+      return enum_for(__method__) unless block
+
+      mutator = unless @mutations.empty?
+                  Fuzzing::Mutator.new(@mutations)
+                end
 
       each_word do |word|
         yield word
 
-        unless @mutations.empty?
+        if mutator
           # perform additional mutations
-          word.mutate(@mutations,&block)
+          mutator.each(word,&block)
         end
       end
     end
@@ -200,7 +257,30 @@ module Ronin
     # @api public
     #
     def each_n_words(n,&block)
-      String.generate([each, n],&block)
+      Fuzzing::Template[[each, n]].each(&block)
+    end
+
+    #
+    # Saves the words to a new file.
+    #
+    # @param [String] path
+    #   The path to the new wordlist file.
+    #
+    # @return [Wordlist]
+    #   The wordlist object.
+    #
+    # @see #each
+    #
+    # @since 0.5.0
+    #
+    # @api public
+    #
+    def save(path)
+      File.open(path,'w') do |file|
+        each { |word| file.puts word }
+      end
+
+      return self
     end
 
   end

data/ronin-support.gemspec

@@ -2,130 +2,60 @@
 
 require 'yaml'
 
-Gem::Specification.new do |gemspec|
-  root = File.dirname(__FILE__)
-  lib_dir = File.join(root,'lib')
-  files = if File.directory?('.git')
-            `git ls-files`.split($/)
-          elsif File.directory?('.hg')
-            `hg manifest`.split($/)
-          elsif File.directory?('.svn')
-            `svn ls -R`.split($/).select { |path| File.file?(path) }
-          else
-            Dir['{**/}{.*,*}'].select { |path| File.file?(path) }
-          end
+Gem::Specification.new do |gem|
+  gemspec = YAML.load_file('gemspec.yml')
 
-  filter_files = lambda { |paths|
-    case paths
-    when Array
-      (files & paths)
-    when String
-      (files & Dir[paths])
-    end
-  }
-
-  version = {
-    :file => 'ronin/support/version',
-    :constant => 'Ronin::Support::VERSION'
-  }
-
-  defaults = {
-    'name' => File.basename(root),
-    'files' => files,
-    'executables' => filter_files['bin/*'].map { |path| File.basename(path) },
-    'test_files' => filter_files['{test/{**/}*_test.rb,spec/{**/}*_spec.rb}'],
-    'extra_doc_files' => filter_files['*.{txt,rdoc,md,markdown,tt,textile}'],
-  }
+  gem.name    = gemspec.fetch('name')
+  gem.version = gemspec.fetch('version') do
+                  lib_dir = File.join(File.dirname(__FILE__),'lib')
+                  $LOAD_PATH << lib_dir unless $LOAD_PATH.include?(lib_dir)
 
-  metadata = defaults.merge(YAML.load_file('gemspec.yml'))
+                  require 'ronin/support/version'
+                  Ronin::Support::VERSION
+                end
 
-  gemspec.name = metadata.fetch('name',defaults[:name])
-  gemspec.version = if metadata['version']
-                      metadata['version']
-                    else
-                      $LOAD_PATH << lib_dir unless $LOAD_PATH.include?(lib_dir)
+  gem.summary     = gemspec['summary']
+  gem.description = gemspec['description']
+  gem.licenses    = Array(gemspec['license'])
+  gem.authors     = Array(gemspec['authors'])
+  gem.email       = gemspec['email']
+  gem.homepage    = gemspec['homepage']
+  gem.metadata    = gemspec['metadata'] if gemspec['metadata']
 
-                      require version[:file]
-                      eval(version[:constant])
-                    end
+  glob = lambda { |patterns| gem.files & Dir[*patterns] }
 
-  gemspec.summary = metadata.fetch('summary',metadata['description'])
-  gemspec.description = metadata.fetch('description',metadata['summary'])
+  gem.files = `git ls-files`.split($/)
+  gem.files = glob[gemspec['files']] if gemspec['files']
 
-  case metadata['license']
-  when Array
-    gemspec.licenses = metadata['license']
-  when String
-    gemspec.license = metadata['license']
+  gem.executables = gemspec.fetch('executables') do
+    glob['bin/*'].map { |path| File.basename(path) }
   end
+  gem.default_executable = gem.executables.first if Gem::VERSION < '1.7.'
 
-  case metadata['authors']
-  when Array
-    gemspec.authors = metadata['authors']
-  when String
-    gemspec.author = metadata['authors']
-  end
-
-  gemspec.email = metadata['email']
-  gemspec.homepage = metadata['homepage']
+  gem.extensions       = glob[gemspec['extensions'] || 'ext/**/extconf.rb']
+  gem.test_files       = glob[gemspec['test_files'] || '{test/{**/}*_test.rb']
+  gem.extra_rdoc_files = glob[gemspec['extra_doc_files'] || '*.{txt,md}']
 
-  case metadata['require_paths']
-  when Array
-    gemspec.require_paths = metadata['require_paths']
-  when String
-    gemspec.require_path = metadata['require_paths']
-  end
+  gem.require_paths = Array(gemspec.fetch('require_paths') {
+    %w[ext lib].select { |dir| File.directory?(dir) }
+  })
 
-  gemspec.files = filter_files[metadata['files']]
+  gem.requirements              = gemspec['requirements']
+  gem.required_ruby_version     = gemspec['required_ruby_version']
+  gem.required_rubygems_version = gemspec['required_rubygems_version']
+  gem.post_install_message      = gemspec['post_install_message']
 
-  gemspec.executables = metadata['executables']
-  gemspec.extensions = metadata['extensions']
-
-  if Gem::VERSION < '1.7.'
-    gemspec.default_executable = gemspec.executables.first
-  end
-
-  gemspec.test_files = filter_files[metadata['test_files']]
-
-  unless gemspec.files.include?('.document')
-    gemspec.extra_rdoc_files = metadata['extra_doc_files']
-  end
-
-  gemspec.post_install_message = metadata['post_install_message']
-  gemspec.requirements = metadata['requirements']
-
-  if gemspec.respond_to?(:required_ruby_version=)
-    gemspec.required_ruby_version = metadata['required_ruby_version']
-  end
-
-  if gemspec.respond_to?(:required_rubygems_version=)
-    gemspec.required_rubygems_version = metadata['required_rubygems_version']
-  end
-
-  parse_versions = lambda { |versions|
-    case versions
-    when Array
-      versions.map { |v| v.to_s }
-    when String
-      versions.split(/,\s*/)
-    end
-  }
-
-  if metadata['dependencies']
-    metadata['dependencies'].each do |name,versions|
-      gemspec.add_dependency(name,parse_versions[versions])  
-    end
-  end
+  split = lambda { |string| string.split(/,\s*/) }
 
-  if metadata['runtime_dependencies']
-    metadata['runtime_dependencies'].each do |name,versions|
-      gemspec.add_runtime_dependency(name,parse_versions[versions])  
+  if gemspec['dependencies']
+    gemspec['dependencies'].each do |name,versions|
+      gem.add_dependency(name,split[versions])
     end
   end
 
-  if metadata['development_dependencies']
-    metadata['development_dependencies'].each do |name,versions|
-      gemspec.add_development_dependency(name,parse_versions[versions])  
+  if gemspec['development_dependencies']
+    gemspec['development_dependencies'].each do |name,versions|
+      gem.add_development_dependency(name,split[versions])
     end
   end
 end

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

@@ -0,0 +1,13 @@
+module Helpers
+  DIRECTORY = File.join(File.dirname(__FILE__),'hexdumps')
+
+  def load_binary_data(name)
+    File.open(File.join(DIRECTORY,"#{name}.bin"),'rb') do |file|
+      file.read
+    end
+  end
+
+  def load_hexdump(name)
+    File.read(File.join(DIRECTORY,"#{name}.txt"))
+  end
+end

data/spec/binary/hexdump/helpers/hexdumps/od_doubles.txt

@@ -0,0 +1,17 @@
+0000000   7.949928895127363e-275  3.6919162048650923e-236
+0000020   1.846323925681849e-197   8.567745616612358e-159
+0000040   4.287943403239047e-120   1.9882885252746607e-81
+0000060    9.958334378896745e-43   0.00046141357891195693
+0000100   2.3127085096212408e+35   1.0707780659396515e+74
+0000120    5.37095661886286e+112  2.4848873176582267e+151
+0000140  1.2473230926066734e+190   5.766497103752564e+228
+0000160  2.8966956840444004e+267  1.3381833135892986e+306
+0000200  -2.081576000531694e-272  -9.609176777827115e-234
+0000220  -4.834030884500847e-195 -2.2299033716331566e-156
+0000240 -1.1225952939479768e-117  -5.1746869438707237e-79
+0000260   -2.606955873096698e-40     -0.12008266051518646
+0000300  -6.0539778500895675e+37   -2.786600511251514e+76
+0000320  -1.405868428700574e+115  -6.466470811086963e+153
+0000340  -3.264714813035785e+192 -1.5005764835379223e+231
+0000360  -7.581280411902108e+269                     -nan
+0000400