ronin 0.3.0 → 1.0.0.pre1

data/bin/ronin-exec

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

data/bin/ronin-help

@@ -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/help'
+lib_dir = File.join(root_dir,'lib')
+$LOAD_PATH << lib_dir unless $LOAD_PATH.include?(lib_dir)
+
+require 'ronin/ui/cli/commands/help'
 
-Ronin::UI::CommandLine::Commands::Help.start
+Ronin::UI::CLI::Commands::Help.start

data/bin/ronin-hosts

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

data/bin/ronin-ips

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

data/bin/ronin-repos

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

data/bin/ronin-urls

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

data/gemspec.yml

@@ -0,0 +1,71 @@
+name: ronin
+summary: A Ruby platform for exploit development and security research.
+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.
+
+license: GPL-2
+authors: Postmodern
+email: postmodern.mod3@gmail.com
+homepage: http://github.com/ronin-ruby/ronin
+has_yard: true
+post_install_message: |
+  Thank you for installing Ronin, a Ruby platform for exploit development
+  and security research. To list the available commands:
+
+      $ ronin help
+
+  To jump into the Ronin Ruby Console:
+
+      $ ronin
+
+  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
+
+dependencies:
+  i18n: ~> 0.4.1
+  tzinfo: ~> 0.3.22
+  activesupport: ~> 3.0.0
+  # DataMapper adapters
+  dm-do-adapter: ~> 1.0.2
+  dm-sqlite-adapter: ~> 1.0.2
+  # DataMapper dependencies
+  dm-core: ~> 1.0.2
+  dm-types: ~> 1.0.2
+  dm-constraints: ~> 1.0.2
+  dm-migrations: ~> 1.0.2
+  dm-validations: ~> 1.0.2
+  dm-serializer: ~> 1.0.2
+  dm-aggregates: ~> 1.0.2
+  dm-timestamps: ~> 1.0.2
+  dm-tags: ~> 1.0.2
+  # DataMapper plugins
+  dm-is-predefined: ~> 0.3.0
+  # Library dependencies
+  uri-query_params: ~> 0.5.2
+  open_namespace: ~> 0.3.0
+  parameters: ~> 0.2.3
+  data_paths: ~> 0.2.1
+  contextify: ~> 0.2.0
+  pullr: ~> 0.1.2
+  thor: ~> 0.14.3
+  ripl: ~> 0.2.0
+  ripl-multi_line: ~> 0.2.0
+  ripl-auto_indent: ~> 0.1.0
+  ripl-short_errors: ~> 0.1.0
+  ripl-color_result: ~> 0.2.0
+  ronin-support: ~> 0.1.0
+
+development_dependencies:
+  bundler: ~> 1.0.0
+  yard: ~> 0.6.1
+  yard-contextify: ~> 0.1.0
+  yard-parameters: ~> 0.1.0
+  yard-dm: ~> 0.1.1
+  yard-dm-is-predefined: ~> 0.2.0

data/lib/ronin/address.rb

@@ -0,0 +1,93 @@
+#
+# Ronin - A Ruby platform for exploit development and security research.
+#
+# Copyright (c) 2009-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
+#
+
+require 'ronin/organization'
+require 'ronin/target'
+require 'ronin/model'
+
+require 'dm-timestamps'
+require 'dm-tags'
+
+module Ronin
+  class Address
+
+    include Model
+
+    # The primary key of the Address
+    property :id, Serial
+
+    # The class name of the Address
+    property :type, Discriminator, :required => true
+
+    # The Address
+    property :address, String, :required => true,
+                               :unique => true
+
+    # The optional organization the host belongs to
+    belongs_to :organization, :required => false
+
+    # The targets associated with the address
+    has 0..n, :targets
+
+    # The remote files associated with the address
+    has 0..n, :remote_files, :through => :targets
+
+    # The campaigns targeting the address
+    has 0..n, :campaigns, :through => :targets
+
+    # Tracks when the IP Address was first created
+    timestamps :created_at
+
+    # Tags
+    has_tags_on :tags
+
+    #
+    # Finds an address.
+    #
+    # @param [String, Integer] key
+    #   The address or index to search for.
+    #
+    # @return [Address, nil]
+    #   The found address.
+    #
+    # @since 1.0.0
+    #
+    def self.[](key)
+      if key.kind_of?(String)
+        first(:address => key)
+      else
+        super(key)
+      end
+    end
+
+    #
+    # Converts the address into a string.
+    #
+    # @return [String]
+    #   The address.
+    #
+    # @since 1.0.0
+    #
+    def to_s
+      self.address.to_s
+    end
+
+  end
+end

data/lib/ronin/arch.rb

