ronin 0.1.0 → 0.1.1

data/lib/ronin/object_context.rb

@@ -196,9 +196,7 @@ module Ronin
     # Cache all objects loaded from the specified _path_.
     #
     def ObjectContext.cache_objects(path)
-      ObjectContext.load_objects(path).each do |obj|
-        obj.cache
-      end
+      ObjectContext.load_objects(path).each { |obj| obj.cache }
     end
 
     #
@@ -210,9 +208,7 @@ module Ronin
       paths = Dir[File.join(directory,'**','*.rb')]
 
       paths.each do |path|
-        ObjectContext.load_objects(path).each do |obj|
-          obj.cache
-        end
+        ObjectContext.load_objects(path).each { |obj| obj.cache }
       end
 
       return nil
@@ -234,9 +230,7 @@ module Ronin
         objects.each { |obj| obj.mirror }
       end
 
-      paths.each do |path|
-        ObjectContext.cache_objects(path)
-      end
+      paths.each { |path| ObjectContext.cache_objects(path) }
 
       return nil
     end

data/lib/ronin/pending_context.rb

@@ -38,5 +38,13 @@ module Ronin
       @blocks = {}
     end
 
+    #
+    # Iterates over each block in the pending context, passing their name
+    # and value to the given _block_.
+    #
+    def each_block(&block)
+      @blocks.each(&block)
+    end
+
   end
 end

data/lib/ronin/platform.rb

@@ -32,10 +32,10 @@ module Ronin
     property :id, Serial
 
     # Name of the Operating System
-    property :os, String
+    property :os, String, :index => true
 
     # Version of the Operating System
-    property :version, String
+    property :version, String, :index => true
 
     # Validates
     validates_present :os, :version

data/lib/ronin/product.rb

@@ -33,10 +33,10 @@ module Ronin
     property :id, Serial
 
     # Name
-    property :name, String
+    property :name, String, :index => true
 
     # Version
-    property :version, String
+    property :version, String, :index => true
 
     # Venders
     property :vendor, String

data/lib/ronin/program/command.rb

@@ -0,0 +1,203 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2008 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/program/options'
+require 'ronin/program/program'
+require 'ronin/extensions/meta'
+
+module Ronin
+  module Program
+    class Command
+
+      #
+      # Creates a new Command object. If a _block_ is given,
+      # it will be passed newly created Command object.
+      #
+      def initialize(&block)
+        @options = nil
+
+        block.call(self) if block
+      end
+
+      #
+      # Returns the name of the command.
+      #
+      def Command.command_name
+        ''
+      end
+
+      #
+      # Returns the short names of the command.
+      #
+      def Command.command_short_names
+        []
+      end
+
+      #
+      # Returns all the names of the command.
+      #
+      def self.command_names
+        [self.command_name] + self.command_short_names
+      end
+
+      #
+      # Creates a new command object and runs it with the
+      # given _args_.
+      #
+      def self.run(*args)
+        self.new.run(*args)
+      end
+
+      #
+      # Prints the help information for the command.
+      #
+      def self.help
+        self.new.help
+      end
+
+      #
+      # Returns the name of the command.
+      #
+      def command_name
+        self.class.command_name
+      end
+
+      #
+      # Returns the short names of the command.
+      #
+      def command_short_names
+        self.class.command_short_names
+      end
+
+      #
+      # Returns all the names of the command.
+      #
+      def command_names
+        self.class.command_names
+      end
+
+      #
+      # Runs the command with the given _args_. If a _block_ is
+      # given, it will be called after the specified _args_ have
+      # been parsed and the command has run.
+      #
+      def run(*args,&block)
+        arguments(*(options.parse(args)))
+
+        @options = nil
+
+        block.call if block
+        return self
+      end
+
+      #
+      # Prints the help information for the command.
+      #
+      def help
+        options.help
+        return self
+      end
+
+      #
+      # Returns the String form of the command.
+      #
+      def to_s
+        names.join(', ')
+      end
+
+      protected
+
+      #
+      # Registers the command with the specified _name_ and the given
+      # _short_names_.
+      #
+      def self.command(name,*short_names)
+        name = name.to_s
+        short_names = short_names.map { |short_name| short_name.to_s }
+
+        meta_def(:command_name) { name }
+        meta_def(:command_short_names) { short_names }
+
+        # register the command
+        Program.commands << self unless Program.commands.include?(self)
+
+        # register the command by name
+        Program.commands_by_name[name] = self
+
+        # register the command by it's short_names
+        short_names.each do |short_name|
+          Program.commands_by_name[short_name] = self
+        end
+
+        return self
+      end
+
+      #
+      # Defines the options of the command with the specified _usage_ and
+      # _block_.
+      #
+      def self.options(usage=nil,&block)
+        class_def(:options) do
+          @options ||= Options.command(:ronin,self.command_name,usage,&block)
+        end
+
+        return self
+      end
+
+      #
+      # Returns the options of the command.
+      #
+      def options
+        @options ||= Options.command(:ronin,command_name)
+      end
+
+      #
+      # See Program.error.
+      #
+      def error(message)
+        Program.error(message)
+      end
+
+      #
+      # See Program.success.
+      #
+      def success(&block)
+        Program.success(&block)
+      end
+
+      #
+      # See Program.fail.
+      #
+      def fail(*messages,&block)
+        Program.fail(*messages,&block)
+      end
+
+      #
+      # Processes the additional arguments specified by _args_.
+      #
+      def arguments(*args)
+      end
+
+    end
+  end
+end

