pennyworth 13.1.0 → 13.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c24c98e02da39dee6f713ef1b1253734352d176af5ee399ec430ab4b40ee24bb
-  data.tar.gz: 816ed741049d3923a606eebb7400c54d706d7a4a8dc77a79ca1681e4025611ba
+  metadata.gz: b3cebd285e4000aba774c716d9bc944fb6a836bf55170f0c33d9395497934f53
+  data.tar.gz: 8c5a01d3f6c905f48a87a1b8a493d8c6c5a3e1acf6a8ac9bfb4dec3bd6852b63
 SHA512:
-  metadata.gz: 9ec4dd5f71c8070a688b9f8cbe6014cd1e5541ab62a0a0238df07387ce09da2f197d028ec567cf17900cfc38b72d23b26898125f82a9c11884f40f053058681a
-  data.tar.gz: 1511e46c67c7e757f64bc8618753dd54a1971aa4f7af3d598eea32b74947fb06c9166d78408c426389be355c64980b82dc952e4a4ef0cba85e7820f394a7300d
+  metadata.gz: 6ec8f05dc8a522a668727544ae256c206479c9fb6066b93823f47a5c07d64fb83955377da0ee6bc5c487e173d3b86ecd9680a034efb1f90427df3fe3bf42f21e
+  data.tar.gz: 932346b9d5607c23daa7baf0fcb85bc7bc5e8afd4c4aed24d3f7dd5162ef795ff402fa83dd79c78ae75e1710c94efdd638fa49590eeab3f56fb648e021e30207

data/README.adoc

