ronin 1.4.0.rc1 → 1.4.0.rc2

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

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # This file is part of Ronin.
 #
@@ -26,7 +26,22 @@ module Ronin
     module CLI
       module Commands
         #
-        # The `ronin-uninstall` command.
+        # Uninstalls Ronin {Repository Repositories}.
+        #
+        # ## Usage
+        #
+        #     ronin uninstall [options] REPO
+        #
+        # ## Options
+        #
+        #      -v, --[no-]verbose               Enable verbose output.
+        #      -q, --[no-]quiet                 Disable verbose output.
+        #          --[no-]silent                Silence all output.
+        #          --[no-]color                 Enables color output.
+        #
+        # ## Arguments
+        #
+        #       REPO                             Repository to uninstall
         #
         class Uninstall < Command
 

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

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # This file is part of Ronin.
 #
@@ -26,7 +26,22 @@ module Ronin
     module CLI
       module Commands
         #
-        # The `ronin-update` command.
+        # Updates Ronin {Repository Repositories}.
+        #
+        # ## Usage
+        #
+        #     ronin update [options] REPO
+        #
+        # ## Options
+        #
+        #      -v, --[no-]verbose               Enable verbose output.
+        #      -q, --[no-]quiet                 Disable verbose output.
+        #          --[no-]silent                Silence all output.
+        #          --[no-]color                 Enables color output.
+        #
+        # ## Arguments
+        #
+        #       REPO                             Repository to update
         #
         class Update < Command
 

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

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # This file is part of Ronin.
 #
@@ -25,12 +25,41 @@ module Ronin
     module CLI
       module Commands
         #
-        # The `ronin-urls` command.
+        # Manages {URL URLs}.
         #
-        class URLs < ResourcesCommand
+        # ## Usage
+        #
+        #     ronin urls [options]
+        #
+        # ## Options
+        #
+        #      -v, --[no-]verbose               Enable verbose output.
+        #          --[no-]quiet                 Disable verbose output.
+        #          --[no-]silent                Silence all output.
+        #          --[no-]color                 Enables color output.
+        #      -D, --database [URI]             The Database URI.
+        #          --[no-]csv                   CSV output.
+        #          --[no-]xml                   XML output.
+        #          --[no-]yaml                  YAML output.
+        #          --[no-]json                  JSON output.
+        #      -i, --import [FILE]
+        #          --[no-]http
+        #          --[no-]https
+        #      -H, --hosts [HOST [...]]
+        #      -P, --ports [PORT [...]]
+        #      -d, --directory [SUBDIR]
+        #      -q [NAME [...]],
+        #          --with-query-param
+        #      -Q [VALUE [...]],
+        #          --with-query-value
+        #      -l, --[no-]list                  Default: true
+        #
+        class Urls < ResourcesCommand
 
           model URL
 
+          summary 'Manages URLs'
+
           query_option :http, :type => true
           query_option :https, :type => true
 

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

