ronin 1.5.1 → 2.0.0.beta1

data/lib/ronin/cli/commands/iprange.rb

@@ -0,0 +1,138 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2006-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# Ronin 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 3 of the License, or
+# (at your option) any later version.
+#
+# Ronin 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 Ronin.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+require 'ronin/cli/value_processor_command'
+require 'ronin/support/network/ip_range'
+
+module Ronin
+  class CLI
+    module Commands
+      #
+      # Enumerates over the IP ranges.
+      #
+      # ## Usage
+      #
+      #     ronin iprange [options] [IP_RANGE ... | --start IP --stop IP]
+      #
+      # ## Options
+      #
+      #     -f, --file FILE                  Optional file to read values from
+      #         --start IP                   Starting IP address
+      #         --stop IP                    Stopping IP address
+      #     -h, --help                       Print help information
+      #
+      # ## Arguments
+      #
+      #    [IP_RANGE ...]                   The IP Range to enumerate
+      #
+      # ## Examples
+      #
+      #    ronin iprange 1.1.1.0/24
+      #    ronin iprange 1.1.1.*
+      #    ronin iprange 1.1.2-4.10-50
+      #    ronin iprange --start 1.1.1.10 --stop 1.1.4.100
+      #    ronin iprange --file list.txt
+      # 
+      class Iprange < ValueProcessorCommand
+
+        usage '[options] [IP_RANGE ... | --start IP --stop IP]'
+
+        option :start, value: {
+                         type: String,
+                         usage: 'IP'
+                       },
+                       desc: 'Starting IP address' do |ip|
+                         @start << ip
+                       end
+
+        option :stop, value: {
+                        type: String,
+                        usage: 'IP'
+                      },
+                      desc: 'Stopping IP address' do |ip|
+                        @stop << ip
+                      end
+
+        argument :ip_range, required: false,
+                            repeats:  true,
+                            desc:     'The IP Range to enumerate'
+
+        description 'Enumerates over IP ranges'
+
+        examples [
+          "1.1.1.0/24",
+          "1.1.1.*",
+          "1.1.2-4.10-50",
+          "--start 1.1.1.10 --stop 1.1.4.100",
+          "--input list.txt"
+        ]
+
+        man_page 'ronin-iprange.1'
+
+        #
+        # Initializes the `ronin iprange` command.
+        #
+        def initialize(**kwargs)
+          super(**kwargs)
+
+          @start = []
+          @stop  = []
+        end
+
+        #
+        # Runs the `ronin iprange` command.
+        #
+        # @param [Array<String>] ip_ranges
+        #   Optional list of IP ranges to enumerate.
+        #
+        def run(*ip_ranges)
+          if !@start.empty? && !@stop.empty?
+            unless @start.length == @stop.length
+              print_error "must specify an equal number of --start and --stop options"
+              exit -1
+            end
+
+            @start.zip(@stop).each do |(start,stop)|
+              range = Support::Network::IPRange::Range.new(start,stop)
+
+              range.each do |ip|
+                puts ip
+              end
+            end
+          else
+            super(*ip_ranges)
+          end
+        end
+
+        #
+        # Processes an IP range.
+        #
+        # @param [String] ip_range
+        #
+        def process_value(ip_range)
+          ip_range = Support::Network::IPRange.new(ip_range)
+
+          ip_range.each do |ip|
+            puts ip
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/ronin/cli/commands/irb.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2006-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# Ronin 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 3 of the License, or
+# (at your option) any later version.
+#
+# Ronin 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 Ronin.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+require 'ronin/cli/command'
+require 'ronin/core/cli/ruby_shell'
+
+module Ronin
+  class CLI
+    module Commands
+      #
+      # Starts ronin's interactive Ruby shell.
+      #
+      # ## Usage
+      #
+      #     ronin irb [options]
+      #
+      # ## Options
+      #     -I, --include DIR                Directory to add to $LOAD_PATH
+      #     -r, --require PATH               Ruby files to require
+      #     -h, --help                       Print help information
+      #
+      class Irb < Command
+
+        option :include, short: '-I',
+                         value: {
+                           type: String,
+                           usage: 'DIR'
+                         },
+                         desc: 'Directory to add to $LOAD_PATH' do |dir|
+                           @include_dirs << dir
+                         end
+
+        option :require, short: '-r',
+                         value: {
+                           type:  String,
+                           usage: 'PATH'
+                         },
+                         desc: 'Ruby files to require' do |path|
+                           @require_paths << path
+                         end
+
+        description "Start ronin's interactive Ruby shell"
+
+        man_page 'ronin-irb.1'
+
+        # The additional directories to add to `$LOAD_PATH`.
+        #
+        # @return [Array<String>]
+        attr_reader :include_dirs
+
+        # The additional paths to require before starting the Ruby shell.
+        #
+        # @return [Array<String>]
+        attr_reader :require_paths
+
+        #
+        # Initializes the {Irb} command.
+        #
+        # @param [Array<String>] include_dirs
+        #   Optional Array of directories to add to `$LOAD_PATH`.
+        #
+        # @param [Array<String>] require_paths
+        #   Optional Array of paths to require before starting the Ruby shell.
+        #
+        def initialize(include_dirs: [], require_paths: [], **kwargs)
+          super(**kwargs)
+
+          @include_dirs  = include_dirs
+          @require_paths = require_paths
+        end
+
+        #
+        # Runs the `ronin irb` command.
+        #
+        def run(*argv)
+          @include_dirs.each do |dir|
+            $LOAD_PATH.unshift(dir)
+          end
+
+          @require_paths.each do |path|
+            require(path)
+          end
+
+          require 'ronin'
+          Core::CLI::RubyShell.start(context: Ronin)
+        end
+
+      end
+    end
+  end
+end

data/lib/ronin/cli/commands/md5.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2006-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# Ronin 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 3 of the License, or
+# (at your option) any later version.
+#
+# Ronin 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 Ronin.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+require 'ronin/cli/string_processor_command'
+
+require 'digest'
+
+module Ronin
+  class CLI
+    module Commands
+      #
+      # Calculates MD5 hashes of data.
+      #
+      # ## Usage
+      #
+      #     ronin md5 [options] [FILE ...]
+      #
+      # ## Options
+      #
+      #     -f, --file FILE                  Optional file to process
+      #         --string STRING              Optional string to process
+      #     -M, --multiline                  Process each line separately
+      #     -n, --keep-newlines              Preserves newlines at the end of each line
+      #     -h, --help                       Print help information
+      #
+      # ## Arguments
+      #
+      #     [FILE ...]                       Optional file(s) to process
+      #
+      class Md5 < StringProcessorCommand
+
+        description "Calculates MD5 hashes of data"
+
+        man_page 'ronin-md5.1'
+
+        #
+        # Computes a MD5 checksum for the given String.
+        #
+        # @param [String] string
+        #   The input string.
+        #
+        # @return [String]
+        #   The MD5 hexdigest of the given String.
+        #
+        def process_string(string)
+          Digest::MD5.hexdigest(string)
+        end
+
+      end
+    end
+  end
+end