data/lib/ronin/program/commands/add.rb

@@ -0,0 +1,71 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2007 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/program/command'
+require 'ronin/cache/overlay'
+
+module Ronin
+  module Program
+    class AddCommand < Command
+
+      command :add
+
+      options('PATH [options]') do |opts|
+        opts.settings.media = nil
+        opts.settings.uri = nil
+
+        opts.options do
+          opts.on('-m','--media MEDIA','Spedify the media-type of the repository') do |media|
+            opts.settings.media = media
+          end
+
+          opts.on('-U','--uri URI','Specify the source URI of the repository') do |uri|
+            opts.settings.uri = uri
+          end
+        end
+
+        opts.arguments do
+          opts.arg('PATH','Add the repository located at the specified PATH')
+        end
+
+        opts.summary('Add a local repository located at the specified PATH to the repository cache')
+
+      end
+
+      def arguments(*args)
+        unless args.length==1
+          fail('add: only one repository path maybe specified')
+        end
+
+        path = args.first
+
+        Cache::Overlay.save_cache do
+          Cache::Overlay.add(path,options.settings.media,options.settings.uri) do |repo|
+            puts "Overlay #{repo} added."
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/ronin/{runner/program → program}/commands/help.rb

@@ -21,32 +21,30 @@
 #++
 #
 
-require 'ronin/runner/program/command'
+require 'ronin/program/command'
 
 module Ronin
-  module Runner
-    module Program
-      class HelpCommand < Command
+  module Program
+    class HelpCommand < Command
 
-        command :help
+      command :help
 
-        options('[COMMAND]') do |opts|
-          opts.arguments do
-            opts.arg('COMMAND','The command to view')
-          end
-
-          opts.summary('View a list of supported commands or information on a specific command')
+      options('[COMMAND]') do |opts|
+        opts.arguments do
+          opts.arg('COMMAND','The command to view')
         end
 
-        def arguments(*args)
-          unless args.length<=1
-            fail('help: only one command maybe specified')
-          end
+        opts.summary('View a list of supported commands or information on a specific command')
+      end
 
-          success { Program.help(args.first) }
+      def arguments(*args)
+        unless args.length<=1
+          fail('help: only one command maybe specified')
         end
 
+        success { Program.help(args.first) }
       end
+
     end
   end
 end

data/lib/ronin/program/commands/install.rb

@@ -0,0 +1,64 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2007 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/program/command'
+require 'ronin/cache/overlay'
+
+module Ronin
+  module Program
+    class InstallCommand < Command
+
+      command :install
+
+      options('URI [options]') do |opts|
+        opts.settings.media = nil
+        opts.settings.uri = nil
+
+        opts.options do
+          opts.on('-m','--media [MEDIA]','Spedify the media-type of the repository') do |media|
+            options.settings.media = media
+          end
+        end
+
+        opts.arguments do
+          opts.arg('URI','The URI of the repository to install')
+        end
+
+        opts.summary('Installs the repository located at the specified URI')
+      end
+
+      def arguments(args)
+        unless args.length==1
+          fail('install: only one repository URI maybe specified')
+        end
+
+        Cache::Overlay.save_cache do
+          Cache::Overlay.install(:uri => args.first, :media => options.settings.media) do |repo|
+            puts "Overlay #{repo} has been installed."
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/ronin/program/commands/list.rb

