ronin 1.2.0 → 1.3.0

data/.gitignore

@@ -0,0 +1,11 @@
+doc
+pkg
+vendor/cache
+Gemfile.lock
+.bundle
+.DS_Store
+.yardoc
+*.db
+*.log
+*.swp
+*~

data/ChangeLog.md

@@ -1,3 +1,21 @@
+### 1.3.0 / 2011-10-16
+
+* Require DataMapper ~> 1.2.
+* Require ronin-support ~> 0.3.
+* Added {Ronin::Model::Importable}.
+* Added {Ronin::MACAddress.extract}.
+* Added {Ronin::IPAddress.extract}.
+* Added {Ronin::HostName.extract}.
+* Added {Ronin::URL.extract}.
+* Added {Ronin::EmailAddress.extract}.
+* Renamed `license!` to `licensed_under` in
+  {Ronin::Model::HasLicense::InstanceMethods}.
+* Moved `Ronin::UI::Output`, `Ronin::UI::Shell` and `Ronin::Network::Mixins`
+  into ronin-support.
+* {Ronin::Author.site} and {Ronin::License.url} now use the URI property.
+* Merged `Ronin::UI::CLI::ModelCommand.query_model` into
+  {Ronin::UI::CLI::ModelCommand.model}.
+
 ### 1.2.0 / 2011-08-15
 
 * Require dm-is-predefined ~> 0.4.
@@ -35,11 +53,11 @@
 * Added {Ronin::URLQueryParamName}.
 * Added timestamps to {Ronin::Campaign}.
 * Added the `created_at` timestamp to {Ronin::Target}.
