ronin 0.2.2 → 0.2.3

data/History.txt

@@ -1,3 +1,56 @@
+=== 0.2.3 / 2009-05-06
+
+* Require extlib >= 0.9.12.
+* Require dm-core >= 0.9.11.
+* Require data_objects >= 0.9.11.
+* Require do_sqlite3 >= 0.9.11.
+* Require dm-types >= 0.9.11.
+* Require dm-serializer >= 0.9.11.
+* Require dm-validations >= 0.9.11.
+* Require chars >= 0.1.1.
+* Require parameters >= 0.1.5.
+* No longer require dm-aggregates.
+* Added Kernel#try.
+* Added String#pad.
+* Added Array#power_set.
+* Added IPAddr#each for iterating over CIDR address ranges.
+* Added IPAddr.each for iterating over CIDR and globbed address ranges.
+* Added Net.http_powered_by that returns the HTTP X-Powered-By header.
+* Added Net.http_server that returns the HTTP Server header.
+* Added Database.setup?.
+* Added Database.update!.
+* Added Extension#exposed_methods.
+* Added ExtensionCache#names.
+* Added OverlayCache#names.
+* Added Diagnostics#print_debug.
+* Added more specs.
+* Properly escape URI::HTTP#query_params.
+* Fixed a bug in File.hexdump where the file was not being closed.
+* Fixed a bug in HasLicense#licensed_under.
+* Fixed a bug in Product#to_s.
+* Moved Ronin::Target to the ronin-exploits library.
+* Renamed Net.http_prop_path to Net.http_prop_patch.
+* Removed the Parameters code from Ronin::Sessions.
+* Replaced Ronin::Objectify with Ronin::Cacheable.
+* Removed 'ronin/models'.
+* Catch exceptions when loading Extensions and carry on.
+* Renamed Overlay#deactive! to Overlay#deactivate!.
+* Allow Overlays to automatically load the 'lib/init.rb' file when
+  activated.
+* Rewrote Ronin::Platform::ObjectCache to use the new Ronin::Cacheable
+  module.
+* Enable Diagnostic#print_info and Diagnostic#print_error by default.
+* Refactored Ronin::UI::CommandLine:
+  * Added CommandLine.get_command which loads command classes on-demand.
+  * CommandLine.commands now stores all the available command names.
+  * Renamed Ronin::UI::CommandLine::Commands::LS to
+    Ronin::UI::CommandLine::Commands::Ls.
+  * Renamed Ronin::UI::CommandLine::Commands::RM to
+    Ronin::UI::CommandLine::Commands::Rm.
+  * Moved Ronin::UI::CommandLine::ParamParser into the Parameters library.
+* Refactored specs to run on Ruby 1.9.1-p0.
+* All specs now pass on Ruby 1.9.1-p0.
+
 === 0.2.2 / 2009-03-26
 
 * Split out Ronin::Chars into the Chars library.

data/Manifest.txt

@@ -21,12 +21,15 @@ lib/ronin/static/finders.rb
 lib/ronin/extensions.rb
 lib/ronin/extensions/meta.rb
 lib/ronin/extensions/meta/object.rb
+lib/ronin/extensions/kernel.rb
+lib/ronin/extensions/array.rb
 lib/ronin/extensions/hash.rb
 lib/ronin/extensions/uri.rb
 lib/ronin/extensions/uri/query_params.rb
 lib/ronin/extensions/uri/http.rb
 lib/ronin/extensions/string.rb
 lib/ronin/extensions/file.rb
+lib/ronin/extensions/ip_addr.rb
 lib/ronin/formatting.rb
 lib/ronin/formatting/digest.rb
 lib/ronin/formatting/binary.rb
@@ -78,7 +81,6 @@ lib/ronin/network/http/exceptions/unknown_request.rb
 lib/ronin/code/emittable.rb
 lib/ronin/code/token.rb
 lib/ronin/code/reference.rb
-lib/ronin/code/reference.rb
 lib/ronin/code/symbol_table.rb
 lib/ronin/rpc.rb
 lib/ronin/rpc/exceptions.rb
@@ -91,6 +93,8 @@ lib/ronin/rpc/service.rb
 lib/ronin/rpc/console.rb
 lib/ronin/rpc/shell.rb
 lib/ronin/sessions.rb
+lib/ronin/sessions/exceptions.rb
+lib/ronin/sessions/exceptions/variable_missing.rb
 lib/ronin/sessions/session.rb
 lib/ronin/sessions/tcp.rb
 lib/ronin/sessions/udp.rb
@@ -110,14 +114,8 @@ lib/ronin/license.rb
 lib/ronin/has_license.rb
 lib/ronin/arch.rb
 lib/ronin/os.rb
-lib/ronin/target.rb
 lib/ronin/product.rb
