ronin 2.0.5 → 2.1.0

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

@@ -34,6 +34,7 @@ module Ronin
       #     -f, --file FILE                  Optional file to read values from
       #         --start IP                   Starting IP address
       #         --stop IP                    Stopping IP address
+      #     -s, --size                       Prints the size of the IP range
       #     -h, --help                       Print help information
       #
       # ## Arguments
@@ -68,6 +69,9 @@ module Ronin
                         @stop << ip
                       end
 
+        option :size, short: '-s',
+                      desc:  'Prints the size of the IP range'
+
         argument :ip_range, required: false,
                             repeats:  true,
                             desc:     'The IP Range to enumerate'
@@ -110,9 +114,7 @@ module Ronin
             @start.zip(@stop).each do |(start,stop)|
               range = Support::Network::IPRange::Range.new(start,stop)
 
-              range.each do |ip|
-                puts ip
-              end
+              process_ip_range(range)
             end
           else
             super(*ip_ranges)
@@ -122,13 +124,28 @@ module Ronin
         #
         # Processes an IP range.
         #
-        # @param [String] ip_range
+        # @param [String] string
         #
-        def process_value(ip_range)
-          ip_range = Support::Network::IPRange.new(ip_range)
+        def process_value(string)
+          range = Support::Network::IPRange.new(string)
+
+          process_ip_range(range)
+        end
 
-          ip_range.each do |ip|
-            puts ip
+        #
+        # Processes a parsed IP range object.
+        #
+        # @param [Ronin::Support::Network::IPRange,
+        #         Ronin::Support::Network::IPRange::Range] ip_range
+        #   The IP range to process.
+        #
+        def process_ip_range(ip_range)
+          if options[:size]
+            puts ip_range.size
+          else
+            ip_range.each do |ip|
+              puts ip
+            end
           end
         end
 

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

@@ -155,6 +155,8 @@ module Ronin
         argument :post, required: false,
                         desc: 'The port to connect to'
 
+        description 'A netcat clone command'
+
         man_page 'ronin-netcat.1'
 
         # The protocol to use.

data/lib/ronin/cli/commands/new/dns_listener.rb

@@ -0,0 +1,37 @@
+# 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/listener/cli/commands/new/dns'
+
+module Ronin
+  class CLI
+    module Commands
+      class New < Command
+        # An alias for `ronin-listener new dns`.
+        #
+        # @since 2.1.0
+        class DnsListener < Ronin::Listener::CLI::Commands::New::Dns
+
+          command_name 'dns-listener'
+
+        end
+      end
+    end
+  end
+end

data/lib/ronin/cli/commands/new/dns_proxy.rb

@@ -0,0 +1,99 @@
+# 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/generator'
+require 'ronin/root'
+
+module Ronin
+  class CLI
+    module Commands
+      class New < Command
+        #
+        # Creates a new [ronin-dns-proxy] script.
+        #
+        # [ronin-dns-proxy]: https://github.com/ronin-rb/ronin-dns-proxy#readme
+        #
+        # ## Usage
+        #
+        #     ronin new dns-proxy PATH
+        #
+        # ## Options
+        #
+        #     -H, --host IP                    The IP to listen on (Default: 127.0.0.1)
+        #     -p, --port PORT                  The port number to listen on (Default: 2345)
+        #     -h, --help                       Print help information
+        #
+        # ## Arguments
+        #
+        #     PATH                             The script file to create
+        #
+        # @since 2.1.0
+        #
+        class DnsProxy < Command
+
+          include Core::CLI::Generator
+
+          template_dir File.join(ROOT,'data','templates')
+
+          command_name 'dns-proxy'
+
+          usage 'PATH'
+
+          option :host, short: '-H',
+                        value: {
+                          type:    String,
+                          usage:   'IP',
+                          default: '127.0.0.1'
+                        },
+                        desc: 'The IP to listen on'
+
+          option :port, short: '-p',
+                        value: {
+                          type:    Integer,
+                          usage:   'PORT',
+                          default: 2345
+                        },
+                        desc: 'The port number to listen on'
+
+          argument :path, required: true,
+                          desc:     'The script file to create'
+
+          description 'Creates a new ronin-dns-proxy script'
+
+          man_page 'ronin-new-dns-proxy.1'
+
+          #
+          # Runs the `ronin new dns-proxy` command.
+          #
+          # @param [String] path
+          #   The path to the new script file to create.
+          #
+          def run(path)
+            @host = options[:host]
+            @port = options[:port]
+
+            erb 'dns_proxy.rb.erb', path
+            chmod '+x', path
+          end
+
+        end
+      end
+    end
+  end
+end

