ronin 1.5.0.rc2 → 1.5.0

data/ChangeLog.md

@@ -1,4 +1,4 @@
-### 1.5.0 / 2012-05-28
+### 1.5.0 / 2012-06-16
 
 * Require ronin-support ~> 0.5.
 * Added {Ronin::UI::CLI::Command#setup}.

data/Gemfile

@@ -23,8 +23,7 @@ gem 'jruby-openssl',	'~> 0.7', :platforms => :jruby
 # gem 'dm-timestamps',      DM_VERSION, :git => "#{DM_URI}/dm-timestamps.git"
 
 # Library dependencies
-# gem 'ronin-support',	'~> 0.5.0.rc1', :git => "#{RONIN_URI}/ronin-support.git",
-#                                       :branch => '0.5.0'
+# gem 'ronin-support',	'~> 0.5', :git => "#{RONIN_URI}/ronin-support.git"
 
 group :development do
   gem 'rake',           '~> 0.8'

data/README.md

@@ -109,6 +109,10 @@ View available commands:
 
     $ ronin help
 
+View a man-page for a command:
+
+    $ ronin help wordlist
+
 Install a Repository:
 
     $ ronin install svn://example.com/path/to/repo

data/bin/ronin-fuzzer

@@ -0,0 +1,25 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+
+root_dir = File.expand_path(File.join(File.dirname(__FILE__),'..'))
+if File.directory?(File.join(root_dir,'.git'))
+  Dir.chdir(root_dir) do |path|
+    require 'bundler'
+
+    begin
+      Bundler.setup(:default)
+    rescue Bundler::BundlerError => e
+      warn e.message
+      warn "Run `bundle install` to install missing gems"
+      exit e.status_code
+    end
+  end
+end
+
+lib_dir = File.join(root_dir,'lib')
+$LOAD_PATH << lib_dir unless $LOAD_PATH.include?(lib_dir)
+
+require 'ronin/ui/cli/commands/fuzzer'
+
+Ronin::UI::CLI::Commands::Fuzzer.start

data/gemspec.yml

@@ -8,7 +8,7 @@ description:
 license: GPL-3
 authors: Postmodern
 email: postmodern.mod3@gmail.com
-homepage: http://github.com/ronin-ruby/ronin
+homepage: http://ronin-ruby.github.com/
 has_yard: true
 post_install_message: |
   *************************************************************************
@@ -41,6 +41,7 @@ generated_files:
  - man/ronin-database.1
  - man/ronin-emails.1
  - man/ronin-exec.1
+ - man/ronin-fuzzer.1
  - man/ronin-help.1
  - man/ronin-hosts.1
  - man/ronin-install.1
@@ -80,7 +81,7 @@ dependencies:
   ripl-short_errors: ~> 0.1
   ripl-color_result: ~> 0.3
   # Ronin dependencies:
-  ronin-support: ~> 0.5.0.rc2
+  ronin-support: ~> 0.5
 
 development_dependencies:
   bundler: ~> 1.0

data/lib/ronin/auto_load.rb

@@ -25,6 +25,8 @@ module Ronin
   # When included into other namespaces, it allows for auto-loading Classes
   # or Modules via {ClassMethods#const_missing}.
   #
+  # @api semipublic
+  #
   # @since 1.1.0
   #
   module AutoLoad

data/lib/ronin/database/migrations/graph.rb

@@ -212,7 +212,7 @@ module Ronin
         # @api semipublic
         #
         def upto(position_or_name=nil)
-          return enum_for(:upto,position_or_name) unless block_given?
+          return enum_for(__method__,position_or_name) unless block_given?
 
           name = name_of(position_or_name)
 
@@ -250,7 +250,7 @@ module Ronin
         # @api semipublic
         #
         def downto(position_or_name=nil)
-          return enum_for(:downto,position_or_name) unless block_given?
+          return enum_for(__method__,position_or_name) unless block_given?
 
           name = name_of(position_or_name)
 

data/lib/ronin/email_address.rb

@@ -76,7 +76,7 @@ module Ronin
     # @api public
     #
     def self.extract(text)
-      return enum_for(:extract,text).to_a unless block_given?
+      return enum_for(__method__,text).to_a unless block_given?
 
       scanner = StringScanner.new(text)
 

data/lib/ronin/host_name.rb

@@ -83,7 +83,7 @@ module Ronin
     # @api public
     #
     def self.extract(text)
-      return enum_for(:extract,text).to_a unless block_given?
+      return enum_for(__method__,text).to_a unless block_given?
 
       scanner = StringScanner.new(text)
 

data/lib/ronin/installation.rb

@@ -39,7 +39,7 @@ module Ronin
     #
     # @api semipublic
     #
-    def Installation.gems
+    def self.gems
       load! if @gems.empty?
       return @gems
     end
@@ -54,7 +54,7 @@ module Ronin
     #
     # @api semipublic
     #
-    def Installation.paths
+    def self.paths
       load! if @paths.empty?
       return @paths
     end
@@ -69,7 +69,7 @@ module Ronin
     #
     # @api semipublic
     #
-    def Installation.libraries
+    def self.libraries
       gems.keys
     end
 
@@ -93,8 +93,8 @@ module Ronin
     #
     # @api semipublic
     #
-    def Installation.each_file(pattern)
-      return enum_for(:each_file,pattern) unless block_given?
+    def self.each_file(pattern)
+      return enum_for(__method__,pattern) unless block_given?
 
       # query the installed gems
       paths.each do |gem_path|
@@ -130,16 +130,16 @@ module Ronin
     #
     # @api semipublic
     #
-    def Installation.each_file_in(directory,ext=nil)
-      return enum_for(:each_file_in,directory,ext) unless block_given?
+    def self.each_file_in(directory,ext=nil)
+      return enum_for(__method__,directory,ext) unless block_given?
+
+      directory = File.join(directory,File::SEPARATOR)
 
       pattern = File.join(directory,'**','*')
       pattern << ".#{ext}" if ext
 
-      slice_index = directory.length + 1
-
       each_file(pattern) do |path|
-        yield path[slice_index..-1]
+        yield path.sub(directory,'')
       end
     end
 
@@ -155,7 +155,7 @@ module Ronin
     #
     # @api private
     #
-    def Installation.load_gems!
+    def self.load_gems!
       register_gem = lambda { |gem|
         @gems[gem.name] = gem
         @paths << gem.full_gem_path
@@ -184,7 +184,7 @@ module Ronin
     #
     # @api private
     #
-    def Installation.load_gemspecs!
+    def self.load_gemspecs!
       $LOAD_PATH.each do |lib_dir|
         root_dir = File.expand_path(File.join(lib_dir,'..'))
         gemspec_path = Dir[File.join(root_dir,'ronin*.gemspec')][0]
@@ -216,7 +216,7 @@ module Ronin
     #
     # @api private
     #
-    def Installation.load!
+    def self.load!
       if Gem.loaded_specs.has_key?('ronin')
         load_gems!
       else

data/lib/ronin/ip_address.rb

@@ -98,7 +98,7 @@ module Ronin
     # @api public
     #
     def self.extract(text,version=nil)
-      return enum_for(:extract,text,version).to_a unless block_given?
+      return enum_for(__method__,text,version).to_a unless block_given?
 
       IPAddr.extract(text,version) do |ip|
         yield parse(ip)

data/lib/ronin/mac_address.rb

@@ -64,7 +64,7 @@ module Ronin
     # @api public
     #
     def self.extract(text)
-      return enum_for(:extract,text).to_a unless block_given?
+      return enum_for(__method__,text).to_a unless block_given?
 
       scanner = StringScanner.new(text)
 

data/lib/ronin/model/importable.rb

@@ -49,7 +49,7 @@ module Ronin
         # @api public
         #
         def import(path)
-          return enum_for(:import,path).to_a unless block_given?
+          return enum_for(__method__,path).to_a unless block_given?
 
           File.open(path) do |file|
             file.each_line do |line|

data/lib/ronin/repository.rb

@@ -475,7 +475,7 @@ module Ronin
     # @api private
     #
     def each_script(&block)
-      return enum_for(:each_script) unless block
+      return enum_for(__method__) unless block
 
       @script_dirs.each do |dir|
         Pathname.glob(dir.join('**','*.rb'),&block)

data/lib/ronin/ui/cli/cli.rb

@@ -94,8 +94,9 @@ module Ronin
       #
       def CLI.command(name)
         name = name.to_s
+        path = name.tr(':','/')
 
-        unless (command = Commands.require_const(name))
+        unless (command = Commands.require_const(path))
           raise(UnknownCommand,"unable to load the command #{name.dump}",caller)
         end
 

data/lib/ronin/ui/cli/command.rb

@@ -471,7 +471,7 @@ module Ronin
         # @api private
         #
         def self.each_option(&block)
-          return enum_for(:each_option) unless block
+          return enum_for(__method__) unless block
 
           ancestors.reverse_each do |ancestor|
             if ancestor <= Command
@@ -557,7 +557,7 @@ module Ronin
         # @api semipublic
         #
         def self.each_argument(&block)
-          return enum_for(:each_argument) unless block
+          return enum_for(__method__) unless block
 
           ancestors.reverse_each do |ancestor|
             if ancestor <= Command

data/lib/ronin/ui/cli/commands/database.rb

@@ -121,12 +121,9 @@ module Ronin
               return
             end
 
-            if add?
-              add_repository
-            elsif set?
-              set_repository
-            elsif delete?
-              delete_repository
+            if    add?    then add_repository
+            elsif set?    then set_repository
+            elsif remove? then remove_repository
             else
               Ronin::Database.repositories.each do |name,uri|
                 print_hash uri, :title => name
@@ -174,7 +171,7 @@ module Ronin
           def set_repository
             unless Ronin::Database.repository?(@set)
               print_error "Unknown Database repository #{@set}"
-              return
+              exit -1
             end
 
             Ronin::Database.save do
@@ -190,7 +187,7 @@ module Ronin
           def remove_repository
             unless Ronin::Database.repository?(@remove)
               print_error "Unknown Database repository #{@remove}"
-              return
+              exit -1
             end
 
             Ronin::Database.save do

data/lib/ronin/ui/cli/commands/fuzzer.rb

@@ -0,0 +1,306 @@
+#
+# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# This file is part of Ronin.
+#
+# Ronin is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Ronin 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 General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with Ronin.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+require 'ronin/ui/cli/command'
+require 'ronin/fuzzing/repeater'
+require 'ronin/fuzzing/fuzzer'
+
+require 'shellwords'
+require 'tempfile'
+require 'socket'
+
+module Ronin
+  module UI
+    module CLI
+      module Commands
+        #
+        # Performs basic fuzzing of files, commands or TCP/UDP services.
+        #
+        # ## Usage
+        #
+        #     ronin fuzzer [options]
+        #
+        # ## Options
+        #
+        #    -v, --[no-]verbose               Enable verbose output.
+        #    -q, --[no-]quiet                 Disable verbose output.
+        #        --[no-]silent                Silence all output.
+        #        --[no-]color                 Enables color output.
+        #                                     Default: true
+        #    -r [[PATTERN|/REGEXP/]:[METHOD|STRING*N[-M]]],
+        #        --rule                       Fuzzing rules.
+        #    -i, --input [FILE]               Input file to fuzz.
+        #    -o, --output [FILE]              Output file path.
+        #    -c [PROGRAM [OPTIONS|#string#|#path#] ...],
+        #        --command                    Template command to run.
+        #    -t, --tcp [HOST:PORT]            TCP service to fuzz.
+        #    -u, --udp [HOST:PORT]            UDP service to fuzz.
+        #
+        # ## Examples
+        #
+        #     ronin fuzzer -i request.txt -r unix_path:bad_strings -o bad.txt
+        #
+        # @since 1.5.0
+        #
+        class Fuzzer < Command
+
+          summary 'Performs basic fuzzing of files'
+
+          option :input, :type        => String,
+                         :flag        => '-i',
+                         :usage       => 'FILE',
+                         :description => 'Input file to fuzz'
+
+          option :rules, :type        => Hash[String => String],
+                         :flag        => '-r',
+                         :usage       => '[PATTERN|/REGEXP/|STRING]:[METHOD|STRING*N[-M]]',
+                         :description => 'Fuzzing rules'
+
+          option :output, :type        => String,
+                          :flag        => '-o',
+                          :usgae       => 'PATH',
+                          :description => 'Output file path'
+
+          option :command, :type        => String,
+                           :flag        => '-c',
+                           :usage       => 'PROGRAM [OPTIONS|#string#|#path#] ...',
+                           :description => 'Template command to run'
+
+          option :tcp, :type        => String,
+                       :flag        => '-t',
+                       :usage       => 'HOST:PORT',
+                       :description => 'TCP service to fuzz'
+
+          option :udp, :type        => String,
+                       :flag        => '-u',
+                       :usage       => 'HOST:PORT',
+                       :description => 'UDP service to fuzz'
+
+          examples [
+            "ronin fuzzer -i request.txt -o bad.txt -r unix_path:bad_strings"
+          ]
+
+          #
+          # Sets up the fuzz command.
+          #
+          def setup
+            super
+
+            unless rules?
+              print_error "Must specify at least one fuzzing rule"
+              exit -1
+            end
+
+            @rules = Hash[@rules.map { |pattern,substitution|
+              [parse_pattern(pattern), parse_substitution(substitution)]
+            }]
+
+            if output?
+              @file_ext  = File.extname(@output)
+              @file_name = @file.chomp(@file_ext)
+            elsif command?
+              @command = shellwords(@command)
+            elsif (tcp? || udp?)
+              @socket_class = if    tcp? then TCPSocket
+                              elsif udp? then UDPSocket
+                              end
+
+              @host, @port = (@tcp || @udp).split(':',2)
+              @port = @port.to_i
+            end
+          end
+
+          def execute
+            data   = if input? then File.read(@input)
+                     else           $stdin.read
+                     end
+
+            method = if    output?        then method(:fuzz_file)
+                     elsif command?       then method(:fuzz_command)
+                     elsif (tcp? || udp?) then method(:fuzz_network)
+                     else                      method(:print_fuzz)
+                     end
+
+            fuzzer = Fuzzing::Fuzzer.new(@rules)
+            fuzzer.each(data).each_with_index do |string,index|
+              index = index + 1
+
+              method.call(string,index)
+            end
+          end
+
+          protected
+
+          include Shellwords
+
+          #
+          # Writes the fuzzed string to a file.
+          #
+          # @param [String] string
+          #   The fuzzed string.
+          #
+          # @param [Integer] index
+          #   The iteration number.
+          #
+          def fuzz_file(string,index)
+            path = "#{@file_name}-#{index}#{@file_ext}"
+
+            print_info "Creating file ##{index}: #{path} ..."
+
+            File.open(path,'wb') do |file|
+              file.write string
+            end
+          end
+
+          #
+          # Runs the fuzzed string in a command.
+          #
+          # @param [String] string
+          #   The fuzzed string.
+          #
+          # @param [Integer] index
+          #   The iteration number.
+          #
+          def fuzz_command(string,index)
+            Tempfile.open("ronin-fuzzer-#{index}") do |tempfile|
+              tempfile.write(string)
+              tempfile.flush
+
+              arguments = @command.map do |argument|
+                if argument.include?('#path#')
+                  argument.sub('#path#',tempfile.path)
+                elsif argument.include?('#string#')
+                  argument.sub('#string#',string)
+                else
+                  argument
+                end
+              end
+
+              print_info "Running command #{index}: #{arguments.join(' ')} ..."
+
+              # run the command as it's own process
+              unless system(*arguments)
+                status = $?
+
+                if status.coredump?
+                  # jack pot!
+                  print_error "Process ##{status.pid} coredumped!"
+                else
+                  # process errored out
+                  print_warning "Process ##{status.pid} exited with status #{status.exitstatus}"
+                end
+              end
+            end
+          end
+
+          #
+          # Sends the fuzzed string to a TCP/UDP Service.
+          #
+          # @param [String] string
+          #   The fuzzed string.
+          #
+          # @param [Integer] index
+          #   The iteration number.
+          #
+          def fuzz_network(string,index)
+            print_debug "Connecting to #{@host}:#{@port} ..."
+            socket = @socket_class.new(@host,@port)
+
+            print_info "Sending message ##{index}: #{string.inspect} ..."
+            socket.write(string)
+            socket.flush
+
+            print_debug "Disconnecting from #{@host}:#{@port} ..."
+            socket.close
+          end
+
+          #
+          # Prints the fuzzed string to STDOUT.
+          #
+          # @param [String] string
+          #   The fuzzed string.
+          #
+          # @param [Integer] index
+          #   The iteration number.
+          #
+          def print_fuzz(string,index)
+            print_debug "String ##{index} ..."
+
+            puts string
+          end
+
+          #
+          # Parses a fuzz pattern.
+          #
+          # @param [String] string
+          #   The string to parse.
+          #
+          # @return [Regexp, String]
+          #   The parsed pattern.
+          #
+          def parse_pattern(string)
+            case string
+            when /^\/.+\/$/
+              Regexp.new(string[1..-2])
+            when /^[a-z][a-z_]+$/
+              const = string.upcase
+
+              if (Regexp.const_defined?(const) &&
+                  Regexp.const_get(const).kind_of?(Regexp))
+                Regexp.const_get(const)
+              else
+                string
+              end
+            else
+              string
+            end
+          end
+
+          #
+          # Parses a fuzz substitution Enumerator.
+          #
+          # @param [String] string
+          #   The string to parse.
+          #
+          # @return [Enumerator]
+          #   The parsed substitution Enumerator.
+          #
+          def parse_substitution(string)
+            if string.include?('*')
+              string, lengths = string.split('*',2)
+
+              lengths = if lengths.include?('-')
+                          min, max = lengths.split('-',2)
+
+                          (min.to_i .. max.to_i)
+                        else
+                          lengths.to_i
+                        end
+
+              Fuzzing::Repeater.new(lengths).each(string)
+            else
+              Fuzzing[string]
+            end
+          end
+
+        end
+      end
+    end
+  end
+end

data/lib/ronin/ui/cli/commands/net/proxy.rb

@@ -313,6 +313,7 @@ module Ronin
                 print_data data
               end
 
+              print_info "Listening on #{@host}:#{@port} ..."
               @proxy.start
             end
 

data/lib/ronin/ui/cli/model_command.rb

@@ -61,7 +61,7 @@ module Ronin
         # @since 1.1.0
         #
         def self.each_query_option(&block)
-          return enum_for(:each_query_option) unless block
+          return enum_for(__method__) unless block
 
           self.class.ancestors.each do |ancestor|
             if ancestor < ModelCommand

data/lib/ronin/url.rb

@@ -43,8 +43,8 @@ module Ronin
     # Mapping of URL Schemes and URI classes
     SCHEMES = {
       'https' => ::URI::HTTPS,
-      'http' => ::URI::HTTP,
-      'ftp' => ::URI::FTP
+      'http'  => ::URI::HTTP,
+      'ftp'   => ::URI::FTP
     }
 
     # Primary key of the URL
@@ -100,7 +100,7 @@ module Ronin
     # @api public
     #
     def self.extract(text)
-      return enum_for(:extract,text).to_a unless block_given?
+      return enum_for(__method__,text).to_a unless block_given?
 
       ::URI.extract(text) do |uri|
         uri = begin
@@ -287,10 +287,10 @@ module Ronin
 
       # create the initial query
       query = all(
-        'scheme.name' => url.scheme,
+        'scheme.name'       => url.scheme,
         'host_name.address' => url.host,
-        :path => normalized_path(url),
-        :fragment => url.fragment
+        :path               => normalized_path(url),
+        :fragment           => url.fragment
       )
 
       if url.port
@@ -300,10 +300,10 @@ module Ronin
 
       if url.query
         # add the query params to the query
-        URI::QueryParams.parse(url.query).each do |name,value|
+        ::URI::QueryParams.parse(url.query).each do |name,value|
           query = query.all(
             'query_params.name.name' => name,
-            'query_params.value' => value 
+            'query_params.value'     => value 
           )
         end
       end
@@ -326,13 +326,13 @@ module Ronin
     #
     def self.from(uri)
       # find or create the URL scheme, host_name and port
-      scheme = URLScheme.first_or_new(:name => uri.scheme)
+      scheme    = URLScheme.first_or_new(:name => uri.scheme)
       host_name = HostName.first_or_new(:address => uri.host)
-      port = if uri.port
-               TCPPort.first_or_new(:number => uri.port)
-             end
+      port      = if uri.port
+                    TCPPort.first_or_new(:number => uri.port)
+                  end
 
-      path = normalized_path(uri)
+      path     = normalized_path(uri)
       fragment = uri.fragment
 
       query_params = []
@@ -341,7 +341,7 @@ module Ronin
         # find or create the URL query params
         uri.query_params.each do |name,value|
           query_params << {
-            :name => URLQueryParamName.first_or_new(:name => name),
+            :name  => URLQueryParamName.first_or_new(:name => name),
             :value => value
           }
         end
@@ -349,11 +349,11 @@ module Ronin
 
       # find or create the URL
       return first_or_new(
-        :scheme => scheme,
-        :host_name => host_name,
-        :port => port,
-        :path => path,
-        :fragment => fragment,
+        :scheme       => scheme,
+        :host_name    => host_name,
+        :port         => port,
+        :path         => path,
+        :fragment     => fragment,
         :query_params => query_params
       )
     end
@@ -422,7 +422,7 @@ module Ronin
         params[param.name] = param.value
       end
 
-      return URI::QueryParams.dump(params)
+      return ::URI::QueryParams.dump(params)
     end
 
     #
@@ -441,9 +441,9 @@ module Ronin
     def query_string=(query)
       self.query_params.clear
 
-      URI::QueryParams.parse(query).each do |name,value|
+      ::URI::QueryParams.parse(query).each do |name,value|
         self.query_params.new(
-          :name => URLQueryParamName.first_or_new(:name => name),
+          :name  => URLQueryParamName.first_or_new(:name => name),
           :value => value
         )
       end
@@ -478,11 +478,11 @@ module Ronin
 
       # build the URI
       return url_class.build(
-        :scheme => self.scheme.name,
-        :host => host,
-        :port => port,
-        :path => self.path,
-        :query => query,
+        :scheme   => self.scheme.name,
+        :host     => host,
+        :port     => port,
+        :path     => self.path,
+        :query    => query,
         :fragment => self.fragment
       )
     end
@@ -532,7 +532,7 @@ module Ronin
     #
     def self.normalized_path(uri)
       case uri
-      when URI::HTTP
+      when ::URI::HTTP
         # map empty HTTP paths to '/'
         unless uri.path.empty?
           uri.path

data/lib/ronin/version.rb

@@ -19,5 +19,5 @@
 
 module Ronin
   # Ronin version 
-  VERSION = '1.5.0.rc2'
+  VERSION = '1.5.0'
 end

data/man/ronin-fuzzer.1.md

@@ -0,0 +1,73 @@
+# ronin-fuzzer 1 "April 2012" Ronin "User Manuals"
+
+## SYNOPSIS
+
+`ronin fuzzer` [*options*] [*TEMPLATE*]
+
+## DESCRIPTION
+
+Fuzzes data read from a *FILE* or from `STDIN`. The fuzzed data can be written
+to output files, run in commands or sent to TCP/UDP services.
+
+## OPTIONS
+
+`-v`, `--[no-]verbose`
+  Enable verbose output.
+
+`-q`, `--[no-]quiet`
+  Disable verbose output.
+
+`--[no-]silent`
+  Silence all output.
+
+`--[no-]color`
+  Enables color output.
+
+`-i`, `--input` *FILE*
+  The input text FILE to parse. Data will be read from `STDIN` by default.
+
+`-r`, `--rule` [*PATTERN*|*/REGEXP/*|STRING]:[*METHOD*|*STRING***N*[-*M*]]
+  The rule to apply to the *INPUT*. Fuzzer rules consist of a pattern and 
+  substitution. Patterns may be one of the following:
+
+  * A name of a Ronin Regular Expression (ex: `unix_path`)
+  * A custom Regular Expression (ex: `/\d+/`)
+  * A plain String (ex: `example.com`).
+
+    Substitutions may be one of the following:
+
+  * A method from `Ronin::Fuzzing` (ex: `bad_strings`)
+  * A *STRING*, repeated *N* or *M* times (ex: `A*100-200`).
+
+`-o`, `--output` *PATH*
+  The output PATH to write the fuzzer to.
+
+`-c`, `--command` *COMMAND*
+  The command to run with the fuzzed data. All ocurrences of `#string#` will be
+  replaced with the fuzzed data, and ocurrences of `#path#` will be replaced
+  with the path to the fuzzed data.
+
+`-t`, `--tcp` *HOST*:*PORT*
+  The TCP service to send the fuzzed data to.
+
+`-u`, `--udp` *HOST*:*PORT*
+  The UDP service to send the fuzzed data to.
+
+## EXAMPLES
+
+`ronin fuzzer -i http_request.txt -o bad.txt -r unix_path:bad_strings`
+  Fuzzes a HTTP request, replacing every occurrence of a UNIX path, with
+  strings from the `bad_strings` method.
+
+## LINKS
+
+Ronin Regular Expressions
+  http://ronin-ruby.github.com/docs/ronin-support/Regexp.html
+
+`Ronin::Fuzzing`
+  http://ronin-ruby.github.com/docs/ronin-support/Ronin/Fuzzing.html
+
+## AUTHOR
+
+Postmodern <postmodern.mod3@gmail.com>
+

data/spec/installation_spec.rb

@@ -10,40 +10,18 @@ describe Installation do
     subject.libraries.should include('ronin')
   end
 
-  let(:directory) { 'lib/ronin/ui/cli/commands' }
-  let(:files) {
-    %w[
-      campaigns.rb
-      console.rb
-      creds.rb
-      database.rb
-      emails.rb
-      exec.rb
-      help.rb
-      hosts.rb
-      install.rb
-      ips.rb
-      net/proxy.rb
-      repos.rb
-      update.rb
-      urls.rb
-      uninstall.rb
-      wordlist.rb
-    ]
-  }
+  let(:directory) { 'lib/ronin/ui/cli/commands/'                }
+  let(:pattern)   { File.join(directory,'**','*.rb')            }
+  let(:paths)     { Dir[pattern]                                }
+  let(:files)     { paths.map { |path| path.sub(directory,'') } }
 
   describe "each_file" do
-    let(:pattern)  { File.join(directory,'**','*.rb') }
-    let(:expected) { files.map { |name| File.join(directory,name) } }
-
     it "should enumerate over the files which match a glob pattern" do
-      subject.each_file(pattern).to_a.should =~ expected
+      subject.each_file(pattern).to_a.should =~ paths
     end
 
     it "should return an Enumerator when no block is given" do
-      subject.each_file(pattern).all? { |file|
-        expected.include?(file)
-      }.should == true
+      subject.each_file(pattern).should respond_to(:each)
     end
   end
 
@@ -56,9 +34,7 @@ describe Installation do
     end
 
     it "should return an Enumerator when no block is given" do
-      subject.each_file_in(directory,ext).all? { |file|
-        expected.include?(file)
-      }.should == true
+      subject.each_file_in(directory,ext).should respond_to(:each)
     end
   end
 end

data/spec/ui/cli/cli_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+require 'ronin/ui/cli/cli'
+
+describe UI::CLI do
+  describe "commands" do
+    subject { described_class.commands }
+
+    it { should_not be_empty }
+
+    it "should replace '/' characters with a ':'" do
+      subject.all? { |command| command.include?('/') }.should be_false
+    end
+  end
+
+  describe "command" do
+    it "should load classes from 'ronin/ui/cli/commands/'" do
+      command = subject.command('help')
+      
+      command.name.should == 'Ronin::UI::CLI::Commands::Help'
+    end
+
+    it "should load classes from namespaces within 'ronin/ui/cli/commands/'" do
+      command = subject.command('net:proxy')
+      
+      command.name.should == 'Ronin::UI::CLI::Commands::Net::Proxy'
+    end
+
+    it "should raise UnknownCommand for unknown commands" do
+      lambda {
+        subject.command('foo')
+      }.should raise_error(described_class::UnknownCommand)
+    end
+  end
+end

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: ronin
 version: !ruby/object:Gem::Version
-  version: 1.5.0.rc2
-  prerelease: 6
+  version: 1.5.0
+  prerelease: 
 platform: ruby
 authors:
 - Postmodern
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-06-10 00:00:00.000000000 Z
+date: 2012-06-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dm-sqlite-adapter
@@ -344,7 +344,7 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.5.0.rc2
+        version: '0.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -352,7 +352,7 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.5.0.rc2
+        version: '0.5'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -429,6 +429,7 @@ executables:
 - ronin-database
 - ronin-emails
 - ronin-exec
+- ronin-fuzzer
 - ronin-help
 - ronin-hosts
 - ronin-install
@@ -462,6 +463,7 @@ files:
 - bin/ronin-database
 - bin/ronin-emails
 - bin/ronin-exec
+- bin/ronin-fuzzer
 - bin/ronin-help
 - bin/ronin-hosts
 - bin/ronin-install
@@ -561,6 +563,7 @@ files:
 - lib/ronin/ui/cli/commands/database.rb
 - lib/ronin/ui/cli/commands/emails.rb
 - lib/ronin/ui/cli/commands/exec.rb
+- lib/ronin/ui/cli/commands/fuzzer.rb
 - lib/ronin/ui/cli/commands/help.rb
 - lib/ronin/ui/cli/commands/hosts.rb
 - lib/ronin/ui/cli/commands/install.rb
@@ -596,6 +599,7 @@ files:
 - man/ronin-database.1.md
 - man/ronin-emails.1.md
 - man/ronin-exec.1.md
+- man/ronin-fuzzer.1.md
 - man/ronin-help.1.md
 - man/ronin-hosts.1.md
 - man/ronin-install.1.md
@@ -675,6 +679,7 @@ files:
 - spec/software_spec.rb
 - spec/spec_helper.rb
 - spec/ui/cli/classes/test_command.rb
+- spec/ui/cli/cli_spec.rb
 - spec/ui/cli/command_spec.rb
 - spec/url_query_param_spec.rb
 - spec/url_scheme_spec.rb
@@ -687,6 +692,7 @@ files:
 - man/ronin-database.1
 - man/ronin-emails.1
 - man/ronin-exec.1
+- man/ronin-fuzzer.1
 - man/ronin-help.1
 - man/ronin-hosts.1
 - man/ronin-install.1
@@ -697,7 +703,7 @@ files:
 - man/ronin-update.1
 - man/ronin-urls.1
 - man/ronin-wordlist.1
-homepage: http://github.com/ronin-ruby/ronin
+homepage: http://ronin-ruby.github.com/
 licenses:
 - GPL-3
 post_install_message: ! "*************************************************************************\n\n