ronin 0.0.9

data/lib/ronin/rpc/service.rb

@@ -0,0 +1,69 @@
+#
+#--
+# 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
+#++
+#
+
+module Ronin
+  module RPC
+    class Service
+
+      # Name of the service
+      attr_reader :name
+
+      # The client object
+      attr_reader :client
+
+      #
+      # Creates a new Service object with the specified _name_ and _client_.
+      #
+      def initialize(name,client)
+        @name = name
+        @client = client
+      end
+
+      #
+      # Calls the specified _function_ from the service on the RPC Server
+      # with the given _arguments_. Returns the return-value of the
+      # RPC function call.
+      #
+      def call(function,*arguments)
+        @client.call("#{@name}.#{function}",*arguments)
+      end
+
+      #
+      # Returns the name of the service.
+      #
+      def to_s
+        @name.to_s
+      end
+
+      protected
+
+      #
+      # Relays missing methods to call.
+      #
+      def method_missing(sym,*args)
+        call(sym,*args)
+      end
+
+    end
+  end
+end

data/lib/ronin/rpc/shell.rb

@@ -0,0 +1,66 @@
+#
+#--
+# 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/rpc/service'
+require 'ronin/rpc/interactive_shell'
+
+module Ronin
+  module RPC
+    class Shell < Service
+
+      #
+      # Executes the specified _program_ with the given _arguments_. The
+      # output of the program will be returned as a String.
+      #
+      def exec(program,*arguments)
+        call(:exec,program,*arguments)
+      end
+
+      #
+      # Executes the specified _program_ with the given _arguments_ and
+      # prints the output of the program.
+      #
+      def system(program,*arguments)
+        print(exec(program,*arguments))
+      end
+
+      #
+      # Starts an InteractiveShell that allows a user to execute commands
+      # and observe their output.
+      #
+      def interact
+        InteractiveShell.start(self)
+      end
+
+      protected
+
+      #
+      # Relays missing methods to exec.
+      #
+      def method_missing(sym,*args)
+        exec(sym,*args)
+      end
+
+    end
+  end
+end

data/lib/ronin/runner.rb

@@ -0,0 +1,24 @@
+#
+#--
+# 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/runner/program'

data/lib/ronin/runner/program.rb

@@ -0,0 +1,26 @@
+#
+#--
+# 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/runner/program/program'
+require 'ronin/runner/program/commands'
+require 'ronin/runner/program/runner'

data/lib/ronin/runner/program/command.rb

@@ -0,0 +1,204 @@
+#
+#--
+# 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/runner/program/program'
+require 'ronin/extensions/meta'
+
+module Ronin
+  module Runner
+    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
+end

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

@@ -0,0 +1,33 @@
+#
+#--
+# 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/runner/program/commands/add'
+require 'ronin/runner/program/commands/install'
+require 'ronin/runner/program/commands/list'
+require 'ronin/runner/program/commands/update'
+require 'ronin/runner/program/commands/uninstall'
+require 'ronin/runner/program/commands/remove'
+require 'ronin/runner/program/commands/help'
+require 'ronin/extensions'
+
+ronin_require 'ronin/runner/program/commands'

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

@@ -0,0 +1,73 @@
+#
+#--
+# 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/runner/program/command'
+require 'ronin/cache/overlay'
+
+module Ronin
+  module Runner
+    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
+end