pennyworth 10.0.1 → 11.0.0

data/lib/pennyworth/cli/actions/system/errors.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module CLI
+    module Actions
+      module System
+        # Handles the system errors action.
+        class Errors
+          def initialize processor: Processor.for_system_errors, container: Container
+            @processor = processor
+            @container = container
+          end
+
+          def call = processor.call.to_json.then { |json| logger.info json }
+
+          private
+
+          attr_reader :processor, :container
+
+          def logger = container[__method__]
+        end
+      end
+    end
+  end
+end

data/lib/pennyworth/cli/actions/system/signals.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module CLI
+    module Actions
+      module System
+        # Handles the signal action.
+        class Signals
+          def initialize processor: Processor.for_system_signals, container: Container
+            @processor = processor
+            @container = container
+          end
+
+          def call = processor.call.to_json.then { |json| logger.info json }
+
+          private
+
+          attr_reader :processor, :container
+
+          def logger = container[__method__]
+        end
+      end
+    end
+  end
+end

data/lib/pennyworth/cli/actions/text.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module CLI
+    module Actions
+      # Handles the text action.
+      class Text
+        def initialize processor: Processor.for_text, container: Container
+          @processor = processor
+          @container = container
+        end
+
+        def call(content) = processor.call(content).to_json.then { |json| logger.info json }
+
+        private
+
+        attr_reader :processor, :container
+
+        def logger = container[__method__]
+      end
+    end
+  end
+end

data/lib/pennyworth/cli/configuration/content.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module CLI
+    module Configuration
+      # Defines configuration content as the primary source of truth for use throughout the gem.
+      Content = Struct.new :action_encodings,
+                           :action_git_hub,
+                           :action_http_statuses,
+                           :action_ruby_gems,
+                           :action_system_errors,
+                           :action_system_signals,
+                           :action_text,
+                           :action_config,
+                           :action_version,
+                           :action_help,
+                           :alfred_preferences,
+                           :inflections,
+                           :git_hub_api_url,
+                           :git_hub_organization,
+                           :git_hub_user,
+                           :http_statuses_url,
+                           :ruby_gems_api_url,
+                           :ruby_gems_owner,
+                           keyword_init: true
+    end
+  end
+end

data/lib/pennyworth/cli/configuration/defaults.yml

@@ -0,0 +1,25 @@
+:alfred:
+  :preferences:
+:inflections:
+  - "Bkuhlmann": "bkuhlmann"
+  - "Dry Auto Inject": "Dry AutoInject"
+  - "Dry Cli": "Dry CLI"
+  - "Flacsmith": "FLACsmith"
+  - "Git Plus": "Git+"
+  - "Mac Os Config": "macOS Configuration"
+  - "Mac Os": "MacOS"
+  - "Prawn Plus": "Prawn+"
+  - "Rubocop Ast": "Rubocop  AST"
+  - "Rubocop Md": "Rubocop  Markdown"
+  - "Rubocop Rspec": "Rubocop RSpec"
+  - "Xdg": "XDG"
+:git_hub:
+  :api_url: "https://api.github.com"
+  :organization:
+  :user:
+:http:
+  :statuses:
+    :url: "https://httpstatuses.com"
+:ruby_gems:
+  :api_url: "https://rubygems.org/api/v1"
+  :owner:

data/lib/pennyworth/cli/configuration/loader.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "pathname"
+require "refinements/hashes"
+require "refinements/structs"
+require "runcom"
+require "yaml"
+
+module Pennyworth
+  module CLI
+    module Configuration
+      # Represents the fully assembled Command Line Interface (CLI) configuration.
+      class Loader
+        using Refinements::Hashes
+        using Refinements::Structs
+
+        DEFAULTS = YAML.load_file(Pathname(__dir__).join("defaults.yml")).freeze
+        HANDLER = Runcom::Config.new "#{Identity::NAME}/configuration.yml", defaults: DEFAULTS
+
+        def self.call = new.call
+
+        def self.with_defaults = new(handler: DEFAULTS)
+
+        def initialize content: Content.new, handler: HANDLER
+          @content = content
+          @handler = handler
+        end
+
+        def call = content.merge(**handler.to_h.flatten_keys)
+
+        private
+
+        attr_reader :content, :handler
+      end
+    end
+  end
+end

