sublime_text_kit 10.0.2 → 11.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d65d4263227c190e203860cfd3b94835a13a3449d0b1a1a61abec1c1094e3ef
-  data.tar.gz: 70da9d856b8a39d0154af8ae65aadf750d67d986c301c3d7047b5d0724c8df27
+  metadata.gz: 1edd436349eaa5af3d9a56ba765ba547e42d2a50f512e0e2e58b27fe0727a652
+  data.tar.gz: 76c23a4bfc6aa007d0a2f09c7c2ce374d9080ca6c714799a624d22a2aebffbf0
 SHA512:
-  metadata.gz: faaee8c22661e18157a1c7da416eaf8fc7da39966a3710ee41df8aeb5fae9ef528482a9d5f114b60f719e082f3d9989d4fc62c4400da618079cf6550be9a8d9a
-  data.tar.gz: 01bcc50593e0b51b056fbb26bd49ddabd5c12302ceaa2367a4ae2cb21525b42409da6ae5fc57f8d3770b696155ee88b8e6d90877b532661ad93a30f28bb70c40
+  metadata.gz: 2b72e4c50adce16c70a3d08f2004afe3bca0e2e617127277829990fd666a506c5b89436a46bc64cc697cf4fae9d72502565a04102f9cbbc7787d0c9b790e1fcd
+  data.tar.gz: 5d2e45a08e168f6d2377b70496e0b1c64b2cc2472524d793263699a5842a18c8cace41a58ef2f523020240810925ad2df316539e40f7599be4729373ed163052

data/README.adoc

@@ -11,7 +11,9 @@ image::https://img.shields.io/badge/code_style-alchemists-brightgreen.svg[Alchem
 [link=https://circleci.com/gh/bkuhlmann/sublime_text_kit]
 image::https://circleci.com/gh/bkuhlmann/sublime_text_kit.svg?style=svg[Circle CI Status]
 
-A command line interface for managing Sublime Text metadata.
+Sublime Text Kit is a command line interface for managing Sublime Text metadata for multiple
+projects, sessions, etc. It's also great for generating the metadata you need, while avoiding manual
+labor, from existing projects.
 
 toc::[]
 
@@ -23,11 +25,6 @@ toc::[]
   metadata is in a directory) so one can easily toggle between up-to-date project information via
   the `CONTROL+COMMAND+P` shortcut.
 
