ronin-support 0.5.1 → 1.0.0.beta1

data/lib/ronin/ui/output/terminal/color.rb

@@ -1,124 +0,0 @@
-#
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of Ronin Support.
-#
-# Ronin Support is free software: you can redistribute it and/or modify
-# it under the terms of the GNU Lesser General Public License as published
-# by the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# Ronin Support 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 Lesser General Public License for more details.
-#
-# You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
-#
-
-module Ronin
-  module UI
-    module Output
-      module Terminal
-        #
-        # The handler for color output to the terminal.
-        #
-        class Color
-
-          # ANSI Green code
-          GREEN = "\e[32m"
-
-          # ANSI Cyan code
-          CYAN = "\e[36m"
-
-          # ANSI Yellow code
-          YELLOW = "\e[33m"
-
-          # ANSI Red code
-          RED = "\e[31m"
-
-          # ANSI Bright code
-          BRIGHT = "\e[1m"
-
-          # ANSI Bright-Off code
-          BRIGHT_OFF = "\e[21m"
-
-          # ANSI Clear code
-          CLEAR = "\e[0m"
-
-          #
-          # Writes data to `STDOUT`.
-          #
-          # @param [String] data
-          #   The data to write.
-          #
-          # @since 1.0.0
-          #
-          # @api private
-          #
-          def self.write(data)
-            $stdout.write(data)
-          end
-
-          #
-          # Prints an `info` message.
-          #
-          # @param [String] message
-          #   The message to print.
-          #
-          # @since 1.0.0
-          #
-          # @api private
-          #
-          def self.print_info(message)
-            $stdout.puts "#{GREEN}#{BRIGHT}[-]#{BRIGHT_OFF} #{message}#{CLEAR}"
-          end
-
-          #
-          # Prints a `debug` message.
-          #
-          # @param [String] message
-          #   The message to print.
-          #
-          # @since 1.0.0
-          #
-          # @api private
-          #
-          def self.print_debug(message)
-            $stdout.puts "#{CYAN}#{BRIGHT}[=]#{BRIGHT_OFF} #{message}#{CLEAR}"
-          end
-
-          #
-          # Prints a `warning` message.
-          #
-          # @param [String] message
-          #   The message to print.
-          #
-          # @since 1.0.0
-          #
-          # @api private
-          #
-          def self.print_warning(message)
-            $stdout.puts "#{YELLOW}#{BRIGHT}[*]#{BRIGHT_OFF} #{message}#{CLEAR}"
-          end
-
-          #
-          # Prints an `error` message.
-          #
-          # @param [String] message
-          #   The message to print.
-          #
-          # @since 1.0.0
-          #
-          # @api private
-          #
-          def self.print_error(message)
-            $stdout.puts "#{RED}#{BRIGHT}[!]#{BRIGHT_OFF} #{message}#{CLEAR}"
-          end
-
-        end
-      end
-    end
-  end
-end

data/lib/ronin/ui/output/terminal/raw.rb

@@ -1,103 +0,0 @@
-#
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of Ronin Support.
-#
-# Ronin Support is free software: you can redistribute it and/or modify
-# it under the terms of the GNU Lesser General Public License as published
-# by the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# Ronin Support 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 Lesser General Public License for more details.
-#
-# You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
-#
-
-module Ronin
-  module UI
-    module Output
-      module Terminal
-        #
-        # The handler for raw output to the terminal.
-        #
-        class Raw
-
-          #
-          # Writes data to `STDOUT`.
-          #
-          # @param [String] data
-          #   The data to write.
-          #
-          # @since 1.0.0
-          #
-          # @api private
-          #
-          def self.write(data)
-            $stdout.write(data)
-          end
-
-          #
-          # Prints an `info` message.
-          #
-          # @param [String] message
-          #   The message to print.
-          #
-          # @since 1.0.0
-          #
-          # @api private
-          #
-          def self.print_info(message)
-            $stdout.puts "[-] #{message}"
-          end
-
-          #
-          # Prints a `debug` message.
-          #
-          # @param [String] message
-          #   The message to print.
-          #
-          # @since 1.0.0
-          #
-          # @api private
-          #
-          def self.print_debug(message)
-            $stdout.puts "[=] #{message}"
-          end
-
-          #
-          # Prints a `warning` message.
-          #
-          # @param [String] message
-          #   The message to print.
-          #
-          # @since 1.0.0
-          #
-          # @api private
-          #
-          def self.print_warning(message)
-            $stdout.puts "[*] #{message}"
-          end
-
-          #
-          # Prints an `error` messages.
-          #
-          # @param [String] message
-          #   The message to print.
-          #
-          # @since 1.0.0
-          #
-          # @api private
-          #
-          def self.print_error(message)
-            $stdout.puts "[!] #{message}"
-          end
-
-        end
-      end
-    end
-  end
-end

