ronin-core 0.1.2 → 0.2.0.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3559cfe4b363098b635feda4b7683bf8daaadc472930dfc6cf4dba201377d268
-  data.tar.gz: 7ed63d78b2e76011337af47250d4c672d25ee95a9e0e8a8cecdb21c0217c8a6d
+  metadata.gz: 1cf7fd888aed1c83850fa7dcb18a6122de9e192272f111ce2fdc933fd463a4bb
+  data.tar.gz: 5b8cc281734f00f55be809eb46588233356e9209181981d6790fe2d028dfa144
 SHA512:
-  metadata.gz: a9871e52ebff905fb72779c9aeac53001fdea14257e40ac2b03b628d8a5996636e703faf529149b37a2207c19c84b3726bf9481ae7aa2f4dd078d802db0d25fe
-  data.tar.gz: 5e1e9ce2f010510f948577ff6e24328a1d0e1191ddd1ba51485a61cb6580073f4fbd514125bda1cc1895be6b48f2dd8fde6204a75ac580e4ee59a9c9d97ae589
+  metadata.gz: fb0eb0cfc052476dae0931b2a0860b6dfd68938a8d2ca7bbe73d62f77fdec3d13322a75f3d59a3fe2723554508e26af779dc3eb6e8c6a39c98adee6f65c78cfa
+  data.tar.gz: 619061f0b74ad0e03352d0d6a4b84081334f01cf100037b2366a7dad1f6d056a353dd4104bc9e2a90adb56b356751bbd7a67a577607f4ab9a70bbd04fdffa185

data/.github/workflows/ruby.yml

@@ -12,11 +12,12 @@ jobs:
           - '3.0'
           - '3.1'
           - '3.2'
+          - '3.3'
           - jruby
           - truffleruby
     name: Ruby ${{ matrix.ruby }}
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
@@ -31,7 +32,7 @@ jobs:
   rubocop:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:

data/.rubocop.yml

@@ -21,3 +21,5 @@ Style/GlobalStdStream:
     - 'lib/ronin/core/cli/ruby_shell.rb'
     - 'spec/cli/ruby_shell_spec.rb'
 
+Layout/HeredocIndentation: { Exclude: ['lib/ronin/core/cli/banner.rb'] }
+Layout/ClosingHeredocIndentation: { Exclude: ['lib/ronin/core/cli/banner.rb'] }

data/ChangeLog.md

