pennyworth 10.0.1 → 11.0.0

data/lib/pennyworth/container.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require "dry-container"
+require "logger"
+require "http"
+require "pastel"
+
+module Pennyworth
+  # Provides a global gem container for injection into other objects.
+  module Container
+    extend Dry::Container::Mixin
+
+    register(:configuration) { CLI::Configuration::Loader.call }
+    register(:environment) { ENV }
+    register(:kernel) { Kernel }
+    register(:http) { HTTP }
+    register(:colorizer) { Pastel.new enabled: $stdout.tty? }
+
+    register :log_colors do
+      {
+        "DEBUG" => self[:colorizer].white.detach,
+        "INFO" => self[:colorizer].green.detach,
+        "WARN" => self[:colorizer].yellow.detach,
+        "ERROR" => self[:colorizer].red.detach,
+        "FATAL" => self[:colorizer].white.bold.on_red.detach,
+        "ANY" => self[:colorizer].white.bold.detach
+      }
+    end
+
+    register :logger do
+      Logger.new $stdout,
+                 level: Logger.const_get(ENV.fetch("LOG_LEVEL", "INFO")),
+                 formatter: (
+                   lambda do |severity, _at, _name, message|
+                     self[:log_colors][severity].call "#{message}\n"
+                   end
+                 )
+    end
+  end
+end

data/lib/pennyworth/identity.rb

@@ -5,7 +5,8 @@ module Pennyworth
   module Identity
     NAME = "pennyworth"
     LABEL = "Pennyworth"
-    VERSION = "10.0.1"
+    SUMMARY = "A command line interface that augments Alfred workflows."
+    VERSION = "11.0.0"
     VERSION_LABEL = "#{LABEL} #{VERSION}"
   end
 end

data/lib/pennyworth/inflector.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  # Overrides any string to desired form if matched, otherwise answers the original string.
+  class Inflector
+    DEFAULTS = Array(CLI::Configuration::Loader.call.inflections).reduce({}, :merge)
+
+    def initialize overrides = DEFAULTS
+      @overrides = overrides
+    end
+
+    def call(key) = overrides.fetch(key) { |missing_key| missing_key }
+
+    private
+
+    attr_reader :overrides
+  end
+end

data/lib/pennyworth/integrations/git_hub/client.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require "refinements/arrays"
+
+module Pennyworth
+  module Integrations
+    module GitHub
+      # Provides low-level API access to the GitHub API.
+      class Client
+        using Refinements::Arrays
+
+        HEADERS = {
+          accept: "application/vnd.github.v3+json",
+          content_type: "Content-Type: application/json; charset=utf-8"
+        }.freeze
+
+        def initialize headers: HEADERS, container: Container
+          @headers = headers
+          @container = container
+        end
+
+        def get endpoint, parameters: {}
+          paginate ->(page) { sole_get endpoint, parameters: parameters.merge(page: page) }
+        end
+
+        private
+
+        attr_reader :headers, :container
+
+        # :reek:FeatureEnvy
+        def paginate request, records: [], page: 1
+          response = request.call page
+
+          records.including(response.records)
+                 .then do |updated_records|
+                   return updated_records if response.last_page.zero?
+
+                   paginate request, records: updated_records, page: response.next_page
+                 end
+        end
+
+        def sole_get endpoint, parameters: {}
+          http.headers(headers)
+              .basic_auth(user: api_login, pass: api_token)
+              .get("#{api_url}/#{endpoint}", params: parameters)
+              .then { |response| Response.new response }
+        end
+
+        def http = container[__method__]
+
+        def api_url = container[:configuration].git_hub_api_url
+
+        def api_login = container[:environment].fetch("GITHUB_API_LOGIN")
+
+        def api_token = container[:environment].fetch("GITHUB_API_TOKEN")
+      end
+    end
+  end
+end

data/lib/pennyworth/integrations/git_hub/response.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module Integrations
+    module GitHub
+      # Represents a generic GitHub API response.
+      class Response
+        def initialize raw
+          @raw = raw
+        end
+
+        def next_page = page("next")
+
+        def last_page = page("last")
+
+        def records = success? ? JSON(raw.body, symbolize_names: true) : []
+
+        def success? = raw.status.success?
+
+        private
+
+        attr_reader :raw
+
+        def page reference
+          links.find { |link| link.include? reference }
+               .then { |link| String(link)[/page=(?<page>\d+)/, :page].to_i }
+        end
+
+        def links = String(raw.headers["Link"]).split(", ")
+      end
+    end
+  end
+end

data/lib/pennyworth/integrations/ruby_gems/client.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module Integrations
+    module RubyGems
+      # Provides low-level API access to the RubyGems API.
+      class Client
+        def initialize container: Container
+          @container = container
+        end
+
+        def get endpoint
+          http.get("#{api_url}/#{endpoint}")
+              .then do |response|
+                response.status.success? ? JSON(response.body.to_s, symbolize_names: true) : {}
+              end
+        end
+
+        private
+
+        attr_reader :container
+
+        def http = container[__method__]
+
+        def api_url = container[:configuration].ruby_gems_api_url
+      end
+    end
+  end
+end