-* Added {Ronin::Network::Mixins::HTTP#http_status}.
-* Added {Ronin::Network::Mixins::HTTP#http_ok?}.
-* Added {Ronin::Network::Mixins::HTTP#http_server}.
-* Added {Ronin::Network::Mixins::HTTP#http_powered_by}.
-* Added `print_info` method calls to {Ronin::Network::Mixins::HTTP}.
+* Added `Ronin::Network::Mixins::HTTP#http_status`.
+* Added `Ronin::Network::Mixins::HTTP#http_ok?`.
+* Added `Ronin::Network::Mixins::HTTP#http_server`.
+* Added `Ronin::Network::Mixins::HTTP#http_powered_by`.
+* Added `print_info` method calls to `Ronin::Network::Mixins::HTTP`.
 * Added {Ronin::Script::InstanceMethods#run}.
 * Added {Ronin::Script::Exception}.
 * Added {Ronin::Script::Path#to_s}.
@@ -59,7 +77,7 @@
 * Renamed `Ronin::UI::CLI::ModelCommand.model=` to
   {Ronin::UI::CLI::ModelCommand.model}.
 * Renamed `Ronin::UI::CLI::ModelCommand#model` to
-  {Ronin::UI::CLI::ModelCommand.query_model}.
+  `Ronin::UI::CLI::ModelCommand.query_model`.
 * Renamed `Ronin::UI::CLI::ModelCommand#new_query` to
   {Ronin::UI::CLI::ModelCommand#query}.
 * Renamed `Ronin::UI::CLI::ModelCommand#print_resource` to
@@ -84,9 +102,9 @@
 * Disable {Ronin::UI::Console.short_errors?} if the `VERBOSE` environment
   variable is set.
 * Disable {Ronin::UI::Console.color?} if the `STDOUT` is a tty.
-* Set {Ronin::UI::Output.handler} to {Ronin::UI::Output::Terminal::Raw},
+* Set `Ronin::UI::Output.handler` to `Ronin::UI::Output::Terminal::Raw`,
   when `STDOUT` is not a tty.
-* Enable {Ronin::UI::Output.verbose?} if `$VERBOSE` or `$DEBUG` are set.
+* Enable `Ronin::UI::Output.verbose?` if `$VERBOSE` or `$DEBUG` are set.
 * {Ronin::UI::CLI::ModelCommand#setup} now automatically calls
   {Ronin::Database.setup}, before executing the command.
 * Merged `query_method` into {Ronin::UI::CLI::ModelCommand#query}.
@@ -150,8 +168,8 @@
 * Added {Ronin::Campaign}.
 * Added {Ronin::Target}.
 * Added `Ronin::Engine`.
-* Added {Ronin::UI::Output::Terminal::Raw}.
-* Added {Ronin::UI::Output::Terminal::Color}.
+* Added `Ronin::UI::Output::Terminal::Raw`.
+* Added `Ronin::UI::Output::Terminal::Color`.
 * Added the `ronin-repos` command for listing, adding, installing and
   uninstalling Repositories.
 * Added the `ronin-exec` command for running Ruby scripts (local files

data/Gemfile

@@ -22,7 +22,7 @@ gemspec
 # gem 'dm-timestamps',      DM_VERSION, :git => "#{DM_URI}/dm-timestamps.git"
 
 # Library dependencies
-# gem 'ronin-support',	'~> 0.2', :git => "#{RONIN_URI}/ronin-support.git"
+# gem 'ronin-support',	'~> 0.3', :git => "#{RONIN_URI}/ronin-support.git"
 
 group :development do
   gem 'rake',         '~> 0.8'

data/README.md

@@ -131,28 +131,26 @@ Remove a Database:
 * [Ruby](http://www.ruby-lang.org/) >= 1.8.7
 * [DataMapper](http://datamapper.org/):
   * [dm-sqlite-adapter](http://github.com/datamapper/dm-sqlite-adapter#readme)
-    ~> 1.1
+    ~> 1.2
     * [libsqlite3](http://sqlite.org/)
   * [dm-core](http://github.com/datamapper/dm-core#readme)
-    ~> 1.1
+    ~> 1.2
   * [dm-types](http://github.com/datamapper/dm-types#readme)
-    ~> 1.1
+    ~> 1.2
   * [dm-migrations](http://github.com/datamapper/dm-migrations#readme)
-    ~> 1.1
+    ~> 1.2
   * [dm-validations](http://github.com/datamapper/dm-validations#readme)
-    ~> 1.1
+    ~> 1.2
   * [dm-aggregates](http://github.com/datamapper/dm-aggregates#readme)
-     ~> 1.1
+     ~> 1.2
   * [dm-timestamps](http://github.com/datamapper/dm-timestamps#readme)
-    ~> 1.1
+    ~> 1.2
 * [dm-is-predefined](http://github.com/postmodern/dm-is-predefined#readme)
   ~> 0.4
 * [uri-query_params](http://github.com/postmodern/uri-query_params#readme)
   ~> 0.5, >= 0.5.2
 * [open_namespace](http://github.com/postmodern/open_namespace#readme)
   ~> 0.3
-* [parameters](http://github.com/postmodern/parameters#readme)
-  ~> 0.2, >= 0.2.3
 * [data_paths](http://github.com/postmodern/data_paths#readme)
   ~> 0.3
 * [object_loader](http://github.com/postmodern/object_loader#readme)
@@ -174,7 +172,7 @@ Remove a Database:
 * [thor](http://github.com/wycats/thor#readme)
   ~> 0.14.3
 * [ronin-support](http://github.com/ronin-ruby/ronin-support#readme)
-  ~> 0.2
+  ~> 0.3
 
 ## Install
 
@@ -182,16 +180,15 @@ Remove a Database:
 
 ## Additional Libraries
 
-### Ronin ASM
+### Ronin Gen
 
-[Ronin ASM](http://github.com/ronin-ruby/ronin-asm#readme) is a
-Ruby library for Ronin that provides dynamic Assembly (ASM) generation of
-programs or shellcode.
+[Ronin Gen](http://github.com/ronin-ruby/ronin-gen#readme) is a Ruby library
+for Ronin that provides various generators.
 
-### Ronin Dorks
+### Ronin Web
 
-[Ronin Dorks](http://github.com/ronin-ruby/ronin-dorks#readme) is a
-Ruby library for Ronin that provides support for various Google (tm) Dorks
+[Ronin Web](http://github.com/ronin-ruby/ronin-web#readme) is a Ruby library
+for Ronin that provides support for web scraping and spidering
 functionality.
 
 ### Ronin Exploits
@@ -200,36 +197,12 @@ functionality.
 Ruby library for Ronin that provides exploitation and payload crafting
 functionality.
 
-### Ronin Gen
-
-[Ronin Gen](http://github.com/ronin-ruby/ronin-gen#readme) is a Ruby library
-for Ronin that provides various generators.
-
 ### Ronin Scanners
 
 [Ronin Scanners](http://github.com/ronin-ruby/ronin-scanners#readme)
 is a Ruby library for Ronin that provides Ruby interfaces to
 various third-party security scanners.
 
-### Ronin SQL
-
-[Ronin SQL](http://github.com/ronin-ruby/ronin-sql#readme) is a Ruby library
-for Ronin that provides support for SQL related security tasks, such as
-scanning for and exploiting SQL injections.
-
-### Ronin PHP
-
-[Ronin PHP](http://github.com/ronin-ruby/ronin-php#readme) is a Ruby library
-for Ronin that provides support for PHP related security tasks, such as
-finding and exploiting Local File Inclusion (LFI) and
-Remote File Inclusion (RFI).
-
-### Ronin Web
-
-[Ronin Web](http://github.com/ronin-ruby/ronin-web#readme) is a Ruby library
-for Ronin that provides support for web scraping and spidering
-functionality.
-
 ## License
 
 Copyright (c) 2006-2011 Hal Brodigan (postmodern.mod3 at gmail.com)

data/Rakefile

@@ -68,3 +68,6 @@ DataMapper::Visualizer::Rake::GraphVizTask.new(
 
 require 'yard'
 YARD::Rake::YardocTask.new
+
+desc "Generates all documentation"
+task :docs => [:yard, 'dm:doc:graphviz']

data/gemspec.yml

@@ -26,10 +26,10 @@ post_install_message: |
     Additional functionality can be added to Ronin by installing additional
     libraries:
 
-        * ronin-asm             * ronin-php
-        * ronin-dorks           * ronin-scanners
-        * ronin-exploits        * ronin-sql
-        * ronin-gen             * ronin-web
+        * ronin-gen
+        * ronin-web
+        * ronin-exploits
+        * ronin-scanners
 
   *************************************************************************
 
@@ -37,22 +37,21 @@ required_ruby_version: ">= 1.8.7"
 
 dependencies:
   # DataMapper adapters:
-  dm-sqlite-adapter: ~> 1.1
+  dm-sqlite-adapter: ~> 1.2
   # DataMapper dependencies:
-  dm-core: ~> 1.1
-  dm-types: ~> 1.1
-  dm-constraints: ~> 1.1
-  dm-migrations: ~> 1.1
-  dm-validations: ~> 1.1
-  dm-serializer: ~> 1.1
-  dm-aggregates: ~> 1.1
-  dm-timestamps: ~> 1.1
+  dm-core: ~> 1.2
+  dm-types: ~> 1.2
+  dm-constraints: ~> 1.2
+  dm-migrations: ~> 1.2
+  dm-validations: ~> 1.2
+  dm-serializer: ~> 1.2
+  dm-aggregates: ~> 1.2
+  dm-timestamps: ~> 1.2
   # DataMapper plugins:
   dm-is-predefined: ~> 0.4
   # Library dependencies:
   uri-query_params: ~> 0.5, >= 0.5.2
   open_namespace: ~> 0.3
-  parameters: ~> 0.2, >= 0.2.3
   data_paths: ~> 0.3
   object_loader: ~> 1.0
   env: ~> 0.2
@@ -64,7 +63,7 @@ dependencies:
   ripl-color_result: ~> 0.3
   thor: ~> 0.14.3
   # Ronin dependencies:
-  ronin-support: ~> 0.2
+  ronin-support: ~> 0.3
 
 development_dependencies:
   bundler: ~> 1.0.10

data/lib/bond/completions/ronin.rb

@@ -18,11 +18,6 @@
 #
 
 require 'ronin/ui/console/commands'
-require 'ronin/address'
-require 'ronin/ip_address'
-require 'ronin/host_name'
-require 'ronin/email_address'
-require 'ronin/url'
 
 require 'set'
 require 'env'

data/lib/ronin/address.rb

@@ -57,6 +57,23 @@ module Ronin
     # Tracks when the IP Address was first created
     timestamps :created_at
 
+    #
+    # Parses the address.
+    #
+    # @param [String] address
+    #   The address to parse.
+    #
+    # @return [Address]
+    #   The parsed address.
+    #
+    # @since 1.3.0
+    #
+    # @api public
+    #
+    def self.parse(address)
+      first_or_new(:address => address)
+    end
+
     #
     # Finds an address.
     #

data/lib/ronin/author.rb

@@ -43,7 +43,7 @@ module Ronin
     property :email, String
 
     # Author's site
-    property :site, String
+    property :site, URI, :length => 256
 
     # Author's biography
     property :biography, Text

data/lib/ronin/database/database.rb

@@ -142,8 +142,13 @@ module Ronin
     #   The stream to use for the log.
     #
     # @option options [Symbol] :level
-    #   The level of messages to log.
-    #   May be either `:fatal`, `:error`, `:warn`, `:info` or `:debug`.
+    #   The level of messages to log. May one of:
+    #
+    #   * `:fatal`
+    #   * `:error`
+    #   * `:warn`
+    #   * `:info`
+    #   * `:debug`
     #
     # @return [true]
     #   Specifies that the log has been setup.
@@ -166,7 +171,7 @@ module Ronin
     #   The database repository name.
     #
     # @return [Boolean]
-    #   Specifies wether or not the Database is setup.
+    #   Specifies whether or not the Database is setup.
     #
     # @api semipublic
     #
@@ -216,6 +221,9 @@ module Ronin
         DataMapper.setup(name,uri)
       end
 
+      # finalize the Models
+      DataMapper.finalize
+
       # apply any new migrations to the database
       upgrade!
     end

data/lib/ronin/email_address.rb

@@ -17,7 +17,9 @@
 # along with Ronin.  If not, see <http://www.gnu.org/licenses/>.
 #
 
+require 'ronin/extensions/regexp'
 require 'ronin/model'
+require 'ronin/model/importable'
 require 'ronin/user_name'
 require 'ronin/host_name'
 
@@ -53,6 +55,37 @@ module Ronin
     # Validates the uniqueness of the user-name and the host-name.
     validates_uniqueness_of :user_name, :scope => [:host_name]
 
+    #
+    # Extracts email addresses from the given text.
+    #
+    # @param [String] text
+    #   The text to parse.
+    #
+    # @yield [email]
+    #   The given block will be passed each extracted email address.
+    #
+    # @yieldparam [EmailAddress] email
+    #   An extracted host-name.
+    #
+    # @return [Array<EmailAddress>]
+    #   If no block is given, an Array of email address will be returned.
+    #
+    # @see 1.3.0
+    #
+    # @api public
+    #
+    def self.extract(text)
+      return enum_for(:extract,text).to_a unless block_given?
+
+      scanner = StringScanner.new(text)
+
+      while scanner.skip_until(Regexp::EMAIL_ADDR)
+        yield parse(scanner.matched)
+      end
+
+      return nil
+    end
+
     #
     # Searches for email addresses associated with the given host names.
     #

data/lib/ronin/host_name.rb

@@ -17,11 +17,16 @@
 # along with Ronin.  If not, see <http://www.gnu.org/licenses/>.
 #
 
+require 'ronin/extensions/regexp'
+require 'ronin/extensions/resolv'
+require 'ronin/model/importable'
 require 'ronin/address'
 require 'ronin/host_name_ip_address'
-require 'ronin/url'
 require 'ronin/email_address'
+require 'ronin/url'
 
+require 'uri/generic'
+require 'strscan'
 require 'resolv'
 
 module Ronin
@@ -30,10 +35,16 @@ module Ronin
   #
   class HostName < Address
 
+    include Model::Importable
+
     # The address of the host name
     property :address, String, :length => 256,
                                :required => true,
-                               :unique => true
+                               :unique => true,
+                               :format => /^#{Regexp::HOST_NAME}$/,
+                               :messages => {
+                                 :format => 'Must be a valid host-name'
+                               }
 
     # The IP Address associations
     has 0..n, :host_name_ip_addresses, :model => 'HostNameIPAddress'
@@ -54,6 +65,37 @@ module Ronin
     # URLs that point to this host name
     has 0..n, :urls, :model => 'URL'
 
+    #
+    # Extracts host-names from the given text.
+    #
+    # @param [String] text
+    #   The text to parse.
+    #
+    # @yield [host]
+    #   The given block will be passed each extracted host-name.
+    #
+    # @yieldparam [HostName] host
+    #   An extracted host-name.
+    #
+    # @return [Array<HostName>]
+    #   If no block is given, an Array of host-names will be returned.
+    #
+    # @see 1.3.0
+    #
+    # @api public
+    #
+    def self.extract(text)
+      return enum_for(:extract,text).to_a unless block_given?
+
+      scanner = StringScanner.new(text)
+
+      while scanner.skip_until(Regexp::HOST_NAME)
+        yield parse(scanner.matched)
+      end
+
+      return nil
+    end
+
     #
     # Searches for host names associated with the given IP address(es).
     #
@@ -129,6 +171,9 @@ module Ronin
     # @param [IPAddr, String] addr
     #   The IP address to lookup.
     #
+    # @param [String] nameserver
+    #   The optional nameserver to query.
+    #
     # @return [Array<HostName>]
     #   The host names associated with the IP address.
     #
@@ -136,11 +181,13 @@ module Ronin
     #
     # @api public
     #
-    def self.lookup(addr)
+    def self.lookup(addr,nameserver=nil)
       addr = addr.to_s
       ip = IPAddress.first_or_new(:address => addr)
+
+      resolver = Resolv.resolver(nameserver)
       hosts = begin
-                Resolv.getnames(addr)
+                resolver.getnames(addr)
               rescue
                 []
               end
@@ -160,6 +207,9 @@ module Ronin
     #
     # Looks up all IP Addresses for the host name.
     #
+    # @param [String] nameserver
+    #   The optional nameserver to query.
+    #
     # @return [Array<IPAddress>]
     #   The IP Addresses for the host name.
     #
@@ -167,9 +217,10 @@ module Ronin
     #
     # @api public
     #
-    def lookup!
+    def lookup!(nameserver=nil)
+      resolver = Resolv.resolver(nameserver)
       ips = begin
-              Resolv.getaddresses(self.address)
+              resolver.getaddresses(self.address)
             rescue
               []
             end