data/lib/pennyworth/cli/parsers.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require "optparse"
+
+module Pennyworth
+  module CLI
+    module Parsers
+      CLIENT = OptionParser.new nil, 40, "  "
+    end
+  end
+end

data/lib/pennyworth/cli/parsers/assembler.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module CLI
+    module Parsers
+      SECTIONS = [Core, GitHub, RubyGems].freeze # Order is important.
+
+      # Assembles and parses all Command Line Interface (CLI) options.
+      class Assembler
+        def initialize configuration = CLI::Configuration::Loader.call,
+                       sections: SECTIONS,
+                       client: CLIENT
+          @configuration = configuration
+          @sections = sections
+          @client = client
+        end
+
+        def call arguments = []
+          sections.each { |parser| parser.call configuration, client: client }
+          client.parse! arguments
+          configuration
+        end
+
+        def to_s = client.to_s
+
+        private
+
+        attr_reader :configuration, :client, :sections
+      end
+    end
+  end
+end

data/lib/pennyworth/cli/parsers/core.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+require "refinements/structs"
+
+module Pennyworth
+  module CLI
+    # Handles parsing of Command Line Interface (CLI) primary options.
+    module Parsers
+      using Refinements::Structs
+
+      # Handles parsing of Command Line Interface (CLI) core options.
+      class Core
+        def self.call(...) = new(...).call
+
+        def initialize configuration = Configuration::Loader.call, client: CLIENT
+          @configuration = configuration
+          @client = client
+        end
+
+        def call arguments = []
+          client.banner = "#{Identity::LABEL} - #{Identity::SUMMARY}"
+          client.separator "\nUSAGE:\n"
+          collate
+          arguments.empty? ? arguments : client.parse!(arguments)
+        end
+
+        private
+
+        attr_reader :configuration, :client
+
+        def collate = private_methods.sort.grep(/add_/).each { |method| __send__ method }
+
+        def add_config
+          client.on(
+            "-c",
+            "--config ACTION",
+            %i[edit view],
+            "Manage gem configuration. Actions: edit || view."
+          ) do |action|
+            configuration.action_config = action
+          end
+        end
+
+        def add_encodings
+          client.on "--encodings", "Render Alfred encodings script filter." do
+            configuration.action_encodings = true
+          end
+        end
+
+        def add_git_hub
+          client.on "--git_hub", "Render Alfred GitHub repositories script filter." do
+            configuration.action_git_hub = true
+          end
+        end
+
+        def add_http_statuses
+          client.on "--http_statuses", "Render Alfred HTTP statuses script filter." do
+            configuration.action_http_statuses = true
+          end
+        end
+
+        def add_ruby_gems
+          client.on "--ruby_gems", "Render Alfred RubyGems script filter." do
+            configuration.action_ruby_gems = true
+          end
+        end
+
+        def add_system_errors
+          client.on "--system_errors", "Render Alfred system errors script filter." do
+            configuration.action_system_errors = true
+          end
+        end
+
+        def add_system_signals
+          client.on "--system_signals", "Render Alfred system signals script filter." do
+            configuration.action_system_signals = true
+          end
+        end
+
+        def add_text
+          client.on "--text CONTENT", "Render Alfred text script filter." do |content|
+            configuration.action_text = content
+          end
+        end
+
+        def add_version
+          client.on "-v", "--version", "Show gem version." do
+            configuration.action_version = Identity::VERSION_LABEL
+          end
+        end
+
+        def add_help
+          client.on "-h", "--help", "Show this message." do
+            configuration.action_help = true
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pennyworth/cli/parsers/git_hub.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require "refinements/structs"
+
+module Pennyworth
+  module CLI
+    module Parsers
+      # Handles parsing of Command Line Interface (CLI) GitHub options.
+      class GitHub
+        using Refinements::Structs
+
+        def self.call(...) = new(...).call
+
+        def initialize configuration = Configuration::Loader.call, client: CLIENT
+          @configuration = configuration
+          @client = client
+        end
+
+        def call arguments = []
+          client.separator "\nGITHUB OPTIONS:\n"
+          private_methods.sort.grep(/add_/).each { |method| __send__ method }
+          arguments.empty? ? arguments : client.parse!(arguments)
+        end
+
+        private
+
+        attr_reader :configuration, :client
+
+        def add_organization
+          client.on(
+            "--organization [HANDLE]",
+            %(Set organization. Default: "#{organization}".)
+          ) do |handle|
+            configuration.merge! action_git_hub: :organization,
+                                 git_hub_organization: handle || organization
+          end
+        end
+
+        def add_user
+          client.on "--user [HANDLE]", %(Set user. Default: "#{user}".) do |handle|
+            configuration.merge! action_git_hub: :user, git_hub_user: handle || user
+          end
+        end
+
+        def organization = configuration.git_hub_organization
+
+        def user = configuration.git_hub_user
+      end
+    end
+  end
+end

