ronin 0.1.1 → 0.1.2

data/History.txt

@@ -1,3 +1,42 @@
+=== 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.
+* Require Spidr >= 0.1.3.
+* Moved Ronin::Parameters into the parameters 0.1.0 RubyGem.
+* Added a Hexdump module:
+  * Provides Hexdump.dump and Kernel#hexdump, which can hexdump any object
+    that supports the #each_byte method.
+* Refactored Chars::CharSet:
+  * Now inherites the SortedSet class.
+  * Stores chars as bytes.
+  * Added a Chars::CharSet#=~ operator, for determining if a String exists
+    in the language over the alphabet represented by the character set.
+  * Added a Chars::CharSet#inspect method which prints C-like characters.
+* Added a String#inspect method which prints C-like strings.
+* Added a String#xor method (it might come in handy).
+* Renamed Encoders::Encoder to Translators::Translator.
+* Added URI::QueryParams#each_query_param.
+* Added extensions to Hpricot, for comparing two Hpricot Element trees.
+* Added the Web.spider_agent, Web.spider_host and Web.spider_site methods.
+* Added Code::SymbolTable#symbols.
+* Added a basic Code::Emittable module and a Code::Token class.
+* Renamed ObjectContext.object_contextify to ObjectContext.objectify.
+* Merged the Environment module into the Config module.
+* Refactored the Shell class.
+* Refactored the Runner::Program module.
+* Created the UI namespace, to contain all things User Interfacing:
+  * Moved Console and Shell into the UI namespace.
+  * Renamed Runner::Program to UI::CommandLine.
+* Added a Cache::Overlay::Maintainer class to define maintainers of an
+  Overlay and their contact information.
+* Refactored the parsing of Overlay XML files.
+* Added the sub-commands 'overlay' and 'extension' for generating skeleton
+  Overlays and Extensions.
+* Added a XSL file for generating pretty HTML from Overlay XML files.
+* Added even more specs.
+* More typo and documentation fixes.
+
 === 0.1.1 / 2008-10-26
 
 * Depend on the newly renamed reverse-require (>= 0.1.2) gem.

data/Manifest.txt

@@ -2,13 +2,11 @@ History.txt
 COPYING.txt
 Manifest.txt
 README.txt
-FAQ.txt
 TODO.txt
 Rakefile
 bin/ronin
 lib/ronin.rb
 lib/ronin/config.rb
-lib/ronin/environment.rb
 lib/ronin/exceptions/invalid_database_config.rb
 lib/ronin/exceptions/unknown_context.rb
 lib/ronin/exceptions/context_not_found.rb
@@ -22,15 +20,6 @@ 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/kernel.rb
-lib/ronin/parameters.rb
-lib/ronin/parameters/exceptions.rb
-lib/ronin/parameters/exceptions/missing_param.rb
-lib/ronin/parameters/exceptions/param_not_found.rb
-lib/ronin/parameters/class_param.rb
-lib/ronin/parameters/instance_param.rb
-lib/ronin/parameters/param.rb
-lib/ronin/parameters/parameters.rb
 lib/ronin/formatting.rb
 lib/ronin/formatting/digest.rb
 lib/ronin/formatting/binary.rb
@@ -49,9 +38,15 @@ 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/hexdump.rb
+lib/ronin/hexdump/hexdump.rb
+lib/ronin/hexdump/extensions.rb
+lib/ronin/hexdump/extensions/file.rb
+lib/ronin/hexdump/extensions/kernel.rb
 lib/ronin/chars.rb
 lib/ronin/chars/char_set.rb
 lib/ronin/chars/chars.rb
+lib/ronin/translators/translator.rb
 lib/ronin/path.rb
 lib/ronin/network.rb
 lib/ronin/network/extensions.rb
@@ -83,6 +78,9 @@ lib/ronin/network/telnet.rb
 lib/ronin/network/http.rb
 lib/ronin/network/http/exceptions.rb
 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
@@ -95,10 +93,15 @@ lib/ronin/rpc/client.rb
 lib/ronin/rpc/service.rb
 lib/ronin/rpc/console.rb
 lib/ronin/rpc/shell.rb
-lib/ronin/rpc/interactive.rb
-lib/ronin/rpc/interactive_console.rb
-lib/ronin/rpc/interactive_shell.rb
 lib/ronin/web.rb
+lib/ronin/web/extensions.rb
+lib/ronin/web/extensions/hpricot.rb
+lib/ronin/web/extensions/hpricot/tag.rb
+lib/ronin/web/extensions/hpricot/text.rb
+lib/ronin/web/extensions/hpricot/comment.rb
+lib/ronin/web/extensions/hpricot/elem.rb
+lib/ronin/web/extensions/hpricot/container.rb
+lib/ronin/web/extensions/hpricot/doc.rb
 lib/ronin/web/web.rb
 lib/ronin/sessions.rb
 lib/ronin/sessions/session.rb
