ronin 0.3.0 → 1.0.0.pre1

data/.document

@@ -0,0 +1,4 @@
+lib/**/*.rb
+- 
+ChangeLog.md
+COPYING.txt

data/.rspec

@@ -0,0 +1 @@
+--colour --format documentation

data/.yardopts

@@ -0,0 +1,5 @@
+--markup markdown --title 'Ronin Documentation' --protected
+--plugin yard-contextify
+--plugin yard-parameters
+--plugin yard-dm
+--plugin yard-dm-is-predefined

data/{History.txt → ChangeLog.md}

@@ -1,4 +1,4 @@
-=== 0.3.0 / 2009-09-24
+### 0.3.0 / 2009-09-24
 
 * Require yard >= 0.2.3.5.
 * Require nokogiri >= 1.3.3.
@@ -31,7 +31,7 @@
 * Added Ronin::Model#humanize_attributes.
 * Added Ronin::Model::HasVersion.revision.
 * Added Ronin::Templates::Template.
-* Added Ronin::Platform::Overlays#gems.
+* Added Ronin::Platform::Overlay#gems.
 * Added attr_reader, attr_writer and attr_accessor instance methods to
   Ronin::Platform::Extension.
 * Added Ronin::Platform::Overlay#load!.
@@ -93,7 +93,7 @@
 * Include Ronin::UI::Output::Helpers into Ronin::Sessions::Session.
 * Include Ronin::UI::Output::Helpers into Ronin::Console sessions.
 
-=== 0.2.4 / 2009-07-02
+### 0.2.4 / 2009-07-02
 
 * Require Hoe >= 2.0.0
 * Require Parameters >= 0.1.6.
@@ -135,7 +135,7 @@
   * Cleaned up CSS.
   * Removed the jQuery expander plugin.
 
-=== 0.2.3 / 2009-05-06
+### 0.2.3 / 2009-05-06
 
 * Require extlib >= 0.9.12.
 * Require dm-core >= 0.9.11.
@@ -189,7 +189,7 @@
 * Added more specs.
 * All specs now pass on Ruby 1.9.1-p0.
 
-=== 0.2.2 / 2009-03-26
+### 0.2.2 / 2009-03-26
 
 * Split out Ronin::Chars into the Chars library.
 * Split out ronin-overlay and ronin-ext sub-commands into the Ronin Gen
@@ -214,7 +214,7 @@
 * Added the ExtensionCache#reload! method.
 * Added more specs.
 
-=== 0.2.1 / 2009-02-23
+### 0.2.1 / 2009-02-23
 
 * Added Ronin::UI::Verbose.
 * Require Nokogiri >= 1.2.0:
@@ -238,7 +238,7 @@
 === 0.2.0 / 2009-02-06
 
 * Moved the HTML formatting methods into the