@@ -1,7 +1,7 @@
 #
 # Ronin - A Ruby platform for exploit development and security research.
 #
-# Copyright (c) 2006-2009 Hal Brodigan (postmodern.mod3 at gmail.com)
+# 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
@@ -18,51 +18,56 @@
 # Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 #
 
-require 'ronin/extensions/meta'
-require 'ronin/extensions/string'
 require 'ronin/model'
+require 'ronin/model/has_unique_name'
 
-require 'dm-predefined'
+require 'dm-is-predefined'
 
 module Ronin
+  #
+  # Represents a Computer Architecture and pre-defines many other common
+  # architectures ({i386}, {i486}, {i686}, {i986}, {x86_64}, {ia64}, {ppc},
+  # {ppc64}, {sparc}, {sparc64}, {mips_le}, {mips_be}, {arm_le}
+  # and {arm_be}).
+  #
   class Arch
 
     include Model
-    include DataMapper::Predefined
+    include Model::HasUniqueName
+
+    is :predefined
 
     # Primary key
     property :id, Serial
 
-    # Name of the architecture
-    property :name, String
-
     # Endianness of the architecture
-    property :endian, String
+    property :endian, String, :set => ['little', 'big'], :required => true
 
     # Address length of the architecture
-    property :address_length, Integer
-
-    # Validates
-    validates_present :name, :endian, :address_length
-    validates_is_unique :name
-    validates_format :endian, :with => lambda { |endian|
-      endian == 'big' || endian == 'little'
-    }
-    validates_is_number :address_length
+    property :address_length, Integer, :required => true
 
     #
-    # Converts the architecture to a String.
+    # Splats the architecture into multiple variables.
     #
-    # @return [String]
-    #   The name of the architecture.
+    # @return [Array]
+    #   The {#endian} and {#address_length} of the architecture.
+    #
+    # @example
+    #   endian, address_length = Arch.i386
+    #   
+    #   endian
+    #   # => 'little'
+    #   address_length
+    #   # => 4
+    #
+    # @since 1.0.0
     #
-    def to_s
-      self.name.to_s
+    def to_ary
+      [self.endian, self.address_length]
     end
 
     #
-    # Defines a new builtin Arch with the specified _name_ and the given
-    # _options_.
+    # Defines a new builtin Arch.
     #
     # @param [Symbol, String] name
     #   The name of the architecture.

data/lib/ronin/author.rb

@@ -1,7 +1,7 @@
 #
 # Ronin - A Ruby platform for exploit development and security research.
 #
-# Copyright (c) 2006-2009 Hal Brodigan (postmodern.mod3 at gmail.com)
+# 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
@@ -19,24 +19,21 @@
 #
 
 require 'ronin/model'
-
-require 'rexml/document'
-require 'uri'
+require 'ronin/model/has_name'
 
 module Ronin
+  #
+  # Represents an author and any information about them or the organization
+  # which they belong to.
+  #
   class Author
 
     include Model
-
-    # Anonymouse author name
-    ANONYMOUSE = 'Anonymous'
+    include Model::HasName
 
     # Primary key of the author
     property :id, Serial
 
-    # Name of author
-    property :name, String, :index =>  true
-
     # Author's associated group
     property :organization, String
 
@@ -52,37 +49,6 @@ module Ronin
     # Author's biography
     property :biography, Text
 
-    #
-    # Creates a new Author object with the given _options_. If _block_ is
-    # given, it will be passed the newly created Author object.
-    #
-    # @param [Hash] options
-    #   Additional options.
-    #
-    # @option options [String] :name (ANONYMOUSE)
-    #   The name of the author.
-    #
-    # @option options [String] :organization
-    #   The organization the author belongs to.
-    #
-    # @option options [String] :pgp_signature
-    #   The PGP fingerprint of the author.
-    #
-    # @option options [String] :email
-    #   The email to contact the author.
-    #
-    # @option options [String] :url
-    #   The URL of the author.
-    #
-    # @option options [String] :biography
-    #   The biography of the author.
-    #
-    def initialize(options={},&block)
-      super(options)
-
-      block.call(self) if block
-    end
-
     #
     # Converts the author to a String.
     #
@@ -90,7 +56,11 @@ module Ronin
     #   The name of the author.
     #
     def to_s
-      self.name.to_s
+      if self.email
+        "#{self.name} <#{self.email}>"
+      else
+        super
+      end
     end
 
   end

data/lib/ronin/bootstrap.rb

@@ -0,0 +1,26 @@
+#
+# 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
+#
+
+require 'ronin/ronin'
+require 'ronin/config'
+require 'ronin/database'
+
+Ronin::Config.load
+Ronin::Database.setup