sublime_text_kit 14.1.2 → 15.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9fc486aed010e2ae8e83dac6c72697db4f7e90587a51323d4194f76073db4d34
-  data.tar.gz: b8535882b1a250a5816c67e0238fca84df8c4242c77a28a2b506b9047881f82a
+  metadata.gz: 29bf2181b4e5836ffa6d8516718c767d4ce86ffcc92dfaa64678983fea21b845
+  data.tar.gz: df5e8fb6df541d0fafc1cfadff71a04baaf46587fb5a8dc5688230853dcf120c
 SHA512:
-  metadata.gz: 4b10467648513b00ecddda2fa0a42b2e675da443d347106a6722606f419c137696cb879f9731ca4fc85bb1b7e7032b8041be03f438053e8c2468684d26a63dda
-  data.tar.gz: db0ee5e586b78dcd29e17a5fe7ad08113e788607bd9fc6603828b7622d34fce8adef49f41cc29b2c03d3740c680390149427a3335771d1721c8d4773cd41c1cc
+  metadata.gz: 867751fb2cceaa6b81bbdc1beb1d83d626265929ed7e6c92e9c355d763fd340237c6bad8a1fa533ccd477ec700da6f87b7961a6d4552b3a0e56f420f367c58e1
+  data.tar.gz: cbe288a962340ae375f06f14afc9c2e581ec41ad9bf5afbb75c287f18665a1513a0897791272ac60e4ba78c3c3e1cf08a75d8976810bd12eeeb87f68b47dec2c

data/README.adoc

@@ -25,7 +25,16 @@ toc::[]
 
 == Setup
 