@@ -109,10 +112,10 @@ lib/ronin/sessions/esmtp.rb
 lib/ronin/sessions/pop3.rb
 lib/ronin/sessions/imap.rb
 lib/ronin/sessions/telnet.rb
+lib/ronin/sessions/http.rb
 lib/ronin/sessions/web.rb
 lib/ronin/database.rb
 lib/ronin/model.rb
-lib/ronin/models.rb
 lib/ronin/author.rb
 lib/ronin/license.rb
 lib/ronin/arch.rb
@@ -122,35 +125,39 @@ lib/ronin/product.rb
 lib/ronin/pending_context.rb
 lib/ronin/context.rb
 lib/ronin/object_context.rb
-lib/ronin/objects.rb
-lib/ronin/persistence.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/console.rb
-lib/ronin/shell.rb
-lib/ronin/program.rb
-lib/ronin/program/exceptions.rb
-lib/ronin/program/exceptions/unknown_command.rb
-lib/ronin/program/command.rb
-lib/ronin/program/options.rb
-lib/ronin/program/commands.rb
-lib/ronin/program/commands/add.rb
-lib/ronin/program/commands/install.rb
-lib/ronin/program/commands/list.rb
-lib/ronin/program/commands/update.rb
-lib/ronin/program/commands/remove.rb
-lib/ronin/program/commands/uninstall.rb
-lib/ronin/program/commands/help.rb
-lib/ronin/program/program.rb
+lib/ronin/ui/console.rb
+lib/ronin/ui/shell.rb
+lib/ronin/ui/command_line.rb
+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/commands.rb
+lib/ronin/ui/command_line/commands/default.rb
+lib/ronin/ui/command_line/commands/overlay.rb
+lib/ronin/ui/command_line/commands/extension.rb
+lib/ronin/ui/command_line/commands/add.rb
+lib/ronin/ui/command_line/commands/install.rb
+lib/ronin/ui/command_line/commands/list.rb
+lib/ronin/ui/command_line/commands/update.rb
+lib/ronin/ui/command_line/commands/remove.rb
+lib/ronin/ui/command_line/commands/uninstall.rb
+lib/ronin/ui/command_line/commands/help.rb
+lib/ronin/ui/command_line/command_line.rb
 lib/ronin/ronin.rb
 lib/ronin/version.rb
 tasks/spec.rb
@@ -158,12 +165,15 @@ spec/helpers.rb
 spec/spec_helper.rb
 spec/arch_spec.rb
 spec/author_spec.rb
+spec/chars/char_set_spec.rb
 spec/chars/chars_spec.rb
+spec/translators/translator_spec.rb
 spec/context/context_spec.rb
 spec/context/helpers/book_context.rb
 spec/context/helpers/book_review_context.rb
 spec/context/helpers/contexts/snow_crash.rb
 spec/context/helpers/contexts/neuromancer_review.rb
+spec/object_context/object_context_spec.rb
 spec/extensions/hash_spec.rb
 spec/extensions/string_spec.rb
 spec/extensions/uri/http_spec.rb
@@ -175,11 +185,13 @@ spec/formatting/http_spec.rb
 spec/formatting/text_spec.rb
 spec/code/reference_spec.rb
 spec/code/symbol_table_spec.rb
+spec/web/extensions/hpricot_spec.rb
 spec/license_spec.rb
 spec/path_spec.rb
 spec/platform_spec.rb
 spec/product_spec.rb
 spec/target_spec.rb
-spec/parameters/parameters_spec.rb
 spec/sessions/session_spec.rb
 spec/ronin_spec.rb
+static/overlay.xsl
+static/extension.rb.erb

data/README.txt

@@ -1,7 +1,9 @@
 = Ronin
 
 * http://ronin.rubyforge.org/
-* Postmodern Modulus III
+* http://github.com/postmodern/ronin
+* irc.freenode.net ##ronin
+* Postmodern (postmodern.mod3 at gmail.com)
 
 == DESCRIPTION:
 
@@ -19,9 +21,9 @@ commercial software.
 
 === Modular
 
-Ronin was not designed as one monolithic library but instead as a collection
-of libraries which can be individually installed. This allows users to pick
-and choose what functionality they want in Ronin.
+Ronin was not designed as one monolithic framework but instead as a
+collection of libraries which can be individually installed. This allows
+users to pick and choose what functionality they want in Ronin.
 
 === Decentralized
 
@@ -65,16 +67,42 @@ of Ronin.
   * Auto-indentation enabled.
   * Pretty-Print loaded.
 
+== REQUIREMENTS:
+
+* Hpricot
+* WWW::Mechanize
+* DataMapper:
+  * dm-core >= 0.9.3
+  * data_objects >= 0.9.3
+  * do_sqlite3 >= 0.9.3
+  * dm-types >= 0.9.3
+  * dm-serializer >= 0.9.3
+  * dm-aggregates >= 0.9.3
+* reverse-require >= 0.1.2
+* R'epertoire >= 0.1.2
+
+== INSTALL:
+
+  $ sudo gem install ronin
+
 == SYNOPSIS:
 