data/lib/ronin/cli/commands/new/exploit.rb

@@ -0,0 +1,34 @@
+# 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/exploits/cli/commands/new'
+
+module Ronin
+  class CLI
+    module Commands
+      class New < Command
+        # An alias for `ronin-exploits new`.
+        #
+        # @since 2.1.0
+        class Exploit < Ronin::Exploits::CLI::Commands::New
+        end
+      end
+    end
+  end
+end

data/lib/ronin/cli/commands/new/http_listener.rb

@@ -0,0 +1,37 @@
+# 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/listener/cli/commands/new/http'
+
+module Ronin
+  class CLI
+    module Commands
+      class New < Command
+        # An alias for `ronin-listener new http`.
+        #
+        # @since 2.1.0
+        class HttpListener < Ronin::Listener::CLI::Commands::New::Http
+
+          command_name 'http-listener'
+
+        end
+      end
+    end
+  end
+end

data/lib/ronin/cli/commands/new/nokogiri.rb

@@ -0,0 +1,33 @@
+# 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/web/cli/commands/new/nokogiri'
+
+module Ronin
+  class CLI
+    module Commands
+      class New < Command
+        # An alias for `ronin-web new nokogiri`.
+        #
+        # @since 2.1.0
+        Nokogiri = Ronin::Web::CLI::Commands::New::Nokogiri
+      end
+    end
+  end
+end

data/lib/ronin/cli/commands/new/payload.rb

@@ -0,0 +1,34 @@
+# 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/payloads/cli/commands/new'
+
+module Ronin
+  class CLI
+    module Commands
+      class New < Command
+        # An alias for `ronin-payloads new`.
+        #
+        # @since 2.1.0
+        class Payload < Ronin::Payloads::CLI::Commands::New
+        end
+      end
+    end
+  end
+end

data/lib/ronin/cli/commands/new/project.rb

@@ -47,7 +47,7 @@ module Ronin
 
           include Core::CLI::Generator
 
-          template_dir File.join(ROOT,'data','new','project')
+          template_dir File.join(ROOT,'data','templates','project')
 
           usage '[options] DIR'
 

data/lib/ronin/cli/commands/new/script.rb

@@ -39,7 +39,7 @@ module Ronin
 
           include Core::CLI::Generator
 
-          template_dir File.join(ROOT,'data','new')
+          template_dir File.join(ROOT,'data','templates')
 
           usage 'PATH'
 

data/lib/ronin/cli/commands/new/web_app.rb

@@ -0,0 +1,37 @@
+# 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/web/cli/commands/new/app'
+
+module Ronin
+  class CLI
+    module Commands
+      class New < Command
+        # An alias for `ronin-web new app`.
+        #
+        # @since 2.1.0
+        class WebApp < Ronin::Web::CLI::Commands::New::App
+
+          command_name 'web-app'
+
+        end
+      end
+    end
+  end
+end

data/lib/ronin/cli/commands/new/web_server.rb

@@ -0,0 +1,37 @@
+# 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/web/cli/commands/new/server'
+
+module Ronin
+  class CLI
+    module Commands
+      class New < Command
+        # An alias for `ronin-web new server`.
+        #
+        # @since 2.1.0
+        class WebServer < Ronin::Web::CLI::Commands::New::Server
+
+          command_name 'web-server'
+
+        end
+      end
+    end
+  end
+end

data/lib/ronin/cli/commands/new/web_spider.rb

@@ -0,0 +1,37 @@
+# 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/web/cli/commands/new/spider'
+
+module Ronin
+  class CLI
+    module Commands
+      class New < Command
+        # An alias for `ronin-web new spider`.
+        #
+        # @since 2.1.0
+        class WebSpider < Ronin::Web::CLI::Commands::New::Spider
+
+          command_name 'web-spider'
+
+        end
+      end
+    end
+  end
+end

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

@@ -23,7 +23,7 @@ module Ronin
   class CLI
     module Commands
       #
-      # Creates new projects or scripts.
+      # Creates new Ruby projects or scripts.
       #
       # ## Usage
       #
@@ -57,6 +57,8 @@ module Ronin
           'script foo.rb'
         ]
 
+        description 'Creates a new Ruby project or a script'
+
         man_page 'ronin-new.1'
 
       end