data/lib/ronin/ui/output/terminal.rb

@@ -1,21 +0,0 @@
-#
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of Ronin Support.
-#
-# Ronin Support is free software: you can redistribute it and/or modify
-# it under the terms of the GNU Lesser General Public License as published
-# by the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# Ronin Support 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 Lesser General Public License for more details.
-#
-# You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
-#
-
-require 'ronin/ui/output/terminal/raw'
-require 'ronin/ui/output/terminal/color'

data/lib/ronin/ui/output.rb

@@ -1,21 +0,0 @@
-#
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of Ronin Support.
-#
-# Ronin Support is free software: you can redistribute it and/or modify
-# it under the terms of the GNU Lesser General Public License as published
-# by the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# Ronin Support 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 Lesser General Public License for more details.
-#
-# You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
-#
-
-require 'ronin/ui/output/output'
-require 'ronin/ui/output/helpers'

data/lib/ronin/ui/shell.rb

@@ -1,286 +0,0 @@
-#
-# Copyright (c) 2006-2012 Hal Brodigan (postmodern.mod3 at gmail.com)
-#
-# This file is part of Ronin Support.
-#
-# Ronin Support is free software: you can redistribute it and/or modify
-# it under the terms of the GNU Lesser General Public License as published
-# by the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# Ronin Support 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 Lesser General Public License for more details.
-#
-# You should have received a copy of the GNU Lesser General Public License
-# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
-#
-
-require 'ronin/ui/output/helpers'
-
-require 'set'
-
-module Ronin
-  module UI
-    #
-    # Spawns a ReadLine powered interactive Shell.
-    #
-    # ## Simple Shell
-    #
-    #     require 'ronin/ui/shell'
-    #     require 'ronin/network/tcp'
-    #
-    #     include Ronin::Network::TCP
-    #
-    #     tcp_session('victim.com',1337) do |socket|
-    #       UI::Shell.new(:name => 'bind_shell') do |shell,line|
-    #         socket.puts "#{line}; echo 'EOC'"
-    #
-    #         socket.each_line do |output|
-    #           puts output
-    #
-    #           break if output.chomp == 'EOC'
-    #         end
-    #       end
-    #     end
-    #
-    # ## Shell with Commands
-    #
-    #     require 'ronin/ui/shell'
-    #     require 'ronin/network/http'
-    #
-    #     class HTTPShell < Ronin::UI::Shell
-    #
-    #       include Ronin::Network::HTTP
-    #
-    #       def initialize(host)
-    #         super(:name => host)
-    #
-    #         @host = host
-    #       end
-    #
-    #       protected
-    #
-    #       def get(path)
-    #         print_response http_get(:host => @host, :path => path)
-    #       end
-    #
-    #       def post(path,*params)
-    #         print_response http_post(
-    #           :host      => @host,
-    #           :path      => path,
-    #           :post_data => Hash[params.map { |param| param.split('=') }]
-    #         )
-    #       end
-    #
-    #       private
-    #
-    #       def print_response(response)
-    #         response.canonical_each do |name,value|
-    #           puts "#{name}: #{value}"
-    #         end
-    #
-    #         puts
-    #
-    #         puts response.body
-    #       end
-    #
-    #     end
-    #
-    # @api semipublic
-    #
-    class Shell
-
-      include Output::Helpers
-
-      # Default shell prompt
-      DEFAULT_PROMPT = '>'
-
-      # The shell name
-      attr_accessor :name
-
-      # The shell prompt
-      attr_accessor :prompt
-
-      # The commands available for the shell
-      attr_reader :commands
-
-      #
-      # Creates a new shell.
-      #
-      # @param [Hash] options
-      #   Additional options.
-      #
-      # @option options [String] :name ('')
-      #   The shell-name to use before the prompt.
-      #
-      # @option options [String] :prompt (DEFAULT_PROMPT)
-      #   The prompt to use for the shell.
-      #
-      # @yield [shell, line]
-      #   The block that will be passed every command entered.
-      #
-      # @yieldparam [Shell] shell
-      #   The shell to use for output.
-      #
-      # @yieldparam [String] line
-      #   The command entered into the shell.
-      #
-      # @api semipublic
-      #
-      # @since 0.3.0
-      #
-      def initialize(options={},&block)
-        @name     = options[:name]
-        @prompt   = options.fetch(:prompt,DEFAULT_PROMPT)
-
-        @commands = Set['help', 'exit']
-
-        self.class.ancestors.each do |subclass|
-          if subclass < Shell
-            subclass.protected_instance_methods(false).each do |name|
-              @commands << name.to_s
-            end
-          end
-        end
-
-
-        @input_handler = block
-      end
-
-      #
-      # Creates a new Shell object and starts it.
-      #
-      # @param [Array] arguments
-      #   Arguments for {#initialize}.
-      #
-      # @yield [shell, line]
-      #   The block that will be passed every command entered.
-      #
-      # @yieldparam [Shell] shell
-      #   The shell to use for output.
-      #
-      # @yieldparam [String] line
-      #   The command entered into the shell.
-      #
-      # @return [nil]
-      #
-      # @example
-      #   Shell.start(:prompt => '$') { |shell,line| system(line) }
-      #
-      def self.start(*arguments,&block)
-        new(*arguments,&block).start
-      end
-
-      #
-      # Starts the shell.
-      #
-      # @since 0.3.0
-      #
-      def start
-        history_rollback = 0
-
-        loop do
-          unless (raw_line = Readline.readline("#{name}#{prompt} "))
-            break # user exited the shell
-          end
-
-          line = raw_line.strip
-
-          if (line == 'exit' || line == 'quit')
-            exit
-            break
-          elsif !(line.empty?)
-            Readline::HISTORY << raw_line
-            history_rollback += 1
-
-            begin
-              call(line)
-            rescue => e
-              print_error "#{e.class.name}: #{e.message}"
-            end
-          end
-        end
-
-        history_rollback.times { Readline::HISTORY.pop }
-        return nil
-      end
-
-      #
-      # Handles input for the shell.
-      #
-      # @param [String] line
-      #   A line of input received by the shell.
-      # 
-      # @since 0.3.0
-      #
-      def call(line)
-        if @input_handler
-          @input_handler.call(self,line)
-        else
-          arguments = line.split(/\s+/)
-          command   = arguments.shift
-
-          # ignore empty lines
-          return false unless command
-
-          # no explicitly calling handler
-          return false if command == 'handler'
-
-          unless @commands.include?(command)
-            print_error "Invalid command: #{command}"
-            return false
-          end
-
-          return send(command,*arguments)
-        end
-      end
-
-      alias << write
-
-      protected
-
-      #
-      # Method which is called before exiting the shell.
-      #
-      # @since 0.3.0
-      #
-      def exit
-      end
-
-      #
-      # @see #exit
-      #
-      # @since 0.3.0
-      #
-      def quit
-        exit
-      end
-
-      #
-      # Prints the available commands and their arguments.
-      #
-      # @since 0.3.0
-      #
-      def help
-        puts "Available commands:"
-        puts
-
-        @commands.sort.each do |name|
-          command_method = method(name)
-          arguments = command_method.parameters.map do |param|
-            case param[0]
-            when :opt  then "[#{param[1]}]"
-            when :rest then "[#{param[1]} ...]"
-            else                param[1]
-            end
-          end
-
-          puts "  #{name} #{arguments.join(' ')}"
-        end
-      end
-
-    end
-  end
-end