-  {ronin-html}[http://ronin.rubyforge.org/html/] library.
+  [ronin-html](http://ronin.rubyforge.org/html/) library.
 * Added 'ronin/environment' which loads the Ronin Environment.
 * Added the --database option to the DefaultCommand.
 * Added the -C option to the add, install, list, update, remove and
@@ -280,12 +280,12 @@
     * Renamed Extension#perform_teardown to Extension#teardown!.
   * Removed un-used or surpurfulous methods.
   * Removed 'lib/ronin/platform/config.rb'.
-  * Allow Overlays to have their own <tt>lib/</tt> directories.
+  * Allow Overlays to have their own `lib/` directories.
   * Many bug fixes.
 * Updated the README.txt.
 * Fixed bug in UI::Console.auto_load and UI::Console.start.
 
-=== 0.1.4 / 2009-01-22
+### 0.1.4 / 2009-01-22
 
 * Moved Ronin::Web and Ronin::Sessions::Web into the ronin-web library.
 * Removed dependencies to hpricot, mechanize, spidr and rack.
@@ -303,7 +303,7 @@
 * Automatically load 'ronin/ui/hexdump' when starting the
   Ronin::UI::Console.
 
-=== 0.1.3 / 2009-01-08
+### 0.1.3 / 2009-01-08
 
 * Moved Context into the Contextify library.
 * Require dm-core >= 0.9.9.
@@ -318,7 +318,7 @@
   data through a TCP connection then closing it.
 * Added Ronin::UI::CommandLine::ParamParser for parsing command-line
   options into a Hash of parameters.
-* Automatically create the <tt>~/.ronin/config/</tt> directory.
+* Automatically create the `~/.ronin/config/` directory.
 * Refactored Ronin::Objectify and how it uses primary keys.
 * All Ronin::Session mixins use standard naming conventions for defining
   the 'host' and 'port' parameters.
@@ -331,7 +331,7 @@
 * Added more specs.
 * Added more documentation.
 
-=== 0.1.2 / 2008-12-10
+### 0.1.2 / 2008-12-10
 
 * Require do_sqlite3 >= 0.9.9, since version 0.9.8 was totally broken.
 * Require reverse-require >= 0.2.0, for improved performance.
@@ -375,7 +375,7 @@
 * Added even more specs.
 * More typo and documentation fixes.
 
-=== 0.1.1 / 2008-10-26
+### 0.1.1 / 2008-10-26
 
 * Depend on the newly renamed reverse-require (>= 0.1.2) gem.
 * Added Ronin::Code::SymbolTable for DSLs to make use of.
@@ -388,7 +388,7 @@
 * Removed the Ronin::Runner namespace, renaming the Ronin::Runner::Program
   namespace to Ronin::Program.
 
-=== 0.1.0 / 2008-09-28
+### 0.1.0 / 2008-09-28
 
 * Changed how Sessions are setup.
 * Have Ronin use it's own DataMapper Repository name-space to avoid
@@ -397,7 +397,7 @@
 * Added specs.
 * Fixed various trivial bugs.
 
-=== 0.0.9 / 2008-08-20
+### 0.0.9 / 2008-08-20
 
 * Initial release.
 * Supports installing/updating/uninstalling of Overlays.

data/Gemfile

@@ -0,0 +1,42 @@
+source 'https://rubygems.org'
+
+DATA_MAPPER = 'http://github.com/datamapper'
+DM_VERSION = '~> 1.0.2'
+RONIN = 'http://github.com/ronin-ruby'
+
+gemspec
+
+# Library dependencies
+# gem 'ronin-support',	'~> 0.1.0', :git => "#{RONIN}/ronin-support.git"
+
+group :development do
+  gem 'rake',         '~> 0.8.7'
+
+  platforms :jruby do
+    gem 'maruku',     '~> 0.6.0'
+  end
+
+  platforms :ruby do
+    gem 'rdiscount',  '~> 1.6.3'
+  end
+
+  gem 'ruby-graphviz',		      '~> 0.9.10'
+  gem 'dm-visualizer',		      '~> 0.1.0'
+
+  gem 'ore-core',     '~> 0.1.0'
+  gem 'ore-tasks',    '~> 0.2.0'
+  gem 'rspec',        '~> 2.0.0'
+end
+
+group :test do
+  adapters = (ENV['ADAPTER'] || ENV['ADAPTERS'])
+  adapters = adapters.to_s.gsub(',',' ').split(' ') - ['in_memory']
+
+  DM_ADAPTERS = %w[sqlite3 postgres mysql oracle sqlserver]
+
+  unless (DM_ADAPTERS & adapters).empty?
+    adapters.each do |adapter|
+      gem "dm-#{adapter}-adapter", DM_VERSION, :git => "#{DATA_MAPPER}/dm-#{adapter}-adapter.git"
+    end
+  end
+end

data/README.md

@@ -0,0 +1,224 @@
+# Ronin
+
+* [Website](http://ronin-ruby.github.com)
+* [Source](http://github.com/ronin-ruby/ronin)
+* [Issues](http://github.com/ronin-ruby/ronin/issues)
+* [Documentation](http://rubydoc.info/github/ronin-ruby/ronin/frames)
+* [Mailing List](http://groups.google.com/group/ronin-ruby)
+* irc.freenode.net #ronin
+
+## Description
+
+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.
+
+### Ruby
+
+Ronin's Ruby environment allows security researchers to leverage Ruby with
+ease. The Ruby environment contains a multitude of convenience methods
+for working with data in Ruby, a Ruby Object Database, a customized Ruby
+Console and an extendable command-line interface.
+
+### Extend
+
+Ronin's more specialized features are provided by additional Ronin
+libraries, which users can choose to install. These libraries can allow
+one to write and run Exploits and Payloads, scan for PHP vulnerabilities,
+perform Google Dorks  or run 3rd party scanners.
+
+### Publish
+
+Ronin allows users to publish and share code, exploits, payloads or other
+data via Ronin Repositories. Repositories are directories of code and data
+that can be hosted on any SVN, Hg, Git or Rsync server. Ronin makes it easy
+to create, install and update Repositories.
+
+## Features
+
+* Supports installing/updating/uninstalling of Repositories.
+  * Supports installing Repositories from various media types:
+    * [Subversion (SVN)](http://subversion.tigris.org/)
+    * [Mercurial (Hg)](http://mercurial.selenic.com/)
+    * [Git](http://git-scm.com/)
+    * Rsync
+* Provides Object Database using [DataMapper](http://datamapper.org)
+  with:
+  * {Ronin::Author}
+  * {Ronin::License}
+  * {Ronin::Arch}
+  * {Ronin::OS}
+  * {Ronin::Software}
+  * {Ronin::Vendor}
+  * {Ronin::Address}
+    * {Ronin::MACAddress}
+    * {Ronin::IPAddress}
+    * {Ronin::HostName}
+  * {Ronin::Port}
+    * {Ronin::TCPPort}
+    * {Ronin::UDPPort}
+  * {Ronin::Service}
+  * {Ronin::OpenPort}
+  * {Ronin::OSGuess}
+  * {Ronin::UserName}
+  * {Ronin::URL}
+  * {Ronin::EmailAddress}
+  * {Ronin::Credential}
+  * {Ronin::ServiceCredential}
+  * {Ronin::WebCredential}
+  * {Ronin::Organization}
+  * {Ronin::Campaign}
+  * {Ronin::Target}
+* Caches exploits, payloads, scanners, etc stored within Repositories
+  into the Database.
+* Convenience methods provided by
+  [ronin-support](http://github.com/ronin-ruby/ronin-support#readme).
+* Provides a customized Ruby Console with:
+  * Tab-completion enabled.
+  * Auto-indentation enabled.
+  * Pretty-Print loaded.
+  * `print_info`, `print_error`, `print_warning` and `print_debug`
+    output helper methods with color-output.
+* Provides an extendable command-line interface based on
+  [Thor](http://github.com/wycats/thor#readme).
+
+## Synopsis
+
+Start the Ronin console:
+
+    $ ronin
+
+Run a Ruby script in Ronin:
+
+    $ ronin exec script.rb
+
+View available commands:
+
+    $ ronin help
+
+Install a Repository:
+
+    $ ronin repos --install svn://example.com/path/to/repo
+
+List installed Repositories:
+
+    $ ronin repos
+
+Update all installed Repositories:
+
+    $ ronin repos --update
+
+Update a specific Repositories:
+
+    $ ronin repos --update repo-name
+
+Uninstall an Repositories:
+
+    $ ronin repos --uninstall repo-name
+
+List available Databases:
+
+    $ ronin database
+
+Add a new Database:
+
+    $ ronin database --add team --uri mysql://user:pass@vpn.example.com/db
+
+Remove a Database:
+
+    $ ronin database --remove team
+
+## Requirements
+
+* [Ruby](http://www.ruby-lang.org/) >= 1.8.7
+* [ActiveSupport](http://rubygems.org/gems/activesupport) >= 3.0.0
+* [DataMapper](http://datamapper.org/):
+  * [dm-do-adapter](http://github.com/datamapper/dm-do-adapter) ~> 1.0.2
+  * [dm-sqlite-adapter](http://github.com/datamapper/dm-sqlite-adapter)
+    ~> 1.0.2
+    * [libsqlite3](http://sqlite.org/)
+  * [dm-core](http://github.com/datamapper/dm-core) ~> 1.0.2
+  * [dm-types](http://github.com/datamapper/dm-types) ~> 1.0.2
+  * [dm-migrations](http://github.com/datamapper/dm-migrations) ~> 1.0.2
+  * [dm-validations](http://github.com/datamapper/dm-validations) ~> 1.0.2
+  * [dm-aggregates](http://github.com/datamapper/dm-aggregates) ~> 1.0.2
+  * [dm-timestamps](http://github.com/datamapper/dm-timestamps) ~> 1.0.2
+  * [dm-tags](http://github.com/datamapper/dm-tags) ~> 1.0.2
+* [dm-is-predefined](http://github.com/postmodern/dm-is-predefined/)
+  ~> 0.3.0
+* [uri-query_params](http://github.com/postmodern/uri-query_params) ~> 0.4.0
+* [open_namespace](http://github.com/postmodern/open_namespace) ~> 0.3.0
+* [parameters](http://github.com/postmodern/parameters) ~> 0.2.2
+* [data_paths](http://github.com/postmodern/data_paths) ~> 0.2.1
+* [contextify](http://github.com/postmodern/contextify/) ~> 0.1.6
+* [pullr](http://github.com/postmodern/pullr/) ~> 0.1.2
+* [thor](http://github.com/wycats/thor/) ~> 0.14.2
+* [ronin-support](http://github.com/ronin-ruby/ronin-support/) ~> 0.1.0
+
+## Install
+
+    $ sudo gem install ronin
+
+## Additional Libraries
+
+### Ronin ASM
+
+[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 Dorks
+
+[Ronin Dorks](http://github.com/ronin-ruby/ronin-dorks#readme) is a
+Ruby library for Ronin that provides support for various Google (tm) Dorks
+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.
+
+### Ronin Gen
+
+[Ronin Gen](http://github.com/ronin-ruby/ronin-gen#readme) is a Ruby library
+for Ronin that provides various generators.
+
+### Ronin SQL
+
+[Ronin SQL](http://github.com/ronin-ruby/ronin-sql#readme) is a Ruby library
+for Ronin that provids 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
+
+Ronin - A Ruby platform for exploit development and security research.
+
+Copyright (c) 2006-2010 Hal Brodigan (postmodern.mod3 at gmail.com)
+
+This program 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 2 of the License, or
+(at your option) any later version.
+
+This program 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 this program; if not, write to the Free Software
+Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

data/Rakefile

@@ -1,38 +1,70 @@
-# -*- ruby -*-
-
 require 'rubygems'
-require 'hoe'
-require 'hoe/signing'
-require './tasks/spec.rb'
-require './tasks/yard.rb'
-
-Hoe.spec('ronin') do
-  self.rubyforge_name = 'ronin'
-  self.developer('Postmodern','postmodern.mod3@gmail.com')
-  self.remote_rdoc_dir = 'docs/ronin'
-  self.extra_deps = [
-    ['yard', '>=0.2.3.5'],
-    ['nokogiri', '>=1.3.3'],
-    ['extlib', '>=0.9.13'],
-    ['data_objects', '>=0.10.0'],
-    ['do_sqlite3', '>=0.10.0'],
-    ['dm-core', '>=0.10.0'],
-    ['dm-types', '>=0.10.0'],
-    ['dm-validations', '>=0.10.0'],
-    ['dm-predefined', '>=0.2.0'],
-    ['chars', '>=0.1.2'],
-    ['parameters', '>=0.1.8'],
-    ['contextify', '>=0.1.3'],
-    ['reverse-require', '>=0.3.1'],
-    ['repertoire', '>=0.2.3'],
-    ['thor', '>=0.11.5']
-  ]
 
-  self.extra_dev_deps = [
-    ['rspec', '>=1.1.12']
-  ]
+begin
+  require 'bundler'
+rescue LoadError => e
+  STDERR.puts e.message
+  STDERR.puts "Run `gem install bundler` to install Bundler."
+  exit e.status_code
+end
 
-  self.spec_extras = {:has_rdoc => 'yard'}
+begin
+  Bundler.setup(:development)
+rescue Bundler::BundlerError => e
+  STDERR.puts e.message
+  STDERR.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
 end
 
-# vim: syntax=Ruby
+require 'rake'
+
+require 'ore/tasks'
+Ore::Tasks.new
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new
+task :default => :spec
+
+require 'dm-visualizer/rake/graphviz_task'
+DataMapper::Visualizer::Rake::GraphVizTask.new(
+  :bundle => [:default],
+  :include => %w[lib],
+  :require => %w[
+    ronin/arch
+    ronin/address
+    ronin/author
+    ronin/campaign
+    ronin/comment
+    ronin/country
+    ronin/credential
+    ronin/email_address
+    ronin/host_name_ip_address
+    ronin/host_name
+    ronin/ip_address_mac_address
+    ronin/ip_address
+    ronin/license
+    ronin/mac_address
+    ronin/open_port
+    ronin/organization
+    ronin/os_guess
+    ronin/os
+    ronin/cached_file
+    ronin/repository
+    ronin/port
+    ronin/service
+    ronin/service_credential
+    ronin/web_credential
+    ronin/software
+    ronin/target
+    ronin/tcp_port
+    ronin/udp_port
+    ronin/url_scheme
+    ronin/url_query_param
+    ronin/url
+    ronin/user_name
+    ronin/vendor
+  ]
+)
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/bin/ronin

@@ -2,11 +2,24 @@
 
 require 'rubygems'
 
-lib_dir = File.expand_path(File.join(File.dirname(__FILE__),'..','lib'))
-unless $LOAD_PATH.include?(lib_dir)
-  $LOAD_PATH << lib_dir
+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
+      STDERR.puts e.message
+      STDERR.puts "Run `bundle install` to install missing gems"
+      exit e.status_code
+    end
+  end
 end
 
-require 'ronin/ui/command_line'
+lib_dir = File.join(root_dir,'lib')
+$LOAD_PATH << lib_dir unless $LOAD_PATH.include?(lib_dir)
+
+require 'ronin/ui/cli'
 
-Ronin::UI::CommandLine.start
+Ronin::UI::CLI.start

data/bin/ronin-campaigns

@@ -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
+      STDERR.puts e.message
+      STDERR.puts "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/campaigns'
+
+Ronin::UI::CLI::Commands::Campaigns.start

data/bin/ronin-console

@@ -2,11 +2,24 @@
 
 require 'rubygems'
 
-lib_dir = File.expand_path(File.join(File.dirname(__FILE__),'..','lib'))
-unless $LOAD_PATH.include?(lib_dir)
-  $LOAD_PATH << lib_dir
+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
+      STDERR.puts e.message
+      STDERR.puts "Run `bundle install` to install missing gems"
+      exit e.status_code
+    end
+  end
 end
 
-require 'ronin/ui/command_line/commands/console'
+lib_dir = File.join(root_dir,'lib')
+$LOAD_PATH << lib_dir unless $LOAD_PATH.include?(lib_dir)
+
+require 'ronin/ui/cli/commands/console'
 
-Ronin::UI::CommandLine::Commands::Console.start
+Ronin::UI::CLI::Commands::Console.start

data/bin/ronin-creds

@@ -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
+      STDERR.puts e.message
+      STDERR.puts "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/creds'
+
+Ronin::UI::CLI::Commands::Creds.start

data/bin/ronin-database

@@ -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
+      STDERR.puts e.message
+      STDERR.puts "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/database'
+
+Ronin::UI::CLI::Commands::Database.start

data/bin/ronin-emails

@@ -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
+      STDERR.puts e.message
+      STDERR.puts "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/emails'
+
+Ronin::UI::CLI::Commands::Emails.start