@@ -1,3 +1,32 @@
+### 0.2.0 / 2024-XX-XX
+
+* Require [command_kit] ~> 0.5.
+* Added the `mastodon:` keyword argument to {Ronin::Core::Metadata::Authors::ClassMethods#author}.
+* Added {Ronin::Core::Metadata::Authors::Author#mastodon}.
+* Added {Ronin::Core::Metadata::Authors::Author#mastodon_url}.
+* Added {Ronin::Core::OutputFormats}.
+* Added {Ronin::Core::OutputFormats::OutputFile}.
+* Added {Ronin::Core::OutputFormats::OutputDir}.
+* Added {Ronin::Core::System}.
+* Added {Ronin::Core::CLI::Banner}.
+* Added {Ronin::Core::CLI::Help::Banner}.
+* Added {Ronin::Core::CLI::CompletionCommand}.
+* Added {Ronin::Core::CLI::Printing::Params#param_usage}.
+* Print the new ASCII art banner in {Ronin::Core::CLI::RubyShell#start} and
+  {Ronin::Core::CLI::Shell.start}.
+* Added a default `quit` command to {Ronin::Core::CLI::CommandShell}.
+* Print the author's Mastodon profile URL in
+  {Ronin::Core::CLI::Printing::Metadata}.
+* Change the formatting of {Ronin::Core::CLI::Logging#log_warn} to output
+  ANSI bold-bright-yellow.
+* Change the formatting of {Ronin::Core::CLI::Logging#log_error} to output
+  ANSI bold-bright-red.
+
+### 0.1.3 / 2024-06-19
+
+* Improved {Ronin::Core::ClassRegistry::ClassMethods#load_class_from_file}
+  to handle returning the class when the file has already been loaded.
+
 ### 0.1.2 / 2023-07-18
 
 #### CLI
@@ -26,3 +55,4 @@
     shells.
   * Provides a `Params` API for adding user configurable parameters to classes.
 
+[command_kit]: https://github.com/postmodern/command_kit.rb#readme

data/Gemfile

@@ -7,7 +7,7 @@ platform :jruby do
   gem 'jruby-openssl',	'~> 0.7'
 end
 
-# gem 'command_kit', '~> 0.4', github: 'postmodern/command_kit.rb',
+# gem 'command_kit', '~> 0.5', github: 'postmodern/command_kit.rb',
 #                              branch: 'main'
 
 group :development do

data/README.md

@@ -9,7 +9,6 @@
 * [Issues](https://github.com/ronin-rb/ronin-core/issues)
 * [Documentation](https://ronin-rb.dev/docs/ronin-core/frames)
 * [Discord](https://discord.gg/6WAb3PsVX9) |
-  [Twitter](https://twitter.com/ronin_rb) |
   [Mastodon](https://infosec.exchange/@ronin_rb)
 
 ## Description
@@ -36,7 +35,7 @@ and development.
 
 * [Ruby] >= 3.0.0
 * [reline] ~> 0.1
-* [command_kit] ~> 0.4
+* [command_kit] ~> 0.5
 * [irb] ~> 1.0
 
 ## Install
@@ -275,7 +274,7 @@ http> post /foo var=bar
 
 ## License
 
-Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3@gmail.com)
+Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3@gmail.com)
 
 ronin-core is free software: you can redistribute it and/or modify
 it under the terms of the GNU Lesser General Public License as published

data/gemspec.yml

@@ -21,7 +21,7 @@ required_ruby_version: ">= 3.0.0"
 
 dependencies:
   reline: ~> 0.1
-  command_kit: ~> 0.4
+  command_kit: ~> 0.5
   irb: ~> 1.0
 
 development_dependencies:

data/lib/ronin/core/class_registry.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-core is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
@@ -190,17 +190,15 @@ module Ronin
             raise(ClassNotFound,"no such file or directory: #{file.inspect}")
           end
 
-          previous_entries = registry.keys
-
           require(file)
 
-          new_entries = registry.keys - previous_entries
+          registry.each_value do |worker_class|
+            class_file, = worker_class.const_source_location(worker_class.name)
 
-          if new_entries.empty?
-            raise(ClassNotFound,"file did not register a class: #{file.inspect}")
+            return worker_class if class_file == file
           end
 
-          return registry[new_entries.last]
+          raise(ClassNotFound,"file did not register a class: #{file.inspect}")
         end
 
         #
@@ -231,6 +229,7 @@ module Ronin
           end
 
           previous_entries = registry.keys
+
           require(path)
 
           unless (klass = registry[id])

data/lib/ronin/core/cli/banner.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# ronin-core 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-core 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-core.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+module Ronin
+  module Core
+    module CLI
+      #
+      # Adds a Ronin ASCII art banner to the `--help` output.
+      #
+      # @since 0.2.0
+      #
+      module Banner
+        # Ronin ASCII art banner.
+        BANNER = <<~ASCII
+                                                                   , Jµ     ▓▓█▓
+                                                  J▌      ▐▓██▌ ████ ██    ▐███D
+                                      ╓▄▓▓█████▌  ██µ     ████ ▄███ÖJ██▌   ███▌
+        ,╓µ▄▄▄▄▄▄▄▄µ;,            ,▄▓██████████  ▐███    ▐███▀ ███▌ ████µ ▄███
+¬∞MÆ▓███████████████████████▓M  ▄██████▀▀╙████▌  ████▌   ████ ▄███ J█████ ███▌
+           `█████▀▀▀▀▀███████  -████▀└    ████  ▐█████n ▄███O ███▌ ██████████
+           ▓████L       ████▀  ▓████     ▓███Ö  ███████ ███▌ ▓███ ▐█████████▀
+          ▄████▀  ,╓▄▄▄█████  J████Ü    ,███▌  ▄███████████ J███▀ ████ █████
+         J█████████████████─  ████▌     ████   ████`██████▌ ████ ▐███Ü ▐███Ü
+         ███████████▀▀▀╙└    ▐████     J███▌  ▓███▌ ²█████ J███Ü ███▌   ▀█▌
+        ▓██████████▌         ████▌     ████  ;████   ▀███▀ ███▌ J▀▀▀-    █
+       ▄█████▀ ▀█████µ      ▐████  ,▄▓████▀  ████▀    ███ J███           `
+      J█████-    ╙▀███▄     ████████████▀╙  J█▀▀▀      █U  ▀█▌
+      ████▀         ▀███   ▄████████▀▀                 ╨    █
+     ▓██▀             ²▀█▄ █▀▀▀╙└
+    ▄██╜                 ╙W
+   J█▀
+   ▌└
+  ┘
+ASCII
+
+        #
+        # Prints the Ronin banner.
+        #
+        def print_banner
+          print "#{BANNER}#{$/}"
+        end
+      end
+    end
+  end
+end

data/lib/ronin/core/cli/command.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-core is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/core/cli/command_shell/command.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-core is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/core/cli/command_shell.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-core is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
@@ -246,6 +246,17 @@ module Ronin
           end
         end
 
+        command :quit, summary: 'Exits the shell'
+
+        #
+        # Quits the shell.
+        #
+        # @since 0.2.0
+        #
+        def quit
+          exit
+        end
+
         private
 
         #

data/lib/ronin/core/cli/completion_command.rb

@@ -0,0 +1,204 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# ronin-core 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-core 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-core.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+require 'ronin/core/cli/command'
+
+require 'command_kit/completion/install'
+
+module Ronin
+  module Core
+    module CLI
+      #
+      # Common base class for all `ronin-* completion` commands.
+      #
+      # ## Example
+      #
+      #     # lib/ronin/foo/cli/commands/completion.rb
+      #     require 'ronin/foo/root'
+      #     require 'ronin/core/cli/completion_command'
+      #
+      #     module Ronin
+      #       module Foo
+      #         class CLI
+      #           class Command < Core::CLI::CompletionCommand
+      #
+      #             man_dir File.join(ROOT,'man')
+      #             man_page 'ronin-foo-completion.1'
+      #
+      #             completion_file File.join(ROOT,'data','completions','ronin-foo')
+      #
+      #           end
+      #         end
+      #       end
+      #     end
+      #
+      # @api semipublic
+      #
+      # @since 0.2.0
+      #
+      class CompletionCommand < Command
+
+        include CommandKit::Completion::Install
+
+        #
+        # Gets or sets the completion file for the `completion` command.
+        #
+        # @param [String, nil] new_completion_file
+        #   The optional path to the completion file.
+        #
+        # @return [String]
+        #   The completion file path.
+        #
+        # @raise [NotImplementedError]
+        #   The command did not set the `completion_file`.
+        #
+        # @example
+        #   completion_file File.join(ROOT,'data','completions','ronin-foo')
+        #
+        def self.completion_file(new_completion_file=nil)
+          if new_completion_file
+            @completion_file = new_completion_file
+          else
+            @completion_file || raise(NotImplementedError,"#{self} did not set completion_file")
+          end
+        end
+
+        command_name 'completion'
+
+        option :print, desc: 'Prints the shell completion file' do
+          @mode = :print
+        end
+
+        option :install, desc: 'Installs the shell completion file' do
+          @mode = :install
+        end
+
+        option :uninstall, desc: 'Uninstalls the shell completion file' do
+          @mode = :uninstall
+        end
+
+        examples [
+          '--print',
+          '--install',
+          '--uninstall'
+        ]
+
+        bug_report_url 'https://github.com/ronin-rb/ronin-core/issues/new'
+
+        # The command mode.
+        #
+        # @return [:print, :install, :uninstall]
+        attr_reader :mode
+
+        #
+        # Initializes the `completion` command.
+        #
+        # @param [Hash{Symbol => Object}] kwargs
+        #   Additional keyword arguments for the command.
+        #
+        def initialize(**kwargs)
+          super(**kwargs)
+
+          @mode = :print
+        end
+
+        #
+        # The `completion` commands registered completion file.
+        #
+        # @return [String]
+        #   The completion file path.
+        #
+        # @raise [NotImplementedError]
+        #   The command did not set the `completion_file`.
+        #
+        def completion_file
+          self.class.completion_file
+        end
+
+        #
+        # Runs the `completion` command.
+        #
+        def run
+          if shell_type == :fish
+            print_error "shell completions for the fish shell are not currently supported"
+            exit(-1)
+          end
+
+          case @mode
+          when :print
+            print_completion_file
+          when :install
+            install_completion_file
+
+            if shell_type == :zsh
+              puts "Ensure that you have the following lines added to your ~/.zshrc:"
+              puts
+              puts "    autoload -Uz +X compinit && compinit"
+              puts "    autoload -Uz +X bashcompinit && bashcompinit"
+              puts
+            end
+          when :uninstall
+            uninstall_completion_file
+
+            puts "Completion rules successfully uninstalled. Please restart your shell."
+          else
+            raise(NotImplementedError,"mode not implemented: #{@mode.inspect}")
+          end
+        end
+
+        #
+        # Prints the `completion` command's {completion_file} to stdout.
+        #
+        # @param [String] completion_file
+        #   The path to the completion file to print.
+        #
+        # @api private
+        #
+        def print_completion_file(completion_file=self.completion_file)
+          super(completion_file)
+        end
+
+        #
+        # Installs the `completion` command's {completion_file} for the current
+        # `SHELL`.
+        #
+        # @param [String] completion_file
+        #   The path to the completion file to install.
+        #
+        # @api private
+        #
+        def install_completion_file(completion_file=self.completion_file)
+          super(completion_file)
+        end
+
+        #
+        # Uninstalls the `completion` command's {completion_file}.
+        #
+        # @param [String] completion_file
+        #   The path to the completion file to uninstall.
+        #
+        # @api private
+        #
+        def uninstall_completion_file(completion_file=self.completion_file)
+          uninstall_completion_file_for(File.basename(completion_file))
+        end
+
+      end
+    end
+  end
+end

data/lib/ronin/core/cli/generator/options/author.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-core is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/core/cli/generator/options/description.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-core is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/core/cli/generator/options/reference.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-core is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/core/cli/generator/options/summary.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-core is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/core/cli/generator.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-core is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/core/cli/help/banner.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# ronin-core 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-core 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-core.  If not, see <https://www.gnu.org/licenses/>.
+#
+
+require 'ronin/core/cli/banner'
+
+module Ronin
+  module Core
+    module CLI
+      module Help
+        #
+        # Adds the Ronin ASCII art banner to the `--help` output.
+        #
+        # @since 0.2.0
+        #
+        module Banner
+          include CLI::Banner
+
+          #
+          # Prints the Ronin ASCII art banner and the `--help` output.
+          #
+          # @note
+          #   If `stdout` is not a TTY, the Ronin ASCII art banner will be
+          #   omitted.
+          #
+          def help
+            print_banner if stdout.tty?
+
+            super
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ronin/core/cli/logging.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-core is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
@@ -44,7 +44,7 @@ module Ronin
         #   The message to print.
         #
         def log_warn(message)
-          puts("#{colors.bold(colors.bright_yellow('***'))} #{colors.bold(colors.white(message))}")
+          puts("#{colors.bold(colors.bright_red('/!\\'))} #{colors.bold(colors.bright_yellow(message))}")
         end
 
         #
@@ -54,7 +54,7 @@ module Ronin
         #   The message to print.
         #
         def log_error(message)
-          stderr.puts("#{colors(stderr).bold(colors(stderr).bright_red('!!!'))} #{colors(stderr).bold(colors(stderr).white(message))}")
+          stderr.puts("#{colors(stderr).bold(colors(stderr).bright_red('!!!'))} #{colors(stderr).bold(colors(stderr).red(message))}")
         end
       end
     end

data/lib/ronin/core/cli/options/param.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # This file is part of ronin-core.
 #

data/lib/ronin/core/cli/options/values/arches.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-core is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/core/cli/options/values/oses.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-core is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/core/cli/printing/arch.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 #
-# Copyright (c) 2021-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2021-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-core is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published