-* List installed Overlays:
+* Generate an Overlay:
 
-    $ ronin ls
+    $ 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
 
+* List installed Overlays:
+
+    $ ronin ls
+
 * Update all installed Overlays:
 
     $ ronin up
@@ -91,23 +119,56 @@ of Ronin.
 
     $ ronin
 
-== REQUIREMENTS:
+== RONIN LIBRARIES:
 
-* Hpricot
-* WWW::Mechanize
-* DataMapper:
-  * dm-core >= 0.9.3
-  * data_objects >= 0.9.3
-  * do_sqlite3 >= 0.9.3
-  * dm-types >= 0.9.3
-  * dm-serializer >= 0.9.3
-  * dm-aggregates >= 0.9.3
-* reverse-require >= 0.1.0
-* R'epertoire >= 0.1.2
+=== RONIN ASM
 
-== INSTALL:
+* http://ronin.rubyforge.org/libraries/asm.html
+* http://github.com/postmodern/ronin-asm
 
-  $ sudo gem install ronin
+Ronin ASM is a Ruby library for Ronin that provides dynamic Assembly (ASM)
+generation of programs or shellcode.
+
+=== RONIN DORKS
+
+* http://ronin.rubyforge.org/libraries/dorks.html
+* 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
+
+* http://ronin.rubyforge.org/libraries/exploits.html
+* http://github.com/postmodern/ronin-exploits
+
+Ronin Exploits is a Ruby library for Ronin that provides exploitation and
+payload crafting functionality.
+
+=== RONIN HTML
+
+* http://ronin.rubyforge.org/libraries/html.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
+
+* http://ronin.rubyforge.org/libraries/sql.html
+* 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
+
+* http://ronin.rubyforge.org/libraries/php.html
+* 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).
 
 == LICENSE:
 

data/Rakefile

@@ -7,18 +7,20 @@ require './lib/ronin/version.rb'
 
 Hoe.new('ronin', Ronin::VERSION) do |p|
   p.rubyforge_name = 'ronin'
-  p.developer('Postmodern Modulus III','postmodern.mod3@gmail.com')
+  p.developer('Postmodern','postmodern.mod3@gmail.com')
   p.remote_rdoc_dir = 'docs/ronin'
   p.extra_deps = ['hpricot',
                   'mechanize',
+                  ['spidr', '>=0.1.3'],
                   ['dm-core', '>=0.9.3'],
-                  ['data_objects', '>=0.9.3'],
-                  ['do_sqlite3', '>=0.9.3'],
+                  ['data_objects', '>=0.9.9'],
+                  ['do_sqlite3', '>=0.9.9'],
                   ['dm-types', '>=0.9.3'],
                   ['dm-serializer', '>=0.9.3'],
                   ['dm-aggregates', '>=0.9.3'],
                   ['dm-validations', '>=0.9.3'],
-                  ['reverse-require', '>=0.1.2'],
+                  ['parameters', '>=0.1.0'],
+                  ['reverse-require', '>=0.2.0'],
                   ['repertoire', '>=0.1.2']]
 end
 

data/TODO.txt

@@ -1,10 +1,6 @@
 == TODO
 
-=== Ronin 0.1.0:
-
-* Ensure that an ObjectContext can be loaded from a file and have all of
-  it's properties and associations loaded from the Database.
-* Create an Overlay Genetor for creating basic Overlays.
+=== Ronin 0.1.2:
 
 === Ronin 0.2.0:
 

data/bin/ronin

@@ -7,6 +7,6 @@ unless $LOAD_PATH.include?(lib_dir)
   $LOAD_PATH << lib_dir
 end
 
-require 'ronin/program'
+require 'ronin/ui/command_line'
 
-Ronin::Program.run(*ARGV)
+Ronin::UI::CommandLine.run(*ARGV)

data/lib/ronin.rb

@@ -22,14 +22,14 @@
 #
 
 require 'ronin/extensions'
-require 'ronin/environment'
+require 'ronin/config'
 require 'ronin/formatting'
 require 'ronin/chars'
 require 'ronin/path'
 require 'ronin/network'
 require 'ronin/web'
-require 'ronin/persistence'
+require 'ronin/models'
 require 'ronin/ronin'
 require 'ronin/version'
 
-Ronin::Environment.load
+Ronin::Config.load

data/lib/ronin/arch.rb

@@ -66,9 +66,11 @@ module Ronin
       address_length = options[:address_length].to_i
 
       meta_def(name.to_method_name) do
-        Arch.first_or_create(:name => name,
-                             :endian => endian,
-                             :address_length => address_length)
+        Arch.first_or_create(
+          :name => name,
+          :endian => endian,
+          :address_length => address_length
+        )
       end
 
       return nil

data/lib/ronin/author.rb

@@ -31,9 +31,10 @@ module Ronin
 
     include Model
 
-    # Anonymouse author name.
+    # Anonymouse author name
     ANONYMOUSE = 'anonymous'
 
+    # Primary key of the author
     property :id, Serial
 
     # Name of author