-== Screencasts
-
-[link=https://www.alchemists.io/screencasts/sublime_text_kit]
-image::https://www.alchemists.io/images/screencasts/sublime_text_kit/cover.svg[Screencast,600,240,role=focal_point]
-
 == Requirements
 
 . link:https://www.ruby-lang.org[Ruby]
@@ -49,41 +46,14 @@ gem install sublime_text_kit
 From the command line, type: `sublime_text_kit`
 
 ....
-sublime_text_kit -c, [--config]        # Manage gem configuration.
-sublime_text_kit -h, [--help=COMMAND]  # Show this message or get help for a command.
-sublime_text_kit -m, [--metadata]      # Manage project/workspace metadata.
-sublime_text_kit -p, [--snippets]      # Print user defined snippets.
-sublime_text_kit -s, [--session]       # Manage session metadata.
-sublime_text_kit -u, [--update]        # Update Sublime Text with current settings.
-sublime_text_kit -v, [--version]       # Show gem version.
-....
-
-For configuration options, type: `sublime_text_kit --help --config`
-
-....
--e, [--edit], [--no-edit]  # Edit gem configuration.
--i, [--info], [--no-info]  # Print gem configuration.
-....
-
-For metadata options, type: `sublime_text_kit --help --metadata`
-
-....
--c, [--create], [--no-create]    # Create metadata.
--D, [--destroy], [--no-destroy]  # Destroy metadata.
--R, [--rebuild], [--no-rebuild]  # Rebuild metadata.
-....
-
-For session options, type: `sublime_text_kit --help --session`
-
-....
--R, [--rebuild], [--no-rebuild]  # Rebuild session metadata.
-....
-
-For snippet options, type: `sublime_text_kit --help --snippets`
-
-....
--a, [--ascii-doc], [--no-ascii-doc]  # Print snippets in ASCII Doc format.
--m, [--markdown], [--no-markdown]    # Print snippets in Markdown format.
+USAGE:
+  -c, --config ACTION                      Manage gem configuration. Actions: edit or view.
+  -h, --help                               Show this message.
+  -m, --metadata ACTION                    Manage metadata. Actions: create, delete, or recreate.
+  -S, --session                            Rebuild session.
+  -s, --snippets [FORMAT]                  View snippets. Default: markdown. Formats: markdown or ascii_doc.
+  -u, --update                             Update metadata and session based on current settings.
+  -v, --version                            Show gem version.
 ....
 
 === Customization
@@ -97,10 +67,10 @@ An example configuration could be:
 [source,yaml]
 ----
 :project_roots:
-  - "~/Dropbox/Development/Misc"
-  - "~/Dropbox/Development/OSS"
-  - "~/Dropbox/Development/Work"
+  - "~/Engineering/Contributions"
+  - "~/Engineering/OSS"
 :metadata_dir: "~/Dropbox/Cache/Sublime"
+:snippets_format: :ascii_doc
 ----
 
 Feel free to take this configuration, modify, and save as your own custom `+configuration.yml+`.
@@ -112,8 +82,8 @@ location, is written to the same metadata directory. If using the example settin
 assuming the following directory structure exists…
 
 ....
-~/Dropbox/Development/Misc/example
-~/Dropbox/Development/OSS/sublime_text_kit
+~/Engineering/OSS/example
+~/Engineering/OSS/sublime_text_kit
 ....
 
 …the project metadata will be created in the workspace directory as follows:
@@ -132,12 +102,12 @@ The following demonstrates a default Sublime Text setup:
 . Run: `sublime_text_kit --config --edit` (define Sublime Text Kit settings for project roots and
   metadata directory).
 . Shutdown Sublime Text (i.e. `CONTROL+Q`).
-. Run: `sublime_text_kit --metadata --create` (creates project metadata and rebuilds the session
+. Run: `sublime_text_kit --metadata create` (creates project metadata and rebuilds the session
   metadata so Sublime Text has a complete project history from which to jump through via the
   `CONTROL+COMMMAND+P` shortcut).
 . 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.
-. Breeze through your project workload with ease. 😉
+. Breeze through your project workload with ease. 🎉
 
 === Troubleshooting
 

data/bin/sublime_text_kit

@@ -2,8 +2,6 @@
 # frozen_string_literal: true
 
 require "sublime_text_kit"
-require "sublime_text_kit/cli"
-require "sublime_text_kit/identity"
 
 Process.setproctitle SublimeTextKit::Identity::VERSION_LABEL
-SublimeTextKit::CLI.start
+SublimeTextKit::CLI::Shell.new.call ARGV

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

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module SublimeTextKit
+  module CLI
+    module Actions
+      # Handles gem configuration action.
+      class Config
+        def initialize configuration: Configuration::Loader::HANDLER, container: Container
+          @configuration = configuration
+          @container = container
+        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, :container
+
+        def edit = kernel.system("$EDITOR #{configuration.current}")
+
+        def view = kernel.system("cat #{configuration.current}")
+
+        def kernel = container[__method__]
+
+        def logger = container[__method__]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require "refinements/pathnames"
+
+module SublimeTextKit
+  module CLI
+    module Actions
+      # Handles metadata action.
+      class Metadata
+        using Refinements::Pathnames
+
+        def initialize handler: SublimeTextKit::Metadata::Handler, container: Container
+          @handler = handler
+          @container = container
+        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, :container
+
+        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
+
+        def configuration = container[__method__]
+
+        def logger = container[__method__]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module SublimeTextKit
+  module CLI
+    module Actions
+      # Handles session action.
+      class Session
+        def initialize rebuilder: Sessions::Rebuilder.new, container: Container
+          @rebuilder = rebuilder
+          @container = container
+        end
+
+        def call
+          rebuilder.call
+          logger.info "Session rebuilt."
+        end
+
+        private
+
+        attr_reader :rebuilder, :container
+
+        def logger = container[__method__]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module SublimeTextKit
+  module CLI
+    module Actions
+      # Handles snippets action.
+      class Snippets
+        PRINTERS = {
+          ascii_doc: SublimeTextKit::Snippets::Printers::ASCIIDoc.new,
+          markdown: SublimeTextKit::Snippets::Printers::Markdown.new
+        }.freeze
+
+        def initialize printers: PRINTERS, container: Container
+          @printers = printers
+          @container = container
+        end
+
+        def call
+          kind = configuration.snippets_format
+          printers.fetch(kind).call
+        rescue KeyError
+          logger.error { "Invalid snippet format: #{kind}." }
+        end
+
+        private
+
+        attr_reader :printers, :container
+
+        def configuration = container[__method__]
+
+        def logger = container[__method__]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module SublimeTextKit
+  module CLI
+    module Actions
+      # Handles update action.
+      class Update
+        def initialize metadata: SublimeTextKit::Metadata::Handler,
+                       session: Sessions::Rebuilder.new,
+                       container: Container
+          @metadata = metadata
+          @session = session
+          @container = container
+        end
+
+        def call
+          logger.info "Updating metadata and session..."
+          create_metadata
+          session.call
+          logger.info "Metadata and session updated."
+        end
+
+        private
+
+        attr_reader :metadata, :session, :container
+
+        def create_metadata
+          configuration.project_dirs.each do |directory|
+            metadata.with_project(directory, metadata_dir).create
+            metadata.with_workspace(directory, metadata_dir).create
+          end
+        end
+
+        def metadata_dir = Pathname(configuration.metadata_dir).expand_path
+
+        def configuration = container[__method__]
+
+        def logger = container[__method__]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require "refinements/pathnames"
+
+module SublimeTextKit
+  module CLI
+    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["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"
+        end
+
+        def project_dirs
+          Array(project_roots).map { |path| Pathname(path).expand_path }
+                              .flat_map(&:directories)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,3 @@
+:project_roots:
+:metadata_dir:
+:snippets_format: :markdown

data/lib/sublime_text_kit/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 SublimeTextKit
+  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/sublime_text_kit/cli/parsers/assembler.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require "runcom"
+
+module SublimeTextKit
+  module CLI
+    module Parsers
+      # Assembles and parses all Command Line Interface (CLI) options.
+      class Assembler
+        def initialize section: Core, client: CLIENT, container: Container
+          @section = section
+          @client = client
+          @container = container
+        end
+
+        def call arguments = []
+          section.call client: client
+          client.parse! arguments
+          configuration
+        end
+
+        def to_s = client.to_s
+
+        private
+
+        attr_reader :section, :client, :container
+
+        def configuration = container[__method__]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+require "versionaire/extensions/option_parser"
+
+module SublimeTextKit
+  module CLI
+    # Handles parsing of Command Line Interface (CLI) primary options.
+    module Parsers
+      # Handles parsing of Command Line Interface (CLI) core options.
+      class Core
+        def self.call(...) = new(...).call
+
+        def initialize client: CLIENT, container: Container
+          @client = client
+          @container = container
+        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 :client, :container
+
+        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.action_config = action
+          end
+        end
+
+        def add_metadata
+          client.on(
+            "-m",
+            "--metadata ACTION",
+            %i[create delete recreate],
+            "Manage metadata. Actions: create, delete, or recreate."
+          ) do |action|
+            configuration.action_metadata = action
+          end
+        end
+
+        def add_session
+          client.on "-S", "--session", "Rebuild session." do
+            configuration.action_session = true
+          end
+        end
+
+        def add_snippets
+          client.on(
+            "-s",
+            "--snippets [FORMAT]",
+            %i[markdown ascii_doc],
+            "View snippets. Default: #{configuration.snippets_format}. " \
+            "Formats: markdown or ascii_doc."
+          ) do |kind|
+            configuration.action_snippets = true
+            configuration.snippets_format = kind if kind
+          end
+        end
+
+        def add_update
+          client.on "-u", "--update", "Update metadata and session based on current settings." do
+            configuration.action_update = true
+          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
+
+        private_methods
+
+        def configuration = container[__method__]
+      end
+    end
+  end
+end

data/lib/sublime_text_kit/cli/parsers.rb

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

data/lib/sublime_text_kit/cli/shell.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module SublimeTextKit
+  module CLI
+    # The main Command Line Interface (CLI) object.
+    class Shell
+      ACTIONS = {
+        config: Actions::Config.new,
+        metadata: Actions::Metadata.new,
+        session: Actions::Session.new,
+        snippets: Actions::Snippets.new,
+        update: Actions::Update.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, Error => error
+        logger.error { error.message }
+      end
+
+      private
+
+      attr_reader :parser, :actions, :container
+
+      def perform configuration
+        case configuration
+          in action_config: Symbol => action then config action
+          in action_metadata: Symbol => kind then metadata kind
+          in action_session: true then session
+          in action_snippets: true then snippets
+          in action_update: true then update
+          in action_version: String => version then logger.info version
+          else usage
+        end
+      end
+
+      def config(action) = actions.fetch(__method__).call(action)
+
+      def metadata(kind) = actions.fetch(__method__).call(kind)
+
+      def session = actions.fetch(__method__).call
+
+      def snippets = actions.fetch(__method__).call
+
+      def update = actions.fetch(__method__).call
+
+      def usage = logger.unknown { parser.to_s }
+
+      def logger = container[__method__]
+    end
+  end
+end

data/lib/sublime_text_kit/container.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "dry-container"
+require "logger"
+require "pastel"
+
+module SublimeTextKit
+  # Provides a global gem container for injection into other objects.
+  module Container
+    extend Dry::Container::Mixin
+
+    register(:configuration, memoize: true) { CLI::Configuration::Loader.call }
+    register(:colorizer) { Pastel.new enabled: $stdout.tty? }
+    register(:kernel) { Kernel }
+
+    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/sublime_text_kit/identity.rb

@@ -5,7 +5,8 @@ module SublimeTextKit
   module Identity
     NAME = "sublime_text_kit"
     LABEL = "Sublime Text Kit"
-    VERSION = "10.0.2"
-    VERSION_LABEL = "#{LABEL} #{VERSION}"
+    VERSION = "11.0.0"
+    VERSION_LABEL = "#{LABEL} #{VERSION}".freeze
+    SUMMARY = "A command line interface for managing Sublime Text metadata."
   end
 end