data/lib/pennyworth/loaders/encodings.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "refinements/arrays"
+
+module Pennyworth
+  module Loaders
+    # Loads an array of encoding records.
+    class Encodings
+      using Refinements::Arrays
+
+      def initialize encoding: Encoding, model: Models::Encoding
+        @encoding = encoding
+        @model = model
+      end
+
+      def call _omit = nil
+        encoding.aliases
+                .map { |_second, first| first }
+                .uniq
+                .sort
+                .map do |first|
+                  model[name: first, aliases: encoding.find(first).names.sort.excluding(first)]
+                end
+      end
+
+      private
+
+      attr_reader :encoding, :model
+    end
+  end
+end

data/lib/pennyworth/loaders/http_statuses.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "rack"
+
+module Pennyworth
+  module Loaders
+    # Loads an array of HTTP status records.
+    class HTTPStatuses
+      def initialize codes: Rack::Utils::HTTP_STATUS_CODES,
+                     model: Models::HTTPStatus,
+                     configuration: CLI::Configuration::Loader.call
+        @codes = codes
+        @model = model
+        @configuration = configuration
+      end
+
+      def call _omit = nil
+        codes.map { |(code, label)| model[code: code, label: label, url: "#{url}/#{code}"] }
+      end
+
+      private
+
+      attr_reader :codes, :model, :configuration
+
+      def url = configuration.http_statuses_url
+    end
+  end
+end

data/lib/pennyworth/loaders/projects.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module Loaders
+    # Loads projects from API requests for further processing.
+    class Projects
+      def self.for_git_hub = new(client: Integrations::GitHub::Client.new)
+
+      def self.for_ruby_gems = new(client: Integrations::RubyGems::Client.new)
+
+      def initialize client:
+        @client = client
+      end
+
+      def call(endpoint) = client.get(endpoint)
+
+      private
+
+      attr_reader :client
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+# 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
+        end
+
+        def call _omit = nil
+          errno.constants
+               .map { |name| errno.const_get name }
+               .uniq
+               .sort_by { |error| error::Errno }
+               .map do |error|
+                 model[id: error::Errno, name: error.name, description: error.exception.message]
+               end
+        end
+
+        private
+
+        attr_reader :errno, :model
+      end
+    end
+  end
+end

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module Loaders
+    module System
+      # Loads an array of signal records.
+      class Signals
+        def initialize list: Signal.list, model: Models::System::Signal
+          @list = list
+          @model = model
+        end
+
+        def call(_omit = nil) = list.map { |name, number| model[number: number, name: name] }
+
+        private
+
+        attr_reader :list, :model
+      end
+    end
+  end
+end

data/lib/pennyworth/loaders/text.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "refinements/strings"
+
+module Pennyworth
+  module Loaders
+    # Loads an array of text records.
+    class Text
+      using Refinements::Strings
+
+      TRANSFORMS = %w[camelcase capitalize downcase size snakecase titleize upcase].freeze
+
+      def initialize transforms: TRANSFORMS, model: Models::Text
+        @transforms = transforms
+        @model = model
+      end
+
+      def call content
+        transforms.map { |kind| model[id: kind, content: content.public_send(kind)] }
+      end
+
+      private
+
+      attr_reader :transforms, :model
+    end
+  end
+end

data/lib/pennyworth/models/encoding.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module Models
+    # Defines an encoding.
+    Encoding = Struct.new :name, :aliases, keyword_init: true
+  end
+end

data/lib/pennyworth/models/http_status.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module Models
+    # Defines HTTP status details.
+    HTTPStatus = Struct.new :code, :label, :url, keyword_init: true
+  end
+end

data/lib/pennyworth/models/system/error.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module Models
+    module System
+      # Defines a system error.
+      Error = Struct.new :id, :name, :description, keyword_init: true
+    end
+  end
+end

data/lib/pennyworth/models/system/signal.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module Models
+    module System
+      # Defines a low-level operating system signal.
+      Signal = Struct.new :number, :name, keyword_init: true
+    end
+  end
+end

data/lib/pennyworth/models/text.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module Models
+    # Defines basic text.
+    Text = Struct.new :id, :content, keyword_init: true
+  end
+end

data/lib/pennyworth/presenters/encoding.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Pennyworth
+  module Presenters
+    # Renders encoding into a compatible format for use in Alfred script filters.
+    class Encoding
+      def initialize record
+        @record = record
+      end
+
+      def id = record.name
+
+      def label = record.name
+
+      def aliases = record.aliases
+
+      private
+
+      attr_reader :record
+    end
+  end
+end