-lib/ronin/objectify.rb
-lib/ronin/objectify/exceptions.rb
-lib/ronin/objectify/exceptions/object_context_not_found.rb
-lib/ronin/objectify/exceptions/unknown_object_context.rb
-lib/ronin/objectify/objectify.rb
-lib/ronin/models.rb
+lib/ronin/cacheable.rb
 lib/ronin/environment.rb
 lib/ronin/platform.rb
 lib/ronin/platform/tasks/spec.rb
@@ -148,7 +146,6 @@ lib/ronin/ui/command_line/exceptions.rb
 lib/ronin/ui/command_line/exceptions/unknown_command.rb
 lib/ronin/ui/command_line/command.rb
 lib/ronin/ui/command_line/options.rb
-lib/ronin/ui/command_line/param_parser.rb
 lib/ronin/ui/command_line/commands/console.rb
 lib/ronin/ui/command_line/commands/add.rb
 lib/ronin/ui/command_line/commands/install.rb
@@ -161,21 +158,27 @@ lib/ronin/ui/command_line/command_line.rb
 lib/ronin/ronin.rb
 lib/ronin/version.rb
 tasks/spec.rb
-spec/helpers.rb
 spec/spec_helper.rb
+spec/classes/licensed_model.rb
+spec/classes/cacheable_model.rb
+spec/helpers/database.rb
+spec/helpers/cacheable.rb
+spec/helpers/contexts/ronin_cacheable_model.rb
+spec/static/classes/static_class.rb
 spec/static/helpers/static1/one.txt
 spec/static/helpers/static1/dir/two.txt
 spec/static/helpers/static2/dir/two.txt
 spec/static/helpers/static.rb
-spec/static/helpers/static_class.rb
 spec/static/finders_spec.rb
 spec/static/static_spec.rb
 spec/arch_spec.rb
 spec/author_spec.rb
 spec/translators/translator_spec.rb
-spec/objectify/objectify_spec.rb
+spec/extensions/kernel_spec.rb
+spec/extensions/array_spec.rb
 spec/extensions/hash_spec.rb
 spec/extensions/string_spec.rb
+spec/extensions/ip_addr_spec.rb
 spec/extensions/uri/http_spec.rb
 spec/extensions/uri/query_params_spec.rb
 spec/formatting/binary/helpers/hexdumps.rb
@@ -201,16 +204,20 @@ spec/formatting/binary/helpers/hexdumps/od_hex_quads.txt
 spec/formatting/binary/helpers/hexdumps/od_repeated.txt
 spec/formatting/binary/integer_spec.rb
 spec/formatting/binary/string_spec.rb
-spec/formatting/digest_spec.rb
-spec/formatting/http_spec.rb
-spec/formatting/text_spec.rb
+spec/formatting/digest/string_spec.rb
+spec/formatting/http/string_spec.rb
+spec/formatting/text/string_spec.rb
+spec/code/classes/thing.rb
 spec/code/reference_spec.rb
 spec/code/symbol_table_spec.rb
 spec/license_spec.rb
+spec/has_license_spec.rb
 spec/path_spec.rb
 spec/os_spec.rb
 spec/product_spec.rb
-spec/target_spec.rb
+spec/cacheable_spec.rb
+spec/sessions/classes/test_session.rb
+spec/sessions/classes/uses_test_session.rb
 spec/sessions/session_spec.rb
 spec/platform/helpers/overlays.rb
 spec/platform/helpers/overlays.yaml.erb
@@ -219,6 +226,9 @@ spec/platform/helpers/overlays/test1/test/extension.rb
 spec/platform/helpers/overlays/test2/ronin.xml
 spec/platform/helpers/overlays/test2/test/extension.rb
 spec/platform/helpers/overlays/hello/ronin.xml
+spec/platform/helpers/overlays/hello/lib/init.rb
+spec/platform/helpers/overlays/hello/lib/stuff/test.rb
+spec/platform/helpers/overlays/hello/lib/stuff/another_test.rb
 spec/platform/helpers/overlays/hello/hello/extension.rb
 spec/platform/helpers/overlays/random/ronin.xml
 spec/platform/helpers/overlays/random/random/extension.rb
@@ -229,7 +239,5 @@ spec/platform/extension_cache_spec.rb
 spec/platform/platform_spec.rb
 spec/platform/ronin_spec.rb
 spec/ui/verbose_spec.rb
-spec/ui/command_line/helpers/example_command.rb
-spec/ui/command_line/param_parser_spec.rb
 spec/ronin_spec.rb
 static/ronin/platform/overlay.xsl

data/README.txt

@@ -48,6 +48,7 @@ of Ronin.
 * Provides convenience methods for:
   * Formatting data:
     * Binary
