ronin 0.1.4 → 0.2.0

data/History.txt

@@ -1,3 +1,53 @@
+=== 0.2.0 / 2009-02-06
+
+* Moved the HTML formatting methods into the
+  {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
+  uninstall commands.
+* Added String#hex_escape.
+* Added Net.http_ok?.
+* Added UI::Diagnostics.
+* Require Contextify >= 0.1.2 for the self.load_context_block method.
+* Renamed Platform to Ronin::OS.
+* Renamed Cache to Ronin::Platform.
+* Refactored Ronin::Platform:
+  * Added Overlay#activate!.
+  * Added Overlay#deactivate!.
+  * Added a title attribute to Ronin::Platform::Overlay.
+  * Added a dirty flag to Ronin::Platform::OverlayCache to reduce
+    unnecessary writes.
+  * Added OverlayCache#has_extension?.
+  * Added Ronin::Platform::ObjectCache to handle the mass caching/mirroring
+    of object contexts.
+  * Added Platform.add.
+  * Added Platform.install.
+  * Added Platform.update.
+  * Added Platform.remove.
+  * Added Platform.uninstall.
+  * Added Platform::Extension#find_paths.
+  * Added specs for:
+    * Ronin::Platform.
+    * Ronin::Platform::Overlay.
+    * Ronin::Platform::OverlayCache.
+    * Ronin::Platform::Extension.
+    * Ronin::Platform::ExtensionCache.
+  * Shortened method names.
+    * Renamed OverlayCache#has_overlay? to OverlayCache#has?.
+    * Renamed OverlayCache#get_overlay to OverlayCache#get.
+    * Renamed OverlayCache#overlay_with to OverlayCache#with.
+    * Renamed Extension#was_setup? to Extension#setup?.
+    * Renamed Extension#was_toredown? to Extension#toredown?.
+    * Renamed Extension#perform_setup to Extension#setup!.
+    * 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.
+  * Many bug fixes.
+* Updated the README.txt.
+* Fixed bug in UI::Console.auto_load and UI::Console.start.
+
 === 0.1.4 / 2009-01-22
 
 * Moved Ronin::Web and Ronin::Sessions::Web into the ronin-web library.

data/Manifest.txt

@@ -20,7 +20,6 @@ lib/ronin/formatting.rb
 lib/ronin/formatting/digest.rb
 lib/ronin/formatting/binary.rb
 lib/ronin/formatting/text.rb
-lib/ronin/formatting/html.rb
 lib/ronin/formatting/http.rb
 lib/ronin/formatting/extensions.rb
 lib/ronin/formatting/extensions/digest.rb
@@ -30,8 +29,6 @@ lib/ronin/formatting/extensions/binary/integer.rb
 lib/ronin/formatting/extensions/binary/string.rb
 lib/ronin/formatting/extensions/text.rb
 lib/ronin/formatting/extensions/text/string.rb
-lib/ronin/formatting/extensions/html.rb
-lib/ronin/formatting/extensions/html/string.rb
 lib/ronin/formatting/extensions/http.rb
 lib/ronin/formatting/extensions/http/string.rb
 lib/ronin/chars.rb
@@ -104,7 +101,7 @@ lib/ronin/author.rb
 lib/ronin/license.rb
 lib/ronin/has_license.rb
 lib/ronin/arch.rb
-lib/ronin/platform.rb
+lib/ronin/os.rb
 lib/ronin/target.rb
 lib/ronin/product.rb
 lib/ronin/objectify.rb
@@ -113,20 +110,22 @@ 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/cache.rb
-lib/ronin/cache/exceptions.rb
-lib/ronin/cache/exceptions/extension_not_found.rb
-lib/ronin/cache/exceptions/overlay_cached.rb
-lib/ronin/cache/exceptions/overlay_not_found.rb
-lib/ronin/cache/overlay_cache.rb
-lib/ronin/cache/maintainer.rb
-lib/ronin/cache/overlay.rb
-lib/ronin/cache/config.rb
-lib/ronin/cache/extension_cache.rb
-lib/ronin/cache/extension.rb
-lib/ronin/cache/cache.rb
-lib/ronin/cache/ronin.rb
+lib/ronin/environment.rb
+lib/ronin/platform.rb
+lib/ronin/platform/exceptions.rb
+lib/ronin/platform/exceptions/extension_not_found.rb
+lib/ronin/platform/exceptions/overlay_cached.rb
+lib/ronin/platform/exceptions/overlay_not_found.rb
+lib/ronin/platform/maintainer.rb
+lib/ronin/platform/overlay.rb
+lib/ronin/platform/overlay_cache.rb
+lib/ronin/platform/object_cache.rb
+lib/ronin/platform/extension_cache.rb
+lib/ronin/platform/extension.rb
+lib/ronin/platform/platform.rb
+lib/ronin/platform/ronin.rb
 lib/ronin/ui.rb
+lib/ronin/ui/diagnostics.rb
 lib/ronin/ui/hexdump.rb
 lib/ronin/ui/hexdump/hexdump.rb
 lib/ronin/ui/hexdump/extensions.rb
@@ -170,17 +169,30 @@ spec/extensions/uri/query_params_spec.rb
 spec/formatting/binary/integer_spec.rb
 spec/formatting/binary/string_spec.rb
 spec/formatting/digest_spec.rb
-spec/formatting/html_spec.rb
 spec/formatting/http_spec.rb
 spec/formatting/text_spec.rb
 spec/code/reference_spec.rb
 spec/code/symbol_table_spec.rb
 spec/license_spec.rb
 spec/path_spec.rb
-spec/platform_spec.rb
+spec/os_spec.rb
 spec/product_spec.rb
 spec/target_spec.rb
 spec/sessions/session_spec.rb
+spec/platform/helpers/overlays.rb
+spec/platform/helpers/overlays.yaml.erb
+spec/platform/helpers/overlays/test1/ronin.xml
+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/hello/extension.rb
+spec/platform/extension_spec.rb
+spec/platform/overlay_cache_spec.rb
+spec/platform/extension_cache_spec.rb
+spec/platform/platform_spec.rb
+spec/platform/ronin_spec.rb
+spec/ui/diagnostics_spec.rb
 spec/ui/command_line/param_parser_spec.rb
 spec/ronin_spec.rb
 static/overlay.xsl

data/README.txt

@@ -51,7 +51,6 @@ of Ronin.
     * Binary
     * HTTP
     * URIs
-    * HTML
   * Generating random text.
   * Networking:
     * TCP
@@ -68,7 +67,8 @@ of Ronin.
 
 == REQUIREMENTS:
 
-* DataMapper:
+* {libsqlite3}[http://sqlite.org/]
+* {DataMapper}[http://datamapper.org/]:
   * dm-core >= 0.9.9
   * data_objects >= 0.9.9
   * do_sqlite3 >= 0.9.9
@@ -76,11 +76,11 @@ of Ronin.
   * dm-aggregates >= 0.9.9
   * dm-validations >= 0.9.9
   * dm-serializer >= 0.9.9
-* dm-prefined >= 0.1.0
-* parameters >= 0.1.2
-* contextify >= 0.1.0
-* reverse-require >= 0.3.1
-* repertoire >= 0.1.2
+* {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
+* {reverse-require}[http://reverserequire.rubyforge.org/] >= 0.3.1
+* {repertoire}[http://repertoire.rubyforge.org/] >= 0.1.2
 
 == INSTALL:
 
@@ -122,55 +122,63 @@ of Ronin.
 
 == RONIN LIBRARIES:
 
-=== RONIN ASM
+=== Ronin ASM
 
-* http://ronin.rubyforge.org/libraries/asm.html
+* http://ronin.rubyforge.org/asm/
 * http://github.com/postmodern/ronin-asm
 
 Ronin ASM is a Ruby library for Ronin that provides dynamic Assembly (ASM)
 generation of programs or shellcode.
 
-=== RONIN DORKS
+=== Ronin Dorks
 
-* http://ronin.rubyforge.org/libraries/dorks.html
+* http://ronin.rubyforge.org/dorks/
 * http://github.com/postmodern/ronin-dorks
 
 Ronin Dorks is a Ruby library for Ronin that provides support for various
 Google (tm) Dorks functionality.
 
-=== RONIN EXPLOITS
+=== Ronin Exploits
 
-* http://ronin.rubyforge.org/libraries/exploits.html
+* http://ronin.rubyforge.org/exploits/
 * http://github.com/postmodern/ronin-exploits
 
 Ronin Exploits is a Ruby library for Ronin that provides exploitation and
 payload crafting functionality.
 
-=== RONIN HTML
+=== Ronin HTML
 
-* http://ronin.rubyforge.org/libraries/html.html
+* http://ronin.rubyforge.org/html/
 * http://github.com/postmodern/ronin-html
 
 Ronin HTML is a Ruby library for Ronin that provides support for generating
 complex HTML/JavaScript or crafting XSS/CSRF attacks.
 
-=== RONIN SQL
+=== Ronin SQL
 
-* http://ronin.rubyforge.org/libraries/sql.html
+* http://ronin.rubyforge.org/sql/
 * http://github.com/postmodern/ronin-sql
 
 Ronin SQL 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://ronin.rubyforge.org/libraries/php.html
+* http://ronin.rubyforge.org/php/
 * http://github.com/postmodern/ronin-php
 
 Ronin PHP 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
+
+* http://ronin.rubyforge.org/web/
+* http://github.com/postmodern/ronin-web
+
+Ronin Web is a Ruby library for Ronin that provides support for web
+scraping and spidering functionality.
+
 == LICENSE:
 
 Ronin - A Ruby platform designed for information security and data

data/Rakefile

@@ -19,7 +19,7 @@ Hoe.new('ronin', Ronin::VERSION) do |p|
     ['dm-validations', '>=0.9.9'],
     ['dm-predefined', '>=0.1.0'],
     ['parameters', '>=0.1.3'],
-    ['contextify', '>=0.1.0'],
+    ['contextify', '>=0.1.2'],
     ['reverse-require', '>=0.3.1'],
     ['repertoire', '>=0.1.2']
   ]

data/TODO.txt

@@ -1,12 +1,6 @@
 == TODO
 
-=== Ronin 0.1.5:
-
-* Add diagonstic logging of this format:
-  
-    [*] Message
-  
-=== Ronin 0.2.0:
+=== Ronin 0.3.0:
 
 * Create an IO proxy class and RPC Service for proxying io.
 * Create a module for pivoting.

data/lib/ronin.rb

@@ -21,15 +21,5 @@
 #++
 #
 
-require 'ronin/config'
-require 'ronin/extensions'
-require 'ronin/formatting'
-require 'ronin/chars'
-require 'ronin/path'
-require 'ronin/network'
-require 'ronin/models'
-require 'ronin/ui'
-require 'ronin/ronin'
+require 'ronin/environment'
 require 'ronin/version'
-
-Ronin::Config.load

data/lib/ronin/database/database.rb

@@ -23,7 +23,7 @@
 
 require 'ronin/database/exceptions/invalid_config'
 require 'ronin/arch'
-require 'ronin/platform'
+require 'ronin/os'
 require 'ronin/author'
 require 'ronin/license'
 require 'ronin/product'

data/lib/ronin/{cache/config.rb → environment.rb}

@@ -22,13 +22,15 @@
 #
 
 require 'ronin/config'
+require 'ronin/extensions'
+require 'ronin/formatting'
+require 'ronin/chars'
+require 'ronin/path'
+require 'ronin/network'
+require 'ronin/models'
+require 'ronin/ui'
+require 'ronin/ronin'
 
-module Ronin
-  module Config
-    # Path to overlays directory
-    OVERLAY_DIR = File.join(Config::PATH,'overlays')
+require 'pp'
 
-    # Path to overlays cache file
-    OVERLAY_CACHE_PATH = File.join(Config::PATH,'overlays.yaml')
-  end
-end
+Ronin::Config.load

data/lib/ronin/formatting.rb

@@ -25,5 +25,4 @@ require 'ronin/formatting/extensions'
 require 'ronin/formatting/digest'
 require 'ronin/formatting/binary'
 require 'ronin/formatting/text'
-require 'ronin/formatting/html'
 require 'ronin/formatting/http'

data/lib/ronin/formatting/extensions.rb

@@ -23,4 +23,3 @@
 
 require 'ronin/formatting/extensions/binary'
 require 'ronin/formatting/extensions/http'
-require 'ronin/formatting/extensions/html'

data/lib/ronin/formatting/extensions/binary/integer.rb

@@ -56,4 +56,14 @@ class Integer
     return buffer
   end
 
+  #
+  # Returns the hex escaped form of the integer.
+  #
+  #   42.hex_escape
+  #   # => "\\x2a"
+  #
+  def hex_escape
+    "\\x%.2x" % self
+  end
+
 end

data/lib/ronin/formatting/extensions/binary/string.rb

@@ -21,6 +21,7 @@
 #++
 #
 
+require 'ronin/formatting/extensions/text'
 require 'ronin/arch'
 
 require 'base64'
@@ -56,6 +57,16 @@ class String
     return integer
   end
 
+  #
+  # Returns the hex escaped form of the string.
+  #
+  #   "hello".hex_escape
+  #   # => "\\x68\\x65\\x6c\\x6c\\x6f"
+  #
+  def hex_escape(options={})
+    format_bytes(options) { |b| "\\x%.2x" % b }
+  end
+
   #
   # XOR encodes the string using the specified _key_.
   #

data/lib/ronin/formatting/extensions/http/string.rb

@@ -75,7 +75,7 @@ class String
   #   # => "hello"
   #
   def format_http(options={})
-    format_bytes(options) { |c| sprintf("%%%x",c) }
+    format_bytes(options) { |b| "%%%x" % b }
   end
 
 end

data/lib/ronin/network/extensions/http/net.rb

@@ -157,6 +157,14 @@ module Net
     end
   end
 
+  #
+  # Returns +true+ if a HTTP Head request with the given _options_ returns
+  # the HTTP status code of 200, returns +false+ otherwise.
+  #
+  def Net.http_ok?(options={})
+    Net.http_head(options).code == 200
+  end
+
   #
   # Performes an HTTP Lock request with the given _options_. If a _block_
   # is given, it will be passed the response from the HTTP server.

data/lib/ronin/objectify/objectify.rb

@@ -164,53 +164,6 @@ module Ronin
       return nil
     end
 
-    #
-    # Cache all objects loaded from the paths within the specified
-    # _directory_.
-    #
-    def Objectify.cache_objects_in(directory)
-      directory = File.expand_path(directory)
-      paths = Dir[File.join(directory,'**','*.rb')]
-
-      paths.each { |path| Objectify.cache_objects(path) }
-      return nil
-    end
-
-    #
-    # Mirror all objects that were previously cached from paths within
-    # the specified _directory_. Also cache objects which have yet to
-    # be cached.
-    #
-    def Objectify.mirror_objects_in(directory)
-      directory = File.expand_path(directory)
-      new_paths = Dir[File.join(directory,'**','*.rb')]
-
-      Objectify.object_contexts.each_value do |base|
-        objects = base.all(:object_path.like => "#{directory}%")
-        new_paths -= objects.map { |obj| obj.object_path }
-
-        # mirror existing objects
-        objects.each { |obj| obj.mirror }
-      end
-
-      # cache the remaining new paths
-      new_paths.each { |path| Objectify.cache_objects(path) }
-      return nil
-    end
-
-    #
-    # Deletes all cached objects that existed in the specified _directory_.
-    #
-    def Objectify.expunge_objects_from(directory)
-      directory = File.expand_path(directory)
-
-      Objectify.object_contexts.each_value do |base|
-        base.all(:object_path.like => "#{directory}%").destroy!
-      end
-
-      return nil
-    end
-
     #
     # Loads a new object from the file pointed to by the +object_path+
     # property.