@@ -0,0 +1,168 @@
+#
+# 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/wordlist'
+
+module Ronin
+  module UI
+    module CLI
+      module Commands
+        #
+        # Builds and/or mutates Wordlists.
+        #
+        # ## Usage
+        #
+        #     ronin wordlist [options] [TEMPLATE]
+        #
+        # ## 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]               Input file.
+        #      -o, --output [PATH]              Output wordlist file.
+        #      -m, --mutations [STRING:SUB]     Default: {}
+        #
+        # ## Arguments
+        #
+        #       TEMPLATE                         Options word template
+        #
+        # @since 1.4.0
+        #
+        class Wordlist < Command
+
+          summary 'Builds and/or mutates Wordlists'
+
+          option :input, :type => String,
+                         :flag => '-i',
+                         :usage => 'FILE',
+                         :description => 'Input file'
+
+          option :output, :type => String,
+                          :flag => '-o',
+                          :usage => 'PATH',
+                          :description => 'Output wordlist file'
+
+          option :mutations, :type    => Hash[String => Array],
+                             :default => {},
+                             :flag    => '-m',
+                             :usage   => 'STRING:SUB',
+                             :descriptions => 'Mutations rules'
+
+          argument :template, :type        => Array,
+                              :description => 'Options word template'
+
+          #
+          # Executes the wordlist command.
+          #
+          def execute
+            if (input? && template?)
+              print_error "Cannot specify --input with the TEMPLATE argument"
+              exit -1
+            end
+
+            output_stream do |output|
+              wordlist.each { |word| output.puts word }
+            end
+          end
+
+          protected
+
+          #
+          # Parses the `TEMPLATE` argument.
+          #
+          # @return [Array<String, Array<String>, (Symbol, Integer)>]
+          #   The String building template.
+          #
+          # @see http://rubydoc.info/gems/ronin-support/String#generate-class_method
+          #
+          def parse_template
+            @template.map do |char_template|
+              if char_template.include?(':')
+                charset, length = char_template.split(':',2)
+
+                # convert charset names to Symbols
+                charset = if charset.include?(',')
+                            charset.split(',')
+                          elsif Chars.const_defined?(charset.upcase)
+                            charset.to_sym
+                          else
+                            charset.to_s
+                          end
+
+                # parse the length field
+                length = if length.include?('-')
+                           min, max = length.split('-',2)
+
+                           Range.new(min.to_i,max.to_i)
+                         elsif length.include?(',')
+                           length.split(',').map(&:to_i)
+                         else
+                           length.to_i
+                         end
+
+                [charset, length]
+              else
+                char_template
+              end
+            end
+          end
+
+          #
+          # Initializes the wordlist based on the command options.
+          #
+          # @return [Ronin::Wordlist]
+          #   The new wordlist.
+          #
+          # @see http://rubydoc.info/gems/ronin-support/Ronin/Wordlist
+          #
+          def wordlist
+            if template?
+              Ronin::Wordlist.new(String.generate(*parse_template),@mutations)
+            elsif input?
+              Ronin::Wordlist.build(File.open(@input),@mutations)
+            else
+              Ronin::Wordlist.build($stdin,@mutations)
+            end
+          end
+
+          #
+          # Opens the output stream.
+          #
+          # @yield [output]
+          #   The output stream to write words to.
+          #
+          # @yieldparam [File, IO]
+          #   The output file or `STDOUT`.
+          #
+          def output_stream(&block)
+            if @output
+              File.open(@output,'w',&block)
+            else
+              yield STDOUT
+            end
+          end
+
+        end
+      end
+    end
+  end
+end

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

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # This file is part of Ronin.
 #

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

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # This file is part of Ronin.
 #

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

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # This file is part of Ronin.
 #

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

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # This file is part of Ronin.
 #

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

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # This file is part of Ronin.
 #

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

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # This file is part of Ronin.
 #

data/lib/ronin/ui/console.rb

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # This file is part of Ronin.
 #

data/lib/ronin/ui/console/commands.rb

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # This file is part of Ronin.
 #

data/lib/ronin/ui/console/console.rb

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # This file is part of Ronin.
 #

data/lib/ronin/ui/console/context.rb

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # This file is part of Ronin.
 #
@@ -56,6 +56,15 @@ module Ronin
             Ronin.send(:const_missing,name)
           end
 
+          #
+          # @note
+          #   Ruby 1.8.x requires {const_missing} to be defined as an
+          #   instance-method.
+          #
+          def const_missing(name)
+            Ronin.send(:const_missing,name)
+          end
+
           #
           # Populates the instance variables.
           #
@@ -79,11 +88,13 @@ module Ronin
           # @api semipublic
           #
           def inspect
-            body = unless instance_variables.empty?
-                     ': ' << instance_variables.map { |name|
-                       "#{name}=#{instance_variable_get(name).inspect}"
-                     }.join(', ')
-                   end
+            unless instance_variables.empty?
+              body = ':'
+
+              instance_variables.each do |name|
+                body << " #{name}=#{instance_variable_get(name).inspect}"
+              end
+            end
 
             return "#<Ronin::UI::Console#{body}>"
           end

data/lib/ronin/url.rb

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # This file is part of Ronin.
 #
@@ -502,6 +502,20 @@ module Ronin
       self.to_uri.to_s
     end
 
+    #
+    # Inspects the URL.
+    #
+    # @return [String]
+    #   The inspected URL.
+    #
+    # @since 1.4.0
+    #
+    # @api public
+    #
+    def inspect
+      "#<#{self.class}: #{self}>"
+    end
+
     protected
 
     #

data/lib/ronin/url_query_param.rb

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # This file is part of Ronin.
 #

data/lib/ronin/url_query_param_name.rb

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # This file is part of Ronin.
 #

data/lib/ronin/url_scheme.rb

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # This file is part of Ronin.
 #