-To install, run:
+To install _with_ security, run:
+
+[source,bash]
+----
+# 💡 Skip this line if you already have the public certificate installed.
+gem cert --add <(curl --compressed --location https://alchemists.io/gems.pem)
+gem install sublime_text_kit --trust-policy HighSecurity
+----
+
+To install _without_ security, run:
 
 [source,bash]
 ----
@@ -39,14 +48,23 @@ gem install sublime_text_kit
 From the command line, type: `sublime_text_kit`
 
 ....
-USAGE:
-  -c, --config ACTION                      Manage gem configuration. Actions: edit or view.
-  -h, --help                               Show this message.
-  -m, --metadata ACTION                    Manage project metadata. Actions: create, delete, or recreate.
-  -S, --session                            Rebuild session metadata.
-  -s, --snippets [FORMAT]                  View snippets. Formats: markdown or ascii_doc. Default: ascii_doc.
-  -u, --update                             Update project and session metadata based on current settings.
-  -v, --version                            Show gem version.
+USAGE
+  sublime_text_kit [OPTIONS]
+  sublime_text_kit COMMAND [OPTIONS]
+
+OPTIONS
+  -S, --session               Rebuild session metadata.
+  -s, --snippets [FORMAT]     View snippets.
+                              Use: markdown or ascii_doc.
+                              Default: ascii_doc.
+  -u, --update                Update project and session metadata based on current settings.
+  -v, --version               Show version.
+  -h, --help [COMMAND]        Show this message.
+
+COMMANDS
+  config                      Manage configuration.
+                              Path is dynamic per current directory.
+  metadata                    Manage project metadata.
 ....
 
 === Customization
@@ -59,15 +77,13 @@ An example configuration could be:
 
 [source,yaml]
 ----
-:project_roots:
+project_roots:
   - "~/Engineering/Organizations"
   - "~/Engineering/OSS"
-:metadata_dir: "~/Dropbox/Cache/Sublime"
-:snippets_format: :markdown
+metadata_dir: "~/Dropbox/Cache/Sublime"
+snippets_format: :markdown
 ----
 
-Feel free to take this configuration, modify, and save as your own.
-
 The `project_roots` key defines the root level directories where your project folders are located.
 When project metadata (i.e. `.sublime-project`, `.sublime-workspace`) is generated, the name of the
 metadata file will be the same name as the project folder. All project metadata, regardless of root
@@ -103,7 +119,7 @@ The following demonstrates a default Sublime Text setup:
 2. Shutdown Sublime Text (i.e. `COMMAND+q`).
 3. Run `sublime_text_kit --update` which will create project metadata and rebuild session metadata
    so Sublime Text has a complete project history from which to switch between via the
-   `CONTROL+COMMMAND+p` shortcut.
+   `CONTROL+COMMAND+p` shortcut.
 4. Launch Sublime Text and use the `CONTROL+COMMAND+p` keyboard shortcut to toggle between projects.
    Notice that you can (fuzzy type) project names to jump between them.
 5. Navigate through your project workload with ease. 🎉

data/lib/sublime_text_kit/cli/actions/metadata/create.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require "refinements/pathnames"
+require "sod"
+
+module SublimeTextKit
+  module CLI
+    module Actions
+      module Metadata
+        # Creates project metadata.
+        class Create < Sod::Action
+          include Import[:configuration, :logger]
+
+          using Refinements::Pathnames
+
+          description "Create metadata."
+
+          on %w[-c --create]
+
+          def initialize(handler: SublimeTextKit::Metadata::Handler, **)
+            super(**)
+            @handler = handler
+          end
+
+          def call(*)
+            logger.info "Creating metadata in #{metadata_dir}..."
+            process_projects
+            logger.info "Metadata created."
+          end
+
+          private
+
+          attr_reader :handler
+
+          def process_projects
+            configuration.project_dirs.each do |directory|
+              handler.with_project(directory, metadata_dir).create
+              handler.with_workspace(directory, metadata_dir).create
+            end
+          end
+
+          def metadata_dir = Pathname(configuration.metadata_dir).expand_path
+        end
+      end
+    end
+  end
+end

data/lib/sublime_text_kit/cli/actions/metadata/delete.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require "refinements/pathnames"
+require "sod"
+
+module SublimeTextKit
+  module CLI
+    module Actions
+      module Metadata
+        # Deletes project metadata.
+        class Delete < Sod::Action
+          include Import[:configuration, :logger]
+
+          using Refinements::Pathnames
+
+          description "Delete metadata."
+
+          on %w[-d --delete]
+
+          def initialize(handler: SublimeTextKit::Metadata::Handler, **)
+            super(**)
+            @handler = handler
+          end
+
+          def call(*)
+            logger.info "Deleting metadata in #{metadata_dir}..."
+            process_projects
+            logger.info "Metadata deleted."
+          end
+
+          private
+
+          attr_reader :handler
+
+          def process_projects
+            configuration.project_dirs.each do |directory|
+              handler.with_project(directory, metadata_dir).delete
+              handler.with_workspace(directory, metadata_dir).delete
+            end
+          end
+
+          def metadata_dir = Pathname(configuration.metadata_dir).expand_path
+        end
+      end
+    end
+  end
+end

data/lib/sublime_text_kit/cli/actions/metadata/recreate.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require "refinements/pathnames"
+require "sod"
+
+module SublimeTextKit
+  module CLI
+    module Actions
+      module Metadata
+        # Recreates project metadata.
+        class Recreate < Sod::Action
+          include Import[:configuration, :logger]
+
+          using Refinements::Pathnames
+
+          description "Recreate metadata."
+
+          on %w[-r --recreate]
+
+          def initialize(handler: SublimeTextKit::Metadata::Handler, **)
+            super(**)
+            @handler = handler
+          end
+
+          def call(*)
+            logger.info "Recreating metadata in #{metadata_dir}..."
+            process_projects
+            logger.info "Metadata recreated."
+          end
+
+          private
+
+          attr_reader :handler
+
+          def process_projects
+            configuration.project_dirs.each do |directory|
+              handler.with_project(directory, metadata_dir).recreate
+              handler.with_workspace(directory, metadata_dir).recreate
+            end
+          end
+
+          def metadata_dir = Pathname(configuration.metadata_dir).expand_path
+        end
+      end
+    end
+  end
+end

data/lib/sublime_text_kit/cli/actions/session.rb

@@ -1,18 +1,24 @@
 # frozen_string_literal: true
 
+require "sod"
+
 module SublimeTextKit
   module CLI
     module Actions
       # Handles session action.
-      class Session
-        include SublimeTextKit::Import[:logger]
+      class Session < Sod::Action
+        include Import[:logger]
+
+        description "Rebuild session metadata."
+
+        on %w[-S --session]
 
         def initialize(rebuilder: Sessions::Rebuilder.new, **)
           super(**)
           @rebuilder = rebuilder
         end
 
-        def call
+        def call(*)
           rebuilder.call
           logger.info "Session rebuilt."
         end

data/lib/sublime_text_kit/cli/actions/snippets.rb

@@ -1,21 +1,29 @@
 # frozen_string_literal: true
 
+require "sod"
+
 module SublimeTextKit
   module CLI
     module Actions
       # Handles snippets action.
-      class Snippets
-        include SublimeTextKit::Import[:configuration, :logger]
+      class Snippets < Sod::Action
+        include Import[:configuration, :logger]
+
+        description "View snippets."
+
+        on %w[-s --snippets], argument: "[FORMAT]", allow: %w[markdown ascii_doc]
+
+        default { Container[:configuration].snippets_format }
 
         def initialize(printer: SublimeTextKit::Snippets::Printer.new, **)
           super(**)
           @printer = printer
         end
 
-        def call kind
+        def call kind = default
           case kind
-            when :ascii_doc then printer.call "*"
-            when :markdown then printer.call "-"
+            when "ascii_doc" then printer.call "*"
+            when "markdown" then printer.call "-"
             else logger.error { "Invalid snippet format: #{kind}. Use ascii_doc or markdown." }
           end
         end

data/lib/sublime_text_kit/cli/actions/update.rb

@@ -1,11 +1,17 @@
 # frozen_string_literal: true
 
+require "sod"
+
 module SublimeTextKit
   module CLI
     module Actions
       # Handles update action.
-      class Update
-        include SublimeTextKit::Import[:configuration, :logger]
+      class Update < Sod::Action
+        include Import[:configuration, :logger]
+
+        description "Update project and session metadata based on current settings."
+
+        on %w[-u --update]
 
         def initialize(
           metadata: SublimeTextKit::Metadata::Handler,
@@ -17,7 +23,7 @@ module SublimeTextKit
           @session = session
         end
 
-        def call
+        def call(*)
           logger.info "Updating metadata and session..."
           create_metadata
           session.call

data/lib/sublime_text_kit/cli/shell.rb

@@ -1,49 +1,48 @@
 # frozen_string_literal: true
 
-require "core"
+require "sod"
 
 module SublimeTextKit
   module CLI
     # The main Command Line Interface (CLI) object.
     class Shell
-      include Actions::Import[
-        :specification,
-        :logger,
-        :config,
-        :metadata,
-        :session,
-        :snippets,
-        :update
-      ]
-
-      def initialize(parser: Parser.new, **)
+      include Import[:defaults_path, :xdg_config, :specification]
+
+      def initialize(context: Sod::Context, dsl: Sod, **)
         super(**)
-        @parser = parser
+        @context = context
+        @dsl = dsl
       end
 
-      def call arguments = Core::EMPTY_ARRAY
-        act_on parser.call(arguments)
-      rescue OptionParser::ParseError, Error => error
-        logger.error { error.message }
-      end
+      def call(...) = cli.call(...)
 
       private
 
-      attr_reader :parser
-
-      def act_on configuration
-        case configuration
-          in action_config: Symbol => action then config.call action
-          in action_metadata: Symbol => kind then metadata.call kind
-          in action_session: true then session.call
-          in action_snippets: true then snippets.call configuration.snippets_format
-          in action_update: true then update.call
-          in action_version: true then logger.info { specification.labeled_version }
-          else usage
+      attr_reader :context, :dsl
+
+      def cli
+        context = build_context
+
+        dsl.new :sublime_text_kit, banner: specification.banner do
+          on(Sod::Prefabs::Commands::Config, context:)
+
+          on "metadata", "Manage project metadata." do
+            on Actions::Metadata::Create
+            on Actions::Metadata::Delete
+            on Actions::Metadata::Recreate
+          end
+
+          on Actions::Session
+          on Actions::Snippets
+          on Actions::Update
+          on(Sod::Prefabs::Actions::Version, context:)
+          on Sod::Prefabs::Actions::Help, self
         end
       end
 
-      def usage = logger.any { parser.to_s }
+      def build_context
+        context[defaults_path:, xdg_config:, version_label: specification.labeled_version]
+      end
     end
   end
 end

data/lib/sublime_text_kit/configuration/contract.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require "dry/schema"
+require "etcher"
+
+Dry::Schema.load_extensions :monads
+
+module SublimeTextKit
+  module Configuration
+    Contract = Dry::Schema.Params do
+      optional(:project_roots).filled :array
+      optional(:metadata_dir).filled Etcher::Types::Pathname
+      required(:snippets_format).filled :string
+      required(:session_path).filled Etcher::Types::Pathname
+      required(:user_dir).filled Etcher::Types::Pathname
+    end
+  end
+end

data/lib/sublime_text_kit/configuration/defaults.yml

@@ -1,3 +1 @@
-:project_roots:
-:metadata_dir:
-:snippets_format: :ascii_doc
+snippets_format: ascii_doc

data/lib/sublime_text_kit/configuration/model.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "refinements/pathnames"
+
+module SublimeTextKit
+  module Configuration
+    # Models the configuration.
+    Model = Struct.new(
+      :project_roots,
+      :metadata_dir,
+      :snippets_format,
+      :session_path,
+      :user_dir
+    ) do
+      using Refinements::Pathnames
+
+      def initialize(**)
+        super
+        freeze
+      end
+
+      def project_dirs
+        Array(project_roots).map { |path| Pathname(path).expand_path }
+                            .flat_map(&:directories)
+      end
+    end
+  end
+end

data/lib/sublime_text_kit/configuration/transformers/session_path.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "dry/monads"
+
+module SublimeTextKit
+  module Configuration
+    module Transformers
+      # Transforms session path into fully qualified path based on home directory.
+      class SessionPath
+        include Dry::Monads[:result]
+
+        def initialize
+          path = "Library/Application Support/Sublime Text/Local/Session.sublime_session"
+
+          @path = path
+        end
+
+        def call content
+          return Success content unless content.key? :home
+
+          Pathname(content[:home]).join(path)
+                                  .then { |session_path| Success content.merge!(session_path:) }
+        end
+
+        private
+
+        attr_reader :path
+      end
+    end
+  end
+end

data/lib/sublime_text_kit/configuration/transformers/user_dir.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require "dry/monads"
+
+module SublimeTextKit
+  module Configuration
+    module Transformers
+      # Transforms user directory into fully qualified path based on home directory.
+      class UserDir
+        include Dry::Monads[:result]
+
+        def initialize path = "Library/Application Support/Sublime Text/Packages/User"
+          @path = path
+        end
+
+        def call content
+          return Success content unless content.key? :home
+
+          Pathname(content[:home]).join(path)
+                                  .then { |user_dir| Success content.merge!(user_dir:) }
+        end
+
+        private
+
+        attr_reader :path
+      end
+    end
+  end
+end

data/lib/sublime_text_kit/container.rb

@@ -2,6 +2,8 @@
 
 require "cogger"
 require "dry/container"
+require "etcher"
+require "runcom"
 require "spek"
 
 module SublimeTextKit
@@ -9,9 +11,24 @@ module SublimeTextKit
   module Container
     extend Dry::Container::Mixin
 
-    register(:configuration) { Configuration::Loader.call }
+    # :nocov:
+    register :configuration do
+      self[:defaults].add_loader(Etcher::Loaders::Environment.new(%w[HOME]))
+                     .add_loader(Etcher::Loaders::YAML.new(self[:xdg_config].active))
+                     .add_transformer(Configuration::Transformers::SessionPath.new)
+                     .add_transformer(Configuration::Transformers::UserDir.new)
+                     .then { |registry| Etcher.call registry }
+    end
+
+    register :defaults do
+      Etcher::Registry.new(contract: Configuration::Contract, model: Configuration::Model)
+                      .add_loader(Etcher::Loaders::YAML.new(self[:defaults_path]))
+    end
+
+    register(:defaults_path) { Pathname(__dir__).join("configuration/defaults.yml") }
+    register(:xdg_config) { Runcom::Config.new "sublime_text_kit/configuration.yml" }
     register(:specification) { Spek::Loader.call "#{__dir__}/../../sublime_text_kit.gemspec" }
     register(:kernel) { Kernel }
-    register(:logger) { Cogger::Client.new }
+    register(:logger) { Cogger.new formatter: :emoji }
   end
 end

data/lib/sublime_text_kit/import.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "infusible"
+
 module SublimeTextKit
   Import = Infusible.with Container
 end

data/lib/sublime_text_kit/snippets/printer.rb

@@ -4,7 +4,7 @@ module SublimeTextKit
   module Snippets
     # Prints snippets as a list.
     class Printer
-      include Import[:logger]
+      include Import[:kernel]
 
       def initialize(collector: Collector.new, **)
         super(**)
@@ -13,7 +13,7 @@ module SublimeTextKit
 
       def call bullet
         collector.call.each do |snippet|
-          logger.info "#{bullet} #{snippet.description} - `#{snippet.trigger}`"
+          kernel.puts "#{bullet} #{snippet.description} - `#{snippet.trigger}`"
         end
       end
 

data/sublime_text_kit.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "sublime_text_kit"
-  spec.version = "14.1.2"
+  spec.version = "15.0.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://alchemists.io/projects/sublime_text_kit"
@@ -23,13 +23,16 @@ Gem::Specification.new do |spec|
   spec.cert_chain = [Gem.default_cert_path]
 
   spec.required_ruby_version = "~> 3.2"
-  spec.add_dependency "cogger", "~> 0.5"
-  spec.add_dependency "core", "~> 0.1"
+  spec.add_dependency "cogger", "~> 0.10"
   spec.add_dependency "dry-container", "~> 0.11"
-  spec.add_dependency "infusible", "~> 1.0"
-  spec.add_dependency "refinements", "~> 10.0"
-  spec.add_dependency "runcom", "~> 9.0"
-  spec.add_dependency "spek", "~> 1.0"
+  spec.add_dependency "dry-monads", "~> 1.6"
+  spec.add_dependency "dry-schema", "~> 1.13"
+  spec.add_dependency "etcher", "~> 0.2"
+  spec.add_dependency "infusible", "~> 2.0"
+  spec.add_dependency "refinements", "~> 11.0"
+  spec.add_dependency "runcom", "~> 10.0"
+  spec.add_dependency "sod", "~> 0.0"
+  spec.add_dependency "spek", "~> 2.0"
   spec.add_dependency "zeitwerk", "~> 2.6"
 
   spec.bindir = "exe"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sublime_text_kit
 version: !ruby/object:Gem::Version
-  version: 14.1.2
+  version: 15.0.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -35,7 +35,7 @@ cert_chain:
   3n5C8/6Zh9DYTkpcwPSuIfAga6wf4nXc9m6JAw8AuMLaiWN/r/2s4zJsUHYERJEu
   gZGm4JqtuSg8pYjPeIJxS960owq+SfuC+jxqmRA54BisFCv/0VOJi7tiJVY=
   -----END CERTIFICATE-----
-date: 2023-03-22 00:00:00.000000000 Z
+date: 2023-06-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cogger
@@ -43,58 +43,100 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '0.10'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '0.10'
 - !ruby/object:Gem::Dependency
-  name: core
+  name: dry-container
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.11'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.11'
 - !ruby/object:Gem::Dependency
-  name: dry-container
+  name: dry-monads
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.11'
+        version: '1.6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.11'
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: dry-schema
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: etcher
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: infusible
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: refinements
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11.0'
+- !ruby/object:Gem::Dependency
+  name: runcom
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
@@ -108,33 +150,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '10.0'
 - !ruby/object:Gem::Dependency
-  name: runcom
+  name: sod
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '9.0'
+        version: '0.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '9.0'
+        version: '0.0'
 - !ruby/object:Gem::Dependency
   name: spek
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -163,19 +205,18 @@ files:
 - README.adoc
 - exe/sublime_text_kit
 - lib/sublime_text_kit.rb
-- lib/sublime_text_kit/cli/actions/config.rb
-- lib/sublime_text_kit/cli/actions/container.rb
-- lib/sublime_text_kit/cli/actions/import.rb
-- lib/sublime_text_kit/cli/actions/metadata.rb
+- lib/sublime_text_kit/cli/actions/metadata/create.rb
+- lib/sublime_text_kit/cli/actions/metadata/delete.rb
+- lib/sublime_text_kit/cli/actions/metadata/recreate.rb
 - lib/sublime_text_kit/cli/actions/session.rb
 - lib/sublime_text_kit/cli/actions/snippets.rb
 - lib/sublime_text_kit/cli/actions/update.rb
-- lib/sublime_text_kit/cli/parser.rb
-- lib/sublime_text_kit/cli/parsers/core.rb
 - lib/sublime_text_kit/cli/shell.rb
-- lib/sublime_text_kit/configuration/content.rb
+- lib/sublime_text_kit/configuration/contract.rb
 - lib/sublime_text_kit/configuration/defaults.yml
-- lib/sublime_text_kit/configuration/loader.rb
+- lib/sublime_text_kit/configuration/model.rb
+- lib/sublime_text_kit/configuration/transformers/session_path.rb
+- lib/sublime_text_kit/configuration/transformers/user_dir.rb
 - lib/sublime_text_kit/container.rb
 - lib/sublime_text_kit/import.rb
 - lib/sublime_text_kit/metadata/handler.rb
@@ -214,7 +255,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.9
+rubygems_version: 3.4.14
 signing_key:
 specification_version: 4
 summary: A command line interface for managing Sublime Text metadata.

data/lib/sublime_text_kit/cli/actions/config.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-module SublimeTextKit
-  module CLI
-    module Actions
-      # Handles gem configuration action.
-      class Config
-        include SublimeTextKit::Import[:kernel, :logger]
-
-        def initialize(configuration: Configuration::Loader::CLIENT, **)
-          super(**)
-          @configuration = configuration
-        end
-
-        def call action
-          case action
-            when :edit then edit
-            when :view then view
-            else logger.error { "Invalid configuration action: #{action}." }
-          end
-        end
-
-        private
-
-        attr_reader :configuration
-
-        def edit = kernel.system("$EDITOR #{configuration.current}")
-
-        def view = kernel.system("cat #{configuration.current}")
-      end
-    end
-  end
-end

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

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-require "dry/container"
-
-module SublimeTextKit
-  module CLI
-    module Actions
-      # Provides a single container with application and action specific dependencies.
-      module Container
-        extend Dry::Container::Mixin
-
-        merge SublimeTextKit::Container
-
-        register(:config) { Actions::Config.new }
-        register(:metadata) { Actions::Metadata.new }
-        register(:session) { Actions::Session.new }
-        register(:snippets) { Actions::Snippets.new }
-        register(:update) { Actions::Update.new }
-      end
-    end
-  end
-end

data/lib/sublime_text_kit/cli/actions/import.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-require "infusible"
-
-module SublimeTextKit
-  module CLI
-    module Actions
-      Import = Infusible.with Container
-    end
-  end
-end

data/lib/sublime_text_kit/cli/actions/metadata.rb

@@ -1,61 +0,0 @@
-# frozen_string_literal: true
-
-require "refinements/pathnames"
-
-module SublimeTextKit
-  module CLI
-    module Actions
-      # Handles metadata action.
-      class Metadata
-        include SublimeTextKit::Import[:configuration, :logger]
-
-        using Refinements::Pathnames
-
-        def initialize(handler: SublimeTextKit::Metadata::Handler, **)
-          super(**)
-          @handler = handler
-        end
-
-        def call kind
-          case kind
-            when :create then create
-            when :delete then delete
-            when :recreate then recreate
-            else logger.error { "Unknown metadata action: #{kind}." }
-          end
-        end
-
-        private
-
-        attr_reader :handler
-
-        def create
-          logger.info "Creating metadata in #{metadata_dir}..."
-          process_projects __method__
-          logger.info "Metadata created."
-        end
-
-        def delete
-          logger.info "Deleting metadata in #{metadata_dir}..."
-          process_projects __method__
-          logger.info "Metadata deleted."
-        end
-
-        def recreate
-          logger.info "Recreating metadata in #{metadata_dir}..."
-          process_projects __method__
-          logger.info "Metadata recreated."
-        end
-
-        def process_projects method
-          configuration.project_dirs.each do |directory|
-            handler.with_project(directory, metadata_dir).public_send method
-            handler.with_workspace(directory, metadata_dir).public_send method
-          end
-        end
-
-        def metadata_dir = Pathname(configuration.metadata_dir).expand_path
-      end
-    end
-  end
-end

data/lib/sublime_text_kit/cli/parser.rb

@@ -1,34 +0,0 @@
-# frozen_string_literal: true
-
-require "core"
-require "optparse"
-
-module SublimeTextKit
-  module CLI
-    # Assembles and parses all Command Line Interface (CLI) options.
-    class Parser
-      include Import[:configuration]
-
-      CLIENT = OptionParser.new nil, 40, "  "
-
-      def initialize(section: Parsers::Core, client: CLIENT, **)
-        super(**)
-        @section = section
-        @client = client
-        @configuration_duplicate = configuration.dup
-      end
-
-      def call arguments = Core::EMPTY_ARRAY
-        section.call(configuration_duplicate, client:)
-        client.parse arguments
-        configuration_duplicate.freeze
-      end
-
-      def to_s = client.to_s
-
-      private
-
-      attr_reader :section, :client, :configuration_duplicate
-    end
-  end
-end

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

@@ -1,103 +0,0 @@
-# frozen_string_literal: true
-
-require "core"
-require "refinements/structs"
-
-module SublimeTextKit
-  module CLI
-    module Parsers
-      # Handles parsing of Command Line Interface (CLI) core options.
-      class Core
-        include Import[:specification]
-
-        using Refinements::Structs
-
-        def self.call(...) = new(...).call
-
-        def initialize(configuration = Container[:configuration], client: Parser::CLIENT, **)
-          super(**)
-          @configuration = configuration
-          @client = client
-        end
-
-        def call arguments = ::Core::EMPTY_ARRAY
-          client.banner = specification.labeled_summary
-          client.separator "\nUSAGE:\n"
-          collate
-          client.parse arguments
-          configuration
-        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 or view."
-          ) do |action|
-            configuration.merge! action_config: action
-          end
-        end
-
-        def add_metadata
-          client.on(
-            "-m",
-            "--metadata ACTION",
-            %i[create delete recreate],
-            "Manage project metadata. Actions: create, delete, or recreate."
-          ) do |action|
-            configuration.merge! action_metadata: action
-          end
-        end
-
-        def add_session
-          client.on "-S", "--session", "Rebuild session metadata." do
-            configuration.merge! action_session: true
-          end
-        end
-
-        def add_snippets
-          client.on(
-            "-s",
-            "--snippets [FORMAT]",
-            %i[markdown ascii_doc],
-            "View snippets. Formats: markdown or ascii_doc. " \
-            "Default: #{snippets_format}."
-          ) do |kind|
-            configuration.merge! action_snippets: true, snippets_format: kind || snippets_format
-          end
-        end
-
-        def add_update
-          client.on(
-            "-u",
-            "--update",
-            "Update project and session metadata based on current settings."
-          ) do
-            configuration.merge! action_update: true
-          end
-        end
-
-        def add_version
-          client.on "-v", "--version", "Show gem version." do
-            configuration.merge! action_version: true
-          end
-        end
-
-        def add_help
-          client.on "-h", "--help", "Show this message." do
-            configuration.merge! action_help: true
-          end
-        end
-
-        def snippets_format = configuration.snippets_format
-      end
-    end
-  end
-end

data/lib/sublime_text_kit/configuration/content.rb

@@ -1,45 +0,0 @@
-# frozen_string_literal: true
-
-require "refinements/pathnames"
-
-module SublimeTextKit
-  module Configuration
-    # Defines configuration content as the primary source of truth for use throughout the gem.
-    Content = Struct.new(
-      :action_config,
-      :action_help,
-      :action_metadata,
-      :action_session,
-      :action_snippets,
-      :action_update,
-      :action_version,
-      :project_roots,
-      :metadata_dir,
-      :snippets_format,
-      :session_path,
-      :user_dir,
-      keyword_init: true
-    ) do
-      using Refinements::Pathnames
-
-      def initialize *arguments
-        super
-
-        home = Pathname ENV.fetch("HOME", "")
-
-        self[:session_path] ||= home.join(
-          "Library/Application Support/Sublime Text/Local/Session.sublime_session"
-        )
-
-        self[:user_dir] ||= home.join "Library/Application Support/Sublime Text/Packages/User"
-
-        freeze
-      end
-
-      def project_dirs
-        Array(project_roots).map { |path| Pathname(path).expand_path }
-                            .flat_map(&:directories)
-      end
-    end
-  end
-end

data/lib/sublime_text_kit/configuration/loader.rb

@@ -1,35 +0,0 @@
-# frozen_string_literal: true
-
-require "pathname"
-require "refinements/hashes"
-require "refinements/structs"
-require "runcom"
-require "yaml"
-
-module SublimeTextKit
-  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
-      CLIENT = Runcom::Config.new "sublime_text_kit/configuration.yml", defaults: DEFAULTS
-
-      def self.call = new.call
-
-      def self.with_defaults = new(client: DEFAULTS)
-
-      def initialize content: Content.new, client: CLIENT
-        @content = content
-        @client = client
-      end
-
-      def call = content.merge(**client.to_h.flatten_keys)
-
-      private
-
-      attr_reader :content, :client
-    end
-  end
-end