@@ -0,0 +1,79 @@
+#
+#--
+# Ronin - A Ruby platform designed for information security and data
+# exploration tasks.
+#
+# Copyright (c) 2006-2007 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/program/command'
+require 'ronin/cache/overlay'
+
+module Ronin
+  module Program
+    class ListCommand < Command
+
+      command :list, :ls
+
+      options('[NAME ...] [options]') do |opts|
+        opts.options
+
+        opts.arguments do
+          opts.arg('NAME','Overlay to display')
+        end
+
+        opts.summary('Display all or the specified repositories within the repository cache')
+      end
+
+      def arguments(*args)
+        if args.empty?
+          # list all repositories by name
+          Cache::Overlay.each do |repo|
+            puts "  #{repo}"
+          end
+        else
+          # list specified repositories
+          args.each do |name|
+            repo = Cache::Overlay.get(name)
+
+            puts "[ #{repo} ]\n\n"
+
+            puts "  path: #{repo.path}" if options.settings.verbose
+            puts "  media: #{repo.media}"
+            puts "  uri: #{repo.uri}" if repo.uri
+
+            if repo.description
+              puts "  description:\n\n    #{repo.description}"
+            end
+
+            puts "\n"
+
+            if options.settings.verbose
+              puts "  extensions:\n\n"
+
+              repo.each_extension do |ext|
+                puts "    #{ext}"
+              end
+            end
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/ronin/{runner/program/commands/update.rb → program/commands/remove.rb}

@@ -21,35 +21,35 @@
 #++
 #
 
-require 'ronin/runner/program/command'
+require 'ronin/program/command'
 require 'ronin/cache/overlay'
 
 module Ronin
-  module Runner
-    module Program
-      class UpdateCommand < Command
+  module Program
+    class RemoveCommand < Command
 
-        command :update, :up
+      command :remove, :rm
 
-        options('[NAME ...] [options]') do |opts|
-          opts.options
+      options('NAME [NAME ...] [options]') do |opts|
+        opts.options
 
-          opts.arguments do
-            opts.arg('NAME','The repository to update')
-          end
-
-          opts.summary('Updates all or the specified repositories')
+        opts.arguments do
+          opts.arg('NAME','The repository to remove')
         end
 
-        def arguments(*args)
-          if args.empty?
-            Cache::Overlay.each { |repo| repo.update }
-          else
-            args.each { |name| Cache::Overlay.update(name) }
+        opts.summary('Remove the specified repositories')
+      end
+
+      def arguments(*args)
+        args.each do |name|
+          Cache::Overlay.save_cache do
+            Cache::Overlay.remove(name) do |repo|
+              puts "Removing #{repo}..."
+            end
           end
         end
-
       end
+
     end
   end
 end

data/lib/ronin/{runner/program/commands/remove.rb → program/commands/uninstall.rb}

@@ -21,37 +21,35 @@
 #++
 #
 
-require 'ronin/runner/program/command'
+require 'ronin/program/command'
 require 'ronin/cache/overlay'
 
 module Ronin
-  module Runner
-    module Program
-      class RemoveCommand < Command
+  module Program
+    class UninstallCommand < Command
 
-        command :remove, :rm
+      command :uninstall
 
-        options('NAME [NAME ...] [options]') do |opts|
-          opts.options
+      options('NAME [NAME ...] [options]') do |opts|
+        opts.options
 
-          opts.arguments do
-            opts.arg('NAME','The repository to remove')
-          end
-
-          opts.summary('Remove the specified repositories')
+        opts.arguments do
+          opts.arg('NAME','The repository to uninstall')
         end
 
-        def arguments(*args)
-          args.each do |name|
-            Cache::Overlay.save_cache do
-              Cache::Overlay.remove(name) do |repo|
-                puts "Removing #{repo}..."
-              end
+        opts.summary('Uninstall the specified repositories')
+      end
+
+      def arguments(*args)
+        args.each do |name|
+          Cache::Overlay.save_cache do
+            Cache::Overlay.uninstall(name) do |repo|
+              puts "Uninstalling #{repo}..."
             end
           end
         end
-
       end
+
     end
   end
 end