@@ -351,6 +351,23 @@ This keyword allows you to generate a repeating sequence of the same character(s
 Type `repeat` to activate and `ENTER` generate. You must supply the character(s) you want to repeat
 followed by a number indicating how many times you want the character(s) to repeat.
 
+===== Standard Errors
+
+image:https://www.alchemists.io/images/projects/pennyworth/screenshots/ruby-standard_errors.png[Standard Errors,width=706,height=632,role=focal_point]
+
+This keyword allows you to list all subclasses of `StandardError`. Due to the dynamic nature of how
+these subclasses are loaded, they are influenced by this gem's environment and dependencies which
+can be either too narrow or too verbose. This list also includes system errors which have a
+specialized workflow as described below. While this list can be long, it is alphabetically sorted
+for quick filtering when fuzzy typing.
+
+Type `stderr` to activate. Use `ENTER` to copy the subclass to clipboard, `CONTROL` to copy the
+error name, or `OPTION` to copy the source path.
+
+💡 The subclass source path might not always be available because not all subclasses are written in
+Ruby but C instead. That said, when the source path does exist, you'll get the full path plus line
+number in the format of `<source path>:<line number>` for easy loading within your editor of choice.
+
 ===== System Errors
 
 image:https://www.alchemists.io/images/projects/pennyworth/screenshots/ruby-system_errors.png[System Errors,width=706,height=632,role=focal_point]

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

@@ -18,6 +18,7 @@ module Pennyworth
         register(:git_hub) { GitHub.new }
         register(:http_statuses) { HTTPStatuses.new }
         register(:ruby_gems) { RubyGems.new }
+        register(:standard_errors) { StandardErrors.new }
         register(:system_errors) { System::Errors.new }
         register(:system_signals) { System::Signals.new }
         register(:text) { Text.new }

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

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module CLI
+    module Actions
+      # Handles the system errors action.
+      class StandardErrors
+        include Pennyworth::Import[:logger]
+
+        def initialize processor: Processor.for_standard_errors, **dependencies
+          super(**dependencies)
+          @processor = processor
+        end
+
+        def call = processor.call.to_json.then { |json| logger.info { json } }
+
+        private
+
+        attr_reader :processor
+      end
+    end
+  end
+end

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

@@ -71,6 +71,12 @@ module Pennyworth
           end
         end
 
+        def add_standard_errors
+          client.on "--standard_errors", "Render Alfred standard errors script filter." do
+            configuration.action_standard_errors = true
+          end
+        end
+
         def add_system_errors
           client.on "--system_errors", "Render Alfred system errors script filter." do
             configuration.action_system_errors = true

data/lib/pennyworth/cli/shell.rb

@@ -10,6 +10,7 @@ module Pennyworth
         :git_hub,
         :http_statuses,
         :ruby_gems,
+        :standard_errors,
         :system_errors,
         :system_signals,
         :text,
@@ -42,8 +43,9 @@ module Pennyworth
           in action_http_statuses: true then http_statuses.call
           in action_ruby_gems: true
             ruby_gems.call "owners/#{configuration.ruby_gems_owner}/gems.json"
-          in action_system_signals: true then system_signals.call
+          in action_standard_errors: true then standard_errors.call
           in action_system_errors: true then system_errors.call
+          in action_system_signals: true then system_signals.call
           in action_text: String => content then text.call content
           in action_version: true then logger.info { specification.labeled_version }
           else logger.any { parser.to_s }

data/lib/pennyworth/configuration/content.rb

@@ -8,6 +8,7 @@ module Pennyworth
       :action_git_hub,
       :action_http_statuses,
       :action_ruby_gems,
+      :action_standard_errors,
       :action_system_errors,
       :action_system_signals,
       :action_text,

data/lib/pennyworth/configuration/defaults.yml

@@ -6,6 +6,7 @@
   - "Dry Cli": "Dry CLI"
   - "Flacsmith": "FLACsmith"
   - "Git Plus": "Git+"
+  - "Http Fake": "HTTP Fake"
   - "Mac Os Config": "macOS Configuration"
   - "Mac Os": "MacOS"
   - "Prawn Plus": "Prawn+"

data/lib/pennyworth/loaders/standard_errors.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module Loaders
+    # Loads an array of standard error records.
+    class StandardErrors
+      def initialize root: StandardError, model: Models::StandardError
+        @root = root
+        @model = model
+      end
+
+      def call _omit = nil
+        ObjectSpace.each_object(Class)
+                   .select { |klass| klass < root }
+                   .sort_by(&:name)
+                   .map do |error|
+                     file_path, line_number = Object.const_source_location error.name
+                     model[name: error, file_path:, line_number:]
+                   end
+      end
+
+      private
+
+      attr_reader :root, :model
+    end
+  end
+end

data/lib/pennyworth/loaders/system/errors.rb

@@ -1,14 +1,10 @@
 # frozen_string_literal: true
 
-require "refinements/arrays"
-
 module Pennyworth
   module Loaders
     module System
       # Loads an array of system error records.
       class Errors
-        using Refinements::Arrays
-
         def initialize errno: Errno, model: Models::System::Error
           @errno = errno
           @model = model

data/lib/pennyworth/models/standard_error.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module Models
+    # Defines a standard error.
+    StandardError = Struct.new :name, :file_path, :line_number, keyword_init: true
+  end
+end

data/lib/pennyworth/presenters/standard_error.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "refinements/arrays"
+
+module Pennyworth
+  module Presenters
+    # Renders a standard error into a compatible format for use in Alfred script filters.
+    class StandardError
+      using Refinements::Arrays
+
+      def initialize record
+        @record = record
+      end
+
+      def id = label
+
+      def label = record.name.to_s
+
+      def path = file_path.empty? ? "" : [file_path, record.line_number].compress!.join(":")
+
+      private
+
+      attr_reader :record
+
+      def file_path = record.file_path.to_s
+    end
+  end
+end

data/lib/pennyworth/processor.rb

@@ -27,10 +27,10 @@ module Pennyworth
           serializer: Serializers::Project
     end
 
-    def self.for_system_signals
-      new loader: Loaders::System::Signals.new,
-          presenter: Presenters::System::Signal,
-          serializer: Serializers::System::Signal
+    def self.for_standard_errors
+      new loader: Loaders::StandardErrors.new,
+          presenter: Presenters::StandardError,
+          serializer: Serializers::StandardError
     end
 
     def self.for_system_errors
@@ -39,6 +39,12 @@ module Pennyworth
           serializer: Serializers::System::Error
     end
 
+    def self.for_system_signals
+      new loader: Loaders::System::Signals.new,
+          presenter: Presenters::System::Signal,
+          serializer: Serializers::System::Signal
+    end
+
     def self.for_text
       new loader: Loaders::Text.new, presenter: Presenters::Text, serializer: Serializers::Text
     end

data/lib/pennyworth/serializers/standard_error.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module Serializers
+    # Serializes a standard error into a compatible format for parsing within Alfred script filters.
+    class StandardError
+      def initialize presenter
+        @presenter = presenter
+      end
+
+      def to_h
+        {
+          uid: id,
+          title: id,
+          arg: label,
+          mods: modifications,
+          text: {copy: label, largetype: label}
+        }
+      end
+
+      private
+
+      attr_reader :presenter
+
+      def id = presenter.id
+
+      def label = presenter.label
+
+      def description = presenter.description
+
+      def modifications
+        {
+          control: {subtitle: "Copy label.", arg: label},
+          alt: {subtitle: "Copy path.", arg: path}
+        }
+      end
+
+      def path = presenter.path
+    end
+  end
+end

data/pennyworth.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "pennyworth"
-  spec.version = "13.1.0"
+  spec.version = "13.2.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://www.alchemists.io/projects/pennyworth"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pennyworth
 version: !ruby/object:Gem::Version
-  version: 13.1.0
+  version: 13.2.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -28,7 +28,7 @@ cert_chain:
   CxDe2+VuChj4I1nvIHdu+E6XoEVlanUPKmSg6nddhkKn2gC45Kyzh6FZqnzH/CRp
   RFE=
   -----END CERTIFICATE-----
-date: 2022-05-07 00:00:00.000000000 Z
+date: 2022-05-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: auto_injector
@@ -177,6 +177,7 @@ files:
 - lib/pennyworth/cli/actions/http_statuses.rb
 - lib/pennyworth/cli/actions/import.rb
 - lib/pennyworth/cli/actions/ruby_gems.rb
+- lib/pennyworth/cli/actions/standard_errors.rb
 - lib/pennyworth/cli/actions/system/errors.rb
 - lib/pennyworth/cli/actions/system/signals.rb
 - lib/pennyworth/cli/actions/text.rb
@@ -197,11 +198,13 @@ files:
 - lib/pennyworth/loaders/encodings.rb
 - lib/pennyworth/loaders/http_statuses.rb
 - lib/pennyworth/loaders/projects.rb
+- lib/pennyworth/loaders/standard_errors.rb
 - lib/pennyworth/loaders/system/errors.rb
 - lib/pennyworth/loaders/system/signals.rb
 - lib/pennyworth/loaders/text.rb
 - lib/pennyworth/models/encoding.rb
 - lib/pennyworth/models/http_status.rb
+- lib/pennyworth/models/standard_error.rb
 - lib/pennyworth/models/system/error.rb
 - lib/pennyworth/models/system/signal.rb
 - lib/pennyworth/models/text.rb
@@ -209,6 +212,7 @@ files:
 - lib/pennyworth/presenters/gem.rb
 - lib/pennyworth/presenters/http_status.rb
 - lib/pennyworth/presenters/repository.rb
+- lib/pennyworth/presenters/standard_error.rb
 - lib/pennyworth/presenters/system/error.rb
 - lib/pennyworth/presenters/system/signal.rb
 - lib/pennyworth/presenters/text.rb
@@ -216,6 +220,7 @@ files:
 - lib/pennyworth/serializers/encoding.rb
 - lib/pennyworth/serializers/http_status.rb
 - lib/pennyworth/serializers/project.rb
+- lib/pennyworth/serializers/standard_error.rb
 - lib/pennyworth/serializers/system/error.rb
 - lib/pennyworth/serializers/system/signal.rb
 - lib/pennyworth/serializers/text.rb