ronin 1.1.0 → 1.2.0

data/ChangeLog.md

@@ -1,3 +1,26 @@
+### 1.2.0 / 2011-08-15
+
+* Require dm-is-predefined ~> 0.4.
+* Added {Ronin::UI::Console::Context}.
+* Added custom tab-completion to {Ronin::UI::Console} for:
+  * {Ronin::IPAddress}
+  * {Ronin::HostName}
+  * {Ronin::EmailAddress}
+  * {Ronin::URL}
+  * Paths
+  * Commands
+* Added the ability to run commands in Ronin Console, via the
+  `!command --args` syntax.
+* Added custom `!command`s to the Ronin Console:
+  * `!edit` - Edits a Ruby tempfile and loads the contents afterwards.
+  * `!cd` - Changes the current working directory and updates
+    `ENV['OLDPWD']`.
+  * `!export` - Sets `ENV` variables.
+* Added an index to {Ronin::OS.version}.
+* Refactored {Ronin::OS.predefine} using dm-is-predefined.
+* Fixed a bug in {Ronin::UI::Console.setup} where the wrong binding was
+  being passed to Ripl.
+
 ### 1.1.0 / 2011-07-04
 
 * Require env ~> 0.2.

data/README.md

@@ -72,9 +72,9 @@ Mercurial or Git.
   [ronin-support](http://github.com/ronin-ruby/ronin-support#readme).
 * Provides a customized Ruby Console with:
   * Syntax highlighting.
-  * Tab-completion enabled.
-  * Auto-indentation enabled.
-  * Pretty-Print loaded.
+  * Tab-completion.
+  * Auto-indentation.
+  * Pretty-Printing (`pp`).
   * `print_info`, `print_error`, `print_warning` and `print_debug`
     output helper methods with color-output.
 * Provides an extensible command-line interface based on
@@ -110,7 +110,7 @@ Update a specific Repositories:
 
     $ ronin repos --update repo-name
 
-Uninstall an Repositories:
+Uninstall a specific Repositories:
 
     $ ronin repos --uninstall repo-name
 
@@ -131,22 +131,22 @@ 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.0
+    ~> 1.1
     * [libsqlite3](http://sqlite.org/)
   * [dm-core](http://github.com/datamapper/dm-core#readme)
-    ~> 1.1.0
+    ~> 1.1
   * [dm-types](http://github.com/datamapper/dm-types#readme)
-    ~> 1.1.0
+    ~> 1.1
   * [dm-migrations](http://github.com/datamapper/dm-migrations#readme)
-    ~> 1.1.0
+    ~> 1.1
   * [dm-validations](http://github.com/datamapper/dm-validations#readme)
-    ~> 1.1.0
+    ~> 1.1
   * [dm-aggregates](http://github.com/datamapper/dm-aggregates#readme)
-     ~> 1.1.0
+     ~> 1.1
   * [dm-timestamps](http://github.com/datamapper/dm-timestamps#readme)
-    ~> 1.1.0
+    ~> 1.1
 * [dm-is-predefined](http://github.com/postmodern/dm-is-predefined#readme)
-  ~> 0.3, >= 0.3.1
+  ~> 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)
@@ -162,7 +162,7 @@ Remove a Database:
 * [pullr](http://github.com/postmodern/pullr#readme)
   ~> 0.1, >= 0.1.2
 * [ripl](https://github.com/cldwalker/ripl#readme)
-  ~> 0.3:
+  ~> 0.3
 * [ripl-multi_line](https://github.com/janlelis/ripl-multi_line#readme)
   ~> 0.2
 * [ripl-auto_indent](https://github.com/janlelis/ripl-auto_indent#readme)
@@ -205,6 +205,12 @@ functionality.
 [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

data/Rakefile

@@ -46,7 +46,7 @@ DataMapper::Visualizer::Rake::GraphVizTask.new(
     ronin/organization
     ronin/os_guess
     ronin/os
-    ronin/cached_file
+    ronin/script/path
     ronin/repository
     ronin/port
     ronin/service
@@ -58,6 +58,7 @@ DataMapper::Visualizer::Rake::GraphVizTask.new(
     ronin/tcp_port
     ronin/udp_port
     ronin/url_scheme
+    ronin/url_query_param_name
     ronin/url_query_param
     ronin/url
     ronin/user_name

data/gemspec.yml

@@ -13,12 +13,13 @@ 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:
+    Thank you for installing Ronin!
+
+    To list the available commands:
 
         $ ronin help
 
-    To jump into the Ronin Ruby Console:
+    To start the Ronin Console:
 
         $ ronin
 
@@ -35,20 +36,20 @@ post_install_message: |
 required_ruby_version: ">= 1.8.7"
 
 dependencies:
-  # DataMapper adapters
-  dm-sqlite-adapter: ~> 1.1.0
-  # DataMapper dependencies
-  dm-core: ~> 1.1.0
-  dm-types: ~> 1.1.0
-  dm-constraints: ~> 1.1.0
-  dm-migrations: ~> 1.1.0
-  dm-validations: ~> 1.1.0
-  dm-serializer: ~> 1.1.0
-  dm-aggregates: ~> 1.1.0
-  dm-timestamps: ~> 1.1.0
-  # DataMapper plugins
-  dm-is-predefined: ~> 0.3, >= 0.3.1
-  # Library dependencies
+  # DataMapper adapters:
+  dm-sqlite-adapter: ~> 1.1
+  # 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
+  # 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/lib/bond/completions/ronin.rb

@@ -0,0 +1,147 @@
+#
+# Copyright (c) 2006-2011 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/console/commands'
+require 'ronin/address'
+require 'ronin/ip_address'
+require 'ronin/host_name'
+require 'ronin/email_address'
+require 'ronin/url'
+
+require 'set'
+require 'env'
+
+complete(:on => /^\![a-zA-Z]\w*/) do |cmd|
+  prefix = cmd[1..-1]
+  glob   = "#{prefix}*"
+  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}"
+      end
+    end
+  end
+
+  # add the black-listed keywords last
+  Ronin::UI::Console::Commands::BLACKLIST.each do |keyword|
+    paths << "!#{keyword}" if keyword.start_with?(prefix)
+  end
+
+  paths
+end
+
+#
+# {URL} completion in the context of URLs.
+#
+# 
+#     http://www.example.com/in[TAB][TAB] => http://www.example.com/index.html
+#
+complete(:anywhere => /[a-z]+:\/\/([^:\/\?]+(:\d+)?(\/[^\?;]*(\?[^\?;]*)?)?)?/) do |url|
+  match = url.match(/([a-z]+):\/\/([^:\/\?]+)(:\d+)?(\/[^\?;]*)?(\?[^\?;]*)?/)
+
+  query = Ronin::URL.all('scheme.name' => match[1])
+
+  if match[2]
+    unless (match[4] || match[3])
+      query = query.all('host_name.address.like' => "#{match[2]}%")
+    else
+      query = query.all('host_name.address' => match[2])
+    end
+  end
+
+  if match[3]
+    query = query.all('port.number' => match[3])
+  end
+
+  if match[4]
+    unless match[5]
+      query = query.all(:path.like => "#{match[4]}%")
+    else
+      query = query.all(:path => match[4])
+    end
+  end
+
+  if match[5]
+    params = URI::QueryParams.parse(match[5][1..-1]).to_a
+
+    params[0..-2].each do |name,value|
+      query = query.all(
+        'query_params.name.name' => name,
+        'query_params.value' => value
+      )
+    end
+
+    if (param = params.last)
+      if param[1].empty?
+        query = query.all('query_params.name.name.like' => "#{param[0]}%")
+      else
+        query = query.all(
+          'query_params.name.name' => param[0],
+          'query_params.value.like' => "#{param[1]}%"
+        )
+      end
+    end
+  end
+
+  query
+end
+
+#
+# {IPAddress} completion:
+#
+#     192.168.[TAB][TAB] => 192.168.0.1
+#
+complete(:anywhere => /(\d{1,3}\.){1,3}\d{,2}/) do |addr|
+  Ronin::Address.all(:address.like => "#{addr}%")
+end
+
+#
+# {HostName} completion:
+#
+#     www.[TAB][TAB] => www.example.com
+#
+complete(:anywhere => /[a-zA-Z0-9_-]+\.[a-zA-Z0-9_-]*/) do |host|
+  Ronin::HostName.all(:address.like => "#{host}%")
+end
+
+#
+# {EmailAddress} completeion:
+#
+#     alice@[TAB][TAB] => alice@example.com
+#
+complete(:anywhere => /[a-zA-Z0-9\._-]+@[a-zA-Z0-9\._-]*/) do |email|
+  user, host = email.split('@',2)
+
+  Ronin::EmailAddress.all(
+    'user_name.name' => user,
+    'host_name.address.like' => "#{host}%"
+  )
+end
+
+#
+# Path completion.
+#
+#     /etc/pa[TAB][TAB] => /etc/passwd
+#
+complete(:anywhere => /\/([^\/]+\/)*[^\/]*/) do |path|
+  Dir["#{path}*"]
+end

data/lib/ronin/auto_load.rb

@@ -22,46 +22,48 @@ require 'open_namespace'
 module Ronin
   #
   # When included into other namespaces, it allows for auto-loading Classes
-  # or Modules via {#const_missing}.
+  # or Modules via {ClassMethods#const_missing}.
   #
   # @since 1.1.0
   #
   module AutoLoad
     def self.included(base)
       base.send :include, OpenNamespace
-      base.send :extend, self
+      base.send :extend, ClassMethods
     end
 
-    protected
+    module ClassMethods
+      protected
 
-    #
-    # Transparently auto-loads Classes and Modules from their respective
-    # files using [OpenNamespace](http://rubydoc.info/gems/open_namespace).
-    #
-    # @param [String, Symbol] name
-    #   The name of the Class or Module to auto-load.
-    #
-    # @return [Class, Module]
-    #   The loaded Class or Module.
-    #
-    # @raise [NameError]
-    #   The Class or Module could not be found.
-    #
-    # @since 1.1.0
-    #
-    # @api public
-    #
-    def const_missing(name)
-      const = super(name)
+      #
+      # Transparently auto-loads Classes and Modules from their respective
+      # files using [OpenNamespace](http://rubydoc.info/gems/open_namespace).
+      #
+      # @param [String, Symbol] name
+      #   The name of the Class or Module to auto-load.
+      #
+      # @return [Class, Module]
+      #   The loaded Class or Module.
+      #
+      # @raise [NameError]
+      #   The Class or Module could not be found.
+      #
+      # @since 1.1.0
+      #
+      # @api public
+      #
+      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
+        if Object.const_defined?('DataMapper')
+          # if the loaded Class is a DataMapper Resource, re-finalize
+          if const < DataMapper::Resource
+            DataMapper.finalize
+          end
         end
-      end
 
-      return const
+        return const
+      end
     end
   end
 end

data/lib/ronin/database/migrations/1.0.0.rb

@@ -301,6 +301,7 @@ module Ronin
           end
 
           create_index :ronin_os, :name
+          create_index :ronin_os, :version
         end
 
         down do

data/lib/ronin/model/has_authors.rb

@@ -17,5 +17,95 @@
 # along with Ronin.  If not, see <http://www.gnu.org/licenses/>.
 #
 
-require 'ronin/model/has_authors/class_methods'
-require 'ronin/model/has_authors/has_authors'
+require 'ronin/model'
+require 'ronin/author'
+
+module Ronin
+  module Model
+    #
+    # Adds an `authors` relationship between a model and the {Author} model.
+    #
+    module HasAuthors
+      #
+      # Adds the `authors` relationship and {ClassMethods} to the model.
+      #
+      # @param [Class] base
+      #   The model.
+      #
+      # @api semipublic
+      #
+      def self.included(base)
+        base.send :include, Model, InstanceMethods
+        base.send :extend, ClassMethods
+
+        base.module_eval do
+          # The authors associated with the model.
+          has 0..n, :authors, Ronin::Author, :through => DataMapper::Resource
+
+          Ronin::Author.has 0..n, self.relationship_name,
+                                  :through => DataMapper::Resource,
+                                  :model => self
+        end
+      end
+
+      #
+      # Class methods that are added when {HasAuthors} is included into a
+      # model.
+      #
+      module ClassMethods
+        #
+        # Finds all resources associated with a given author.
+        #
+        # @param [String] name
+        #   The name of the author.
+        #
+        # @return [Array<Model>]
+        #   The resources written by the author.
+        #
+        # @api public
+        #
+        def written_by(name)
+          all('authors.name.like' => "%#{name}%")
+        end
+
+        #
+        # Finds all resources associated with a given organization.
+        #
+        # @param [String] name
+        #   The name of the organization.
+        #
+        # @return [Array<Model>]
+        #   The resources associated with the organization.
+        #
+        # @api public
+        #
+        def written_for(name)
+          all('authors.organization.like' => "%#{name}%")
+        end
+      end
+
+      #
+      # Instance methods that are added when {HasAuthors} is included into a
+      # model.
+      #
+      module InstanceMethods
+        #
+        # Adds a new author to the resource.
+        #
+        # @param [Hash] attributes
+        #   Additional attributes to create the new author.
+        #
+        # @example
+        #   author :name => 'Anonymous',
+        #          :email => 'anon@example.com',
+        #          :organization => 'Anonymous LLC'
+        #
+        # @api public
+        #
+        def author(attributes)
+          self.authors.new(attributes)
+        end
+      end
+    end
+  end
+end