ronin 1.3.0 → 1.4.0.rc1

data/ChangeLog.md

@@ -1,3 +1,53 @@
+### 1.4.0 / 2012-01-01
+
+* Require open_namespace ~> 0.4.
+* Require parameters ~> 0.4.
+* Require uri-query_params ~> 0.6.
+* Require ronin-support ~> 0.4.
+* Added {Ronin::Port.parse}.
+* Added {Ronin::Port.from}.
+* Added {Ronin::EmailAddress.from}.
+* Added {Ronin::Password.parse}.
+* Added {Ronin::Model::HasUniqueName::ClassMethods#parse}.
+* Added {Ronin::Script::ClassMethods#short_name}.
+* Added {Ronin::Script::Buildable#build_failed!}.
+* Added {Ronin::Script::Path#clean}.
+* Added {Ronin::Script::Path#destroy!}.
+* Added {Ronin::UI::CLI::Printing}.
+* Added {Ronin::UI::CLI::ClassCommand}.
+* Added {Ronin::UI::CLI::ScriptCommand#setup}.
+* Re-added the `ronin install` command.
+* Re-added the `ronin uninstall` command.
+* Re-added the `ronin update` command.
+* Renamed `Ronin::URL.query_param` to {Ronin::URL.with_query_param}.
+* Renamed `Ronin::URL.query_value` to {Ronin::URL.with_query_value}.
+* Renamed `Ronin::Repository.add!` to {Ronin::Repository.add}.
+* Renamed `Ronin::Repository.install!` to {Ronin::Repository.install}.
+* Renamed `Ronin::Repository.uninstall!` to {Ronin::Repository.uninstall}.
+* Renamed `Ronin::UI::CLI::ScriptCommand#load_script` to
+  {Ronin::UI::CLI::ScriptCommand#load!}.
+* Removed `Ronin::Script::InstanceMethods#script_type` in favor of
+  {Ronin::Script::ClassMethods#short_name}.
+* Have {Ronin::AutoLoad} call `finalize` directly on the newly auto-loaded
+  model.
+* Associate {Ronin::EmailAddress} with {Ronin::Credential}.
+* Ensure that all {Ronin::Script}s have unique name/version properties.
+* Refactored {Ronin::UI::CLI::Command} to use
+  [Parameters::Options](http://rubydoc.info/gems/parameters/0.4.0/Parameters/Options)
+  from parameters 0.4.0.
+* {Ronin::UI::CLI::Command#start} now rescues and prints exceptions, then
+  exits with status `-1`.
+* {Ronin::UI::CLI::ScriptCommand} may now accept additional options for the
+  loaded script after `--`:
+
+      ronin exploit -f myexploit.rb -- --host victim.com --port 1337
+
+* Fixed a typo in the `ronin repos` command.
+* The `ronin repos` command now only lists installed Repositories.
+* `Ronin::Support` is now included into {Ronin}, making all support methods
+  accessible in the `ronin` console.
+* Allow `ronin` console commands to be prefixed with a `.`.
+
 ### 1.3.0 / 2011-10-16
 
 * Require DataMapper ~> 1.2.
@@ -70,7 +120,7 @@
 * Renamed `Ronin::Engine` to {Ronin::Script}.
 * Renamed `Ronin::Engine::Verifiable` to {Ronin::Script::Testable}.
 * Renamed `Ronin::Engine#engine_name` to
-  {Ronin::Script::InstanceMethods#script_type}.
+  `Ronin::Script::InstanceMethods#script_type`.
 * Renamed `Ronin::Engine::InstanceMethods#load_original!` to
   {Ronin::Script::InstanceMethods#load_script!}.
 * Renamed `Ronin::CachedFile` to {Ronin::Script::Path}.

data/Gemfile

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

data/README.md

@@ -13,24 +13,35 @@ Ronin is a Ruby platform for exploit development and security research.
 Ronin allows for the rapid development and distribution of code, exploits
 or payloads over many common Source-Code-Management (SCM) systems.
 
-### Hack with Ruby
+### Customized Console
 
-Ronin combines the flexibility of Ruby with countless convenience methods
-and libraries, to make Ruby usable for Offensive Security or Research work.
+Ronin provides users with a customized Ruby Console, pre-loaded with powerful
+convenience methods. In the Console one can work with data and automate
+complex tasks, with greater ease than the command-line.
 
-### Organize Your Data
+    >> File.read('data').base64_decode
 
-Ronin comes with a Database designed for Security data and accessible from
-Ruby using [DataMapper](http://datamapper.org). With Ronin, storing or
-querying IP addresses, Hosts, Ports, URLs, Passwords is as simple as a
-single line of Ruby.
+### Integrated Database
 
-### Share Code
+Ronin ships with a preconfigured Database, that one can interact with from Ruby,
+without having to write any SQL.
 
-Ronin allows sharing code with the community, or just your friends, via
-Ronin Repositories. Ronin Repositories are like lazier versions of
-[RubyGems](http://rubygems.org/), that can be hosted with SubVersion,
-Mercurial or Git.
+    >> HostName.tld('eu').urls.with_query_param('id')
+
+### Repositories
+
+Ronin supports a Repository system, allowing users to organize and share
+miscallaneous Data, Code, Exploits, Payloads, Scanners, etc.
+
+    $ ronin install git://github.com/user/exploits.git
+
+### Libraries
+
+Ronin provides libraries with additional functionality, such as
+[Exploitation](http://github.com/ronin-ruby/ronin-exploits#readme)
+and [Scanning](http://github.com/ronin-ruby/ronin-scanners#readme).
+
+    $ gem install ronin-exploits
 
 ## Features
 
@@ -148,13 +159,15 @@ Remove a Database:
 * [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
+  ~> 0.6
 * [open_namespace](http://github.com/postmodern/open_namespace#readme)
-  ~> 0.3
+  ~> 0.4
 * [data_paths](http://github.com/postmodern/data_paths#readme)
   ~> 0.3
 * [object_loader](http://github.com/postmodern/object_loader#readme)
   ~> 1.0
+* [parameters](http://github.com/postmodern/parameters#readme)
+  ~> 0.4
 * [env](http://github.com/postmodern/env#readme)
   ~> 0.2
 * [pullr](http://github.com/postmodern/pullr#readme)
@@ -169,39 +182,21 @@ Remove a Database:
   ~> 0.1
 * [ripl-color_result](https://github.com/janlelis/ripl-color_result#readme)
   ~> 0.3
-* [thor](http://github.com/wycats/thor#readme)
-  ~> 0.14.3
 * [ronin-support](http://github.com/ronin-ruby/ronin-support#readme)
-  ~> 0.3
+  ~> 0.4
 
 ## Install
 
-    $ gem install ronin
-
-## Additional Libraries
-
-### Ronin Gen
-
-[Ronin Gen](http://github.com/ronin-ruby/ronin-gen#readme) is a Ruby library
-for Ronin that provides various generators.
+### Stable
 
-### 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.
-
-### Ronin Exploits
-
-[Ronin Exploits](http://github.com/ronin-ruby/ronin-exploits#readme) is a
-Ruby library for Ronin that provides exploitation and payload crafting
-functionality.
+    $ gem install ronin
 
-### Ronin Scanners
+### Edge
 
-[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.
+    $ git clone git://github.com/ronin-ruby/ronin.git
+    $ cd ronin/
+    $ bundle install
+    $ ./bin/ronin
 
 ## License
 

data/bin/ronin-install

@@ -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/install'
+
+Ronin::UI::CLI::Commands::Install.start

data/bin/ronin-uninstall

@@ -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/uninstall'
+
+Ronin::UI::CLI::Commands::Uninstall.start

data/bin/ronin-update

@@ -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/update'
+
+Ronin::UI::CLI::Commands::Update.start

data/gemspec.yml

@@ -50,10 +50,11 @@ dependencies:
   # DataMapper plugins:
   dm-is-predefined: ~> 0.4
   # Library dependencies:
-  uri-query_params: ~> 0.5, >= 0.5.2
-  open_namespace: ~> 0.3
+  uri-query_params: ~> 0.6
+  open_namespace: ~> 0.4
   data_paths: ~> 0.3
   object_loader: ~> 1.0
+  parameters: ~> 0.4
   env: ~> 0.2
   pullr: ~> 0.1, >= 0.1.2
   ripl: ~> 0.3
@@ -61,9 +62,8 @@ dependencies:
   ripl-auto_indent: ~> 0.1
   ripl-short_errors: ~> 0.1
   ripl-color_result: ~> 0.3
-  thor: ~> 0.14.3
   # Ronin dependencies:
-  ronin-support: ~> 0.3
+  ronin-support: ~> 0.4.0.rc1
 
 development_dependencies:
   bundler: ~> 1.0.10

data/lib/bond/completions/ronin.rb

@@ -22,23 +22,24 @@ require 'ronin/ui/console/commands'
 require 'set'
 require 'env'
 
-complete(:on => /^\![a-zA-Z]\w*/) do |cmd|
-  prefix = cmd[1..-1]
-  glob   = "#{prefix}*"
+complete(:on => /^[\!\.][a-zA-Z]\w*/) do |cmd|
+  prefix = cmd[0,1]
+  name   = cmd[1..-1]
+  glob   = "#{name}*"
   paths  = Set[]
 
   # search through $PATH for similar program names
   Env.paths.each do |dir|
     Pathname.glob(dir.join(glob)) do |path|
       if (path.file? && path.executable?)
-        paths << "!#{path.basename}"
+        paths << "#{prefix}#{path.basename}"
       end
     end
   end
 
   # add the black-listed keywords last
   Ronin::UI::Console::Commands::BLACKLIST.each do |keyword|
-    paths << "!#{keyword}" if keyword.start_with?(prefix)
+    paths << "#{prefix}#{keyword}" if keyword.start_with?(name)
   end
 
   paths

data/lib/ronin/address.rb

@@ -18,8 +18,6 @@
 #
 
 require 'ronin/model'
-require 'ronin/organization'
-require 'ronin/target'
 
 require 'dm-timestamps'
 

data/lib/ronin/auto_load.rb

@@ -18,6 +18,7 @@
 #
 
 require 'open_namespace'
+require 'dm-core'
 
 module Ronin
   #
@@ -55,11 +56,9 @@ module Ronin
       def const_missing(name)
         const = super(name)
 
-        if Object.const_defined?('DataMapper')
-          # if the loaded Class is a DataMapper Resource, re-finalize
-          if const < DataMapper::Resource
-            DataMapper.finalize
-          end
+        # if the loaded Class is a DataMapper Resource, re-finalize
+        if const < DataMapper::Resource
+          const.finalize
         end
 
         return const

data/lib/ronin/campaign.rb

@@ -20,6 +20,7 @@
 require 'ronin/model'
 require 'ronin/model/has_unique_name'
 require 'ronin/model/has_description'
+require 'ronin/address'
 require 'ronin/target'
 
 require 'dm-timestamps'

data/lib/ronin/credential.rb

@@ -18,8 +18,6 @@
 #
 
 require 'ronin/model'
-require 'ronin/user_name'
-require 'ronin/password'
 
 module Ronin
   #
@@ -32,12 +30,15 @@ module Ronin
     # Primary key of the credential
     property :id, Serial
 
-    # Password of the credential
-    belongs_to :password
-
     # User name of the credential
     belongs_to :user_name
 
+    # The optional email address associated with the Credential
+    belongs_to :email_address, :required => false
+
+    # Password of the credential
+    belongs_to :password
+
     #
     # Searches for all credentials for a specific user.
     #

data/lib/ronin/database/database.rb

@@ -20,6 +20,7 @@
 require 'ronin/database/exceptions/invalid_config'
 require 'ronin/database/exceptions/unknown_repository'
 require 'ronin/database/migrations'
+require 'ronin/ronin'
 require 'ronin/config'
 
 require 'yaml'

data/lib/ronin/email_address.rb

@@ -23,6 +23,7 @@ require 'ronin/model/importable'
 require 'ronin/user_name'
 require 'ronin/host_name'
 
+require 'uri/mailto'
 require 'dm-timestamps'
 
 module Ronin
@@ -47,7 +48,7 @@ module Ronin
                              :model => 'IPAddress'
 
     # Any web credentials that are associated with the email address.
-    has 0..n, :web_credentials
+    has 0..n, :credentials
 
     # Tracks when the email address was created at.
     timestamps :created_at
@@ -153,7 +154,7 @@ module Ronin
     #
     # @api public
     #
-    def EmailAddress.parse(email)
+    def self.parse(email)
       user, host = email.split('@',2)
 
       user.strip!
@@ -168,12 +169,36 @@ module Ronin
         raise("email address #{email.dump} must have a host name")
       end
 
-      return EmailAddress.first_or_new(
+      return first_or_new(
         :user_name => UserName.first_or_new(:name => user),
         :host_name => HostName.first_or_new(:address => host)
       )
     end
 
+    #
+    # Creates a new Email Address.
+    #
+    # @param [URI::MailTo, #to_s] email
+    #   The URI or String to create the Email Address from.
+    #
+    # @return [EmailAddress]
+    #   The new Email Address.
+    #
+    # @since 1.4.0
+    #
+    # @api public
+    #
+    def self.from(email)
+      email = case email
+              when URI::MailTo
+                email.to
+              else
+                email.to_s
+              end
+
+      return parse(email)
+    end
+
     #
     # The user of the email address.
     #