+    * Text
     * HTTP
     * URIs
   * Generating random text.
@@ -58,7 +59,7 @@ of Ronin.
     * POP
     * Imap
     * Telnet
-    * HTTP
+    * HTTP / HTTPS
 * Provides an IRB styled console with:
   * Tab-completion enabled.
   * Auto-indentation enabled.
@@ -69,18 +70,18 @@ of Ronin.
 * {libsqlite3}[http://sqlite.org/]
 * {nokogiri}[http://nokogiri.rubyforge.org/] >= 1.2.0
 * {DataMapper}[http://datamapper.org/]:
-  * dm-core >= 0.9.9
-  * data_objects >= 0.9.9
-  * do_sqlite3 >= 0.9.9
-  * dm-types >= 0.9.9
-  * dm-aggregates >= 0.9.9
-  * dm-validations >= 0.9.9
-  * dm-serializer >= 0.9.9
+  * extlib >= 0.9.12
+  * dm-core >= 0.9.11
+  * data_objects >= 0.9.11
+  * do_sqlite3 >= 0.9.11
+  * dm-types >= 0.9.11
+  * dm-serializer >= 0.9.11
+  * dm-validations >= 0.9.11
 * {dm-prefined}[http://dm-predefined.rubyforge.org/] >= 0.1.0
-* {parameters}[http://parameters.rubyforge.org/] >= 0.1.2
-* {contextify}[http://contextify.rubyforge.org/] >= 0.1.0
+* {parameters}[http://parameters.rubyforge.org/] >= 0.1.5
+* {contextify}[http://contextify.rubyforge.org/] >= 0.1.2
 * {reverse-require}[http://reverserequire.rubyforge.org/] >= 0.3.1
-* {repertoire}[http://repertoire.rubyforge.org/] >= 0.1.2
+* {repertoire}[http://repertoire.rubyforge.org/] >= 0.2.1
 
 == INSTALL:
 
@@ -88,14 +89,6 @@ of Ronin.
 
 == SYNOPSIS:
 
-* Generate an Overlay:
-
-    $ ronin overlay path/to/overlay/name/
-
-* Generate an Extension within an Overlay:
-
-    $ ronin ext path/to/overlay/extension/
-
 * Install an Overlay:
 
     $ ronin install svn://example.com/var/svn/overlay

data/Rakefile

@@ -11,16 +11,16 @@ Hoe.new('ronin', Ronin::VERSION) do |p|
   p.remote_rdoc_dir = 'docs/ronin'
   p.extra_deps = [
     ['nokogiri', '>=1.2.0'],
-    ['dm-core', '>=0.9.9'],
-    ['data_objects', '>=0.9.9'],
-    ['do_sqlite3', '>=0.9.9'],
-    ['dm-types', '>=0.9.9'],
-    ['dm-serializer', '>=0.9.9'],
-    ['dm-aggregates', '>=0.9.9'],
-    ['dm-validations', '>=0.9.9'],
+    ['extlib', '>=0.9.12'],
+    ['dm-core', '>=0.9.11'],
+    ['data_objects', '>=0.9.11'],
+    ['do_sqlite3', '>=0.9.11'],
+    ['dm-types', '>=0.9.11'],
+    ['dm-serializer', '>=0.9.11'],
+    ['dm-validations', '>=0.9.11'],
     ['dm-predefined', '>=0.1.0'],
-    ['chars', '>=0.1.0'],
-    ['parameters', '>=0.1.3'],
+    ['chars', '>=0.1.1'],
+    ['parameters', '>=0.1.5'],
     ['contextify', '>=0.1.2'],
     ['reverse-require', '>=0.3.1'],
     ['repertoire', '>=0.2.1']

data/TODO.txt

@@ -1,7 +1,7 @@
-== TODO
+== TODO:
 
-=== Ronin 0.3.0:
-
-* Create an IO proxy class and RPC Service for proxying io.
-* Create a module for pivoting.
+* Look into using Ronin over Tor/i2p.
+* Discuss ideas for a Web UI:
+  * Configurable menu-bar / side-bar.
+  * Sinatra would be a worthy candidate.
 

data/lib/ronin/cacheable.rb

@@ -0,0 +1,246 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2009 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/model'
+
+require 'contextify'
+
+module Ronin
+  module Cacheable
+    def self.included(base)
+      base.module_eval do
+        include Contextify
+        include Ronin::Model
+
+        # The path to the file where the object was defined in
+        property :cached_path, DataMapper::Types::FilePath
+
+        # The timestamp of the cached file
+        property :cached_timestamp, DataMapper::Types::EpochTime
+
+        #
+        # Initializes the cacheable object.
+        #
+        def initialize(*arguments,&block)
+          @original_loaded = false
+          @cache_prepared = false
+
+          super(*arguments,&block)
+        end
+
+        #
+        # Returns the first instance of the model that matches the given
+        # query _arguments_.
+        #
+        def self.first(*arguments)
+          if (obj = super(*arguments))
+            obj.instance_variable_set('@cache_prepared',true)
+          end
+
+          return obj
+        end
+
+        #
+        # Returns all instances of the model that matches the given query
+        # _arguments_.
+        #
+        def self.all(*arguments)
+          super(*arguments).each do |obj|
+            obj.instance_variable_set('@cache_prepared',true)
+          end
+        end
+
+        #
+        # Loads an object from the file at the specified _path_.
+        #
+        def self.load_from(path)
+          path = File.expand_path(path)
+          obj = self.load_context(path)
+
+          obj.instance_variable_set('@original_loaded',true)
+          obj.cached_path = path
+          obj.cached_timestamp = File.mtime(path)
+          obj.prepare_cache
+          return obj
+        end
+
+        #
+        # Caches an object from the file at the specified _path_.
+        #
+        def self.cache(path)
+          obj = self.load_from(File.expand_path(path))
+
+          obj.cache!
+          return obj
+        end
+
+        #
+        # Loads all objects with the matching _attributes_.
+        #
+        def self.load_all(attributes={})
+          self.all(attributes).map { |obj| obj.load_original }
+        end
+
+        #
+        # Loads the first object with the matching _attributes_.
+        #
+        def self.load_first(attributes={})
+          self.first(attributes).load_original!
+        end
+      end
+
+      unless Cacheable.models.include?(base)
+        Cacheable.models << base
+      end
+    end
+
+    #
+    # List of cacheable models.
+    #
+    def Cacheable.models
+      @@ronin_cacheable_models ||= []
+    end
+
+    #
+    # Loads all cacheable objects from the specified _path_. If a _block_
+    # is given, it will be passed each loaded object.
+    #
+    def Cacheable.load_all_from(path,&block)
+      path = File.expand_path(path)
+      objs = Contextify.load_contexts(path).select do |obj|
+        obj.class.include?(Cacheable)
+      end
+      
+      objs.each do |obj|
+        obj.instance_variable_set('@original_loaded',true)
+        obj.cached_path = path
+        obj.cached_timestamp = File.mtime(path)
+        obj.prepare_cache
+
+        block.call(obj) if block
+      end
+
+      return objs
+    end
+
+    #
+    # Cache all objects defined in the file at the specified _path_.
+    #
+    def Cacheable.cache_all(path)
+      path = File.expand_path(path)
+
+      Cacheable.load_all_from(path) do |obj|
+        obj.cache!
+      end
+    end
+
+    #
+    # Load the code from the cached file for the object.
+    #
+    def load_original!
+      if (self.cached_path && !(@original_loaded))
+        block = self.class.load_context_block(self.cached_path)
+
+        instance_eval(&block) if block
+        @original_loaded = true
+      end
+
+      return self
+    end
+
+    #
+    # Deletes any previously cached copies of the object and caches it into
+    # the database. Returns +true+ if the object was successfully cached,
+    # returns +false+ otherwise.
+    #
+    def cache!
+      if self.cached_path
+        # delete any existing objects
+        self.class.all(:cached_path => self.cached_path).destroy!
+
+        self.cached_timestamp = File.mtime(self.cached_path)
+        return save!
+      end
+
+      return false
+    end
+
+    #
+    # Deletes any previous cached copies of the object and caches it into
+    # the database, only if the file where the object was originally cached 
+    # from was modified. The object will also be destroyed if the file
+    # where the object was originally cached from is missing. Returns
+    # +true+ if the object was successfully synced, returns +false+
+    # otherwise.
+    #
+    def sync!
+      if (self.cached_path && self.cached_timestamp)
+        if File.file?(self.cached_path)
+          if File.mtime(self.cached_path) > self.cached_timestamp
+            self.class.cache(self.cached_path)
+          else
+            return false
+          end
+        else
+          self.destroy
+        end
+
+        return true
+      end
+
+      return false
+    end
+
+    #
+    # Prepares the object for caching.
+    #
+    def prepare_cache
+      unless @cache_prepared
+        instance_eval(&(@cache_block)) if @cache_block
+        @cache_prepared = true
+      end
+    end
+
+    protected
+
+    #
+    # Will run the specified _block_ when the object is about to be cached.
+    #
+    def cache(&block)
+      @cache_block = block
+    end
+
+    #
+    # Will load the context from the cached file and attempt to call the
+    # method again.
+    #
+    def method_missing(name,*arguments,&block)
+      unless @original_loaded
+        load_original!
+        return self.send(name,*arguments,&block)
+      else
+        return super(name,*arguments,&block)
+      end
+    end
+  end
+end