data/lib/pennyworth/cli/parsers/ruby_gems.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module CLI
+    module Parsers
+      # Handles parsing of Command Line Interface (CLI) RubyGems options.
+      class RubyGems
+        def self.call(...) = new(...).call
+
+        def initialize configuration = Configuration::Loader.call, client: CLIENT
+          @configuration = configuration
+          @client = client
+        end
+
+        def call arguments = []
+          client.separator "\nRUBYGEMS OPTIONS:\n"
+          add_owner
+          arguments.empty? ? arguments : client.parse!(arguments)
+        end
+
+        private
+
+        attr_reader :configuration, :client
+
+        def add_owner
+          client.on "--owner [HANDLE]", %(Set owner. Default: "#{owner}".) do |handle|
+            configuration.ruby_gems_owner = handle || owner
+          end
+        end
+
+        def owner = configuration.ruby_gems_owner
+      end
+    end
+  end
+end

data/lib/pennyworth/cli/shell.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module CLI
+    # The main Command Line Interface (CLI) object.
+    class Shell
+      ACTIONS = {
+        config: Actions::Config.new,
+        encodings: Actions::Encodings.new,
+        git_hub: Actions::GitHub.new,
+        http_statuses: Actions::HTTPStatuses.new,
+        ruby_gems: Actions::RubyGems.new,
+        system_errors: Actions::System::Errors.new,
+        system_signals: Actions::System::Signals.new,
+        text: Actions::Text.new
+      }.freeze
+
+      def initialize parser: Parsers::Assembler.new, actions: ACTIONS, container: Container
+        @parser = parser
+        @actions = actions
+        @container = container
+      end
+
+      def call arguments = []
+        perform parser.call(arguments)
+      rescue OptionParser::ParseError, KeyError => error
+        logger.error error.message
+      end
+
+      private
+
+      attr_reader :parser, :actions, :container
+
+      # rubocop:disable Metrics/MethodLength
+      def perform configuration
+        case configuration
+          in action_config: Symbol => action then config action
+          in action_encodings: true then encodings
+          in action_git_hub: :organization then git_hub_organization configuration
+          in action_git_hub: :user then git_hub_user configuration
+          in action_http_statuses: true then http_statuses
+          in action_ruby_gems: true then ruby_gems configuration
+          in action_system_signals: true then system_signals
+          in action_system_errors: true then system_errors
+          in action_text: String => content then text content
+          in action_version: String => version then logger.info version
+          in action_help: then usage
+          else usage
+        end
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      def config(action) = actions.fetch(__method__).call(action)
+
+      def encodings = actions.fetch(__method__).call
+
+      def git_hub_organization configuration
+        actions.fetch(:git_hub).call("orgs/#{configuration.git_hub_organization}/repos")
+      end
+
+      def git_hub_user configuration
+        actions.fetch(:git_hub).call("users/#{configuration.git_hub_user}/repos")
+      end
+
+      def http_statuses = actions.fetch(__method__).call
+
+      def ruby_gems configuration
+        actions.fetch(__method__).call("owners/#{configuration.ruby_gems_owner}/gems.json")
+      end
+
+      def system_errors = actions.fetch(__method__).call
+
+      def system_signals = actions.fetch(__method__).call
+
+      def text(content) = actions.fetch(__method__).call(content)
+
+      def usage = logger.unknown { parser.to_s }
+
+      def logger = container[__method__]
+    end
+  end
+end