tocer 15.1.2 → 16.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b2f83114e81d42e9a9ecf75882638aa429b6410378ae094f9b20ec4997aea614
-  data.tar.gz: 99f969f100d87661f8f3928efe3fb6fd5dc0712987377566e18b516ed24ddee2
+  metadata.gz: 832f39f67b1d9fc4b4be22d308e7526cb16e2b7a4f352102e79636fc1e8299c9
+  data.tar.gz: 5c7f2a4671d6b2b3f83dad7188d0e75b636911bfb9adc293996c9446d058f5f7
 SHA512:
-  metadata.gz: 9626eebe778cbefa8f1127f17f3ed6a3bcae0ab85d12e609b40c8df3ade998e74654f3969aa874540675b556725d2100923c776181ca8062b3066a89735f97ba
-  data.tar.gz: c6a4f9b2e8d216d164dba9205b64a541f2a5b83eea3780144a1d9995da55beae2b8ddb8f2698921919a10ffcce273d8cea656845e4646d9cf21034bd1e5cf0ae
+  metadata.gz: adbd726db1d8b5dfe370c0436173513189fc730390e2b8dca8dac953aeea15d852425ddb35b7e74b9d7f36fa8ddcf9d501fc8210503538f46b2eaf34145d938a
+  data.tar.gz: dc21ad6f148f3d1e9566fd842aeee2d9ce48db4a4a0c94b95f601709a2c9b6a9335563f52d18066c443b15d0dd85e68bc55d3a970e4a2879f492ecd64b3c7784

data/README.adoc

@@ -28,13 +28,29 @@ 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 tocer --trust-policy HighSecurity
+----
+
+To install _without_ security, run:
 
 [source,bash]
 ----
 gem install tocer
 ----
 
+You can also add the gem directly to your project:
+
+[source,bash]
+----
+bundle add tocer
+----
+
 == Usage
 
 === Command Line Interface (CLI)
@@ -42,15 +58,18 @@ gem install tocer
 From the command line, run: `tocer --help`
 
 ....
-USAGE:
-  -c, --config ACTION                      Manage gem configuration: edit or view.
-  -h, --help                               Show this message.
-  -i, --insert [PATH]                      Insert/update table of contents. Default: ".".
-  -v, --version                            Show gem version.
-
-OPTIONS:
-      --includes [a,b,c]                   Add include patterns. Default: ["README.md"].
-      --label [LABEL]                      Add label. Default: "## Table of Contents".
+USAGE
+  tocer [OPTIONS]
+  tocer COMMAND [OPTIONS]
+
+OPTIONS
+  -v, --version            Show version.
+  -h, --help [COMMAND]     Show this message.
+
+COMMANDS
+  config                   Manage configuration.
+                           Path is dynamic per current directory.
+  upsert                   Update/insert table of contents.
 ....
 
 To generate the table of contents at a specific position within your Markdown files, add the
@@ -77,10 +96,10 @@ The default configuration is as follows:
 
 [source,yaml]
 ----
-:label: "## Table of Contents"
-:includes:
+label: "## Table of Contents"
+patterns:
   - "README.md"
-:root_dir: "."
+root_dir: "."
 ----
 
 Feel free to take this default configuration, modify, and save as your own custom
@@ -89,7 +108,7 @@ Feel free to take this default configuration, modify, and save as your own custo
 The `configuration.yml` file can be configured as follows:
 
 * `label`: The header label for the table of contents.
-* `includes`: The list of included files.
+* `patterns`: The list of included files.
 * `root_dir`: The root path to use for processing files.
 
 There are multiple ways the include list can be defined. Here are some examples:
@@ -97,22 +116,22 @@ There are multiple ways the include list can be defined. Here are some examples:
 [source,yaml]
 ----
 # Use an empty array to ignore all files:
-:includes: []
+:patterns: []
 
 # Use an array of wildcards for groups of files with similar extensions:
-:includes:
+:patterns:
   - "*.md"
   - "*.mkd"
   - "*.markdown"
 
 # Use a mix of wild cards and relative names/paths to customized as necessary:
-:includes:
+:patterns:
   - "README.md"
   - "docs/*.md"
   - "*.markdown"
 
 # Use a recursive glob to traverse and update all sub-directories:
-:includes:
+:patterns:
   - "**/*.md"
 ----
 

data/lib/tocer/builder.rb

@@ -20,7 +20,7 @@ module Tocer
 
     def unbuildable?(lines) = comment_block.empty?(lines) && headers(lines).empty?
 
-    def call lines, label: Configuration::Loader.call.label
+    def call lines, label: Container[:configuration].label
       return "" if headers(lines).empty?
 
       url_count.clear

data/lib/tocer/cli/actions/label.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "refinements/structs"
+require "sod"
+
+module Tocer
+  module CLI
+    module Actions
+      # Stores table of contents label.
+      class Label < Sod::Action
+        include Import[:inputs]
+
+        using Refinements::Structs
+
+        description "Set label."
+
+        on %w[-l --label], argument: "[TEXT]"
+
+        default { Container[:configuration].label }
+
+        def call(label = default) = inputs.merge!(label:)
+      end
+    end
+  end
+end

data/lib/tocer/cli/actions/pattern.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "refinements/structs"
+require "sod"
+
+module Tocer
+  module CLI
+    module Actions
+      # Stores table of contents file patterns.
+      class Pattern < Sod::Action
+        include Import[:inputs]
+
+        using Refinements::Structs
+
+        description "Set file patterns."
+
+        on %w[-p --patterns], argument: "[a,b,c]"
+
+        default { Container[:configuration].patterns }
+
+        def call(patterns = default) = inputs.merge! patterns: Array(patterns)
+      end
+    end
+  end
+end

data/lib/tocer/cli/actions/root.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "refinements/structs"
+require "sod"
+
+module Tocer
+  module CLI
+    module Actions
+      # Stores table of contents root path.
+      class Root < Sod::Action
+        include Import[:inputs]
+
+        using Refinements::Structs
+
+        description "Set root directory."
+
+        on %w[-r --root], argument: "[PATH]"
+
+        default { Container[:configuration].root_dir }
+
+        def call(path = default) = inputs.merge! root_dir: Pathname(path)
+      end
+    end
+  end
+end

data/lib/tocer/cli/commands/upsert.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require "pathname"
+require "refinements/structs"
+require "sod"
+
+module Tocer
+  module CLI
+    module Commands
+      # Stores table of contents root path.
+      class Upsert < Sod::Command
+        include Import[:inputs, :kernel]
+
+        handle "upsert"
+
+        description "Update/insert table of contents."
+
+        on Actions::Root
+        on Actions::Label
+        on Actions::Pattern
+
+        def initialize(runner: Runner.new, **)
+          super(**)
+          @runner = runner
+        end
+
+        def call = runner.call inputs
+
+        private
+
+        attr_reader :runner
+      end
+    end
+  end
+end

data/lib/tocer/cli/shell.rb

@@ -1,36 +1,39 @@
 # frozen_string_literal: true
 
-require "core"
+require "sod"
 
 module Tocer
   module CLI
     # The main Command Line Interface (CLI) object.
     class Shell
-      include Actions::Import[:config, :insert, :specification, :logger]
+      include Import[:defaults_path, :xdg_config, :specification]
 
-      def initialize(parser: Parser.new, **)
+      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
-        puts error.message
-      end
+      def call(...) = cli.call(...)
 
       private
 
-      attr_reader :parser
+      attr_reader :context, :dsl
+
+      def cli
+        context = build_context
 
-      def act_on configuration
-        case configuration
-          in action_config: Symbol => action then config.call action
-          in action_insert: true then insert.call configuration
-          in action_version: true then logger.info { specification.labeled_version }
-          else logger.any { parser.to_s }
+        dsl.new :tocer, banner: specification.banner do
+          on(Sod::Prefabs::Commands::Config, context:)
+          on Commands::Upsert
+          on(Sod::Prefabs::Actions::Version, context:)
+          on Sod::Prefabs::Actions::Help, self
         end
       end
+
+      def build_context
+        context[defaults_path:, xdg_config:, version_label: specification.labeled_version]
+      end
     end
   end
 end

data/lib/tocer/configuration/contract.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require "dry/schema"
+require "etcher"
+
+Dry::Schema.load_extensions :monads
+
+module Tocer
+  module Configuration
+    Contract = Dry::Schema.Params do
+      required(:label).filled :string
+      required(:patterns).array :string
+      required(:root_dir).filled Etcher::Types::Pathname
+    end
+  end
+end

data/lib/tocer/configuration/defaults.yml

@@ -1,4 +1,4 @@
-:label: "## Table of Contents"
-:includes:
+label: "## Table of Contents"
+patterns:
   - "README.md"
-:root_dir: "."
+root_dir: "."

data/lib/tocer/configuration/model.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Tocer
+  module Configuration
+    # Defines the content of the configuration for use throughout the gem.
+    Model = Struct.new :label, :root_dir, :patterns do
+      def initialize(**)
+        super
+        self[:patterns] = Array patterns
+      end
+    end
+  end
+end

data/lib/tocer/container.rb

@@ -2,6 +2,8 @@
 
 require "cogger"
 require "dry-container"
+require "etcher"
+require "runcom"
 require "spek"
 
 module Tocer
@@ -9,9 +11,21 @@ module Tocer
   module Container
     extend Dry::Container::Mixin
 
-    register(:configuration) { Configuration::Loader.call }
+    register :configuration do
+      self[:defaults].add_loader(Etcher::Loaders::YAML.new(self[:xdg_config].active))
+                     .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(:inputs, memoize: true) { self[:configuration].dup }
+    register(:defaults_path) { Pathname(__dir__).join("configuration/defaults.yml") }
+    register(:xdg_config) { Runcom::Config.new "tocer/configuration.yml" }
     register(:specification) { Spek::Loader.call "#{__dir__}/../../tocer.gemspec" }
     register(:kernel) { Kernel }
-    register(:logger) { Cogger::Client.new }
+    register(:logger) { Cogger.new formatter: :emoji }
   end
 end

data/lib/tocer/rake/register.rb

@@ -19,8 +19,8 @@ module Tocer
       end
 
       def call
-        desc "Insert/Update Table of Contents"
-        task :toc, %i[label includes] do |_task, arguments|
+        desc "Update/Insert Table of Contents"
+        task :toc, %i[label patterns] do |_task, arguments|
           runner.call configuration.merge(arguments.to_h)
         end
       end

data/lib/tocer/runner.rb

@@ -5,18 +5,23 @@ require "refinements/pathnames"
 module Tocer
   # Generates/updates Table of Contents for files in root path.
   class Runner
+    include Import[:kernel]
+
     using Refinements::Pathnames
 
-    def initialize writer: Writer.new
+    def initialize(writer: Writer.new, **)
+      super(**)
       @writer = writer
     end
 
-    def call configuration = Container[:configuration]
-      Pathname(configuration.root_dir).files(%({#{configuration.includes.join ","}}))
-                                      .each do |path|
-                                        yield path if block_given?
-                                        writer.call path, label: configuration.label
-                                      end
+    # :reek:FeatureEnvy
+    def call configuration
+      configuration.root_dir
+                   .files(%({#{configuration.patterns.join ","}}))
+                   .each do |path|
+                     kernel.puts "  #{path}"
+                     writer.call path, label: configuration.label
+                   end
     end
 
     private

data/lib/tocer/writer.rb

@@ -24,7 +24,7 @@ module Tocer
       @builder = builder
     end
 
-    def call path, label: Configuration::Loader.call.label
+    def call path, label: Container[:configuration].label
       path.rewrite do |body|
         lines = body.each_line.to_a
         builder.prependable?(lines) ? prepend(lines, label) : replace(lines, label)

data/tocer.gemspec

@@ -2,11 +2,11 @@
 
 Gem::Specification.new do |spec|
   spec.name = "tocer"
-  spec.version = "15.1.2"
+  spec.version = "16.0.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://alchemists.io/projects/tocer"
-  spec.summary = "A command line interface for generating table of contents for Markdown files."
+  spec.summary = "A command line interface for generating Markdown table of contents."
   spec.license = "Hippocratic-2.1"
 
   spec.metadata = {
@@ -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 "cogger", "~> 0.10"
   spec.add_dependency "core", "~> 0.1"
   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-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: tocer
 version: !ruby/object:Gem::Version
-  version: 15.1.2
+  version: 16.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,14 +43,14 @@ 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
   requirement: !ruby/object:Gem::Requirement
@@ -79,22 +79,64 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.11'
+- !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
@@ -164,17 +206,14 @@ files:
 - exe/tocer
 - lib/tocer.rb
 - lib/tocer/builder.rb
-- lib/tocer/cli/actions/config.rb
-- lib/tocer/cli/actions/container.rb
-- lib/tocer/cli/actions/import.rb
-- lib/tocer/cli/actions/insert.rb
-- lib/tocer/cli/parser.rb
-- lib/tocer/cli/parsers/core.rb
-- lib/tocer/cli/parsers/flag.rb
+- lib/tocer/cli/actions/label.rb
+- lib/tocer/cli/actions/pattern.rb
+- lib/tocer/cli/actions/root.rb
+- lib/tocer/cli/commands/upsert.rb
 - lib/tocer/cli/shell.rb
-- lib/tocer/configuration/content.rb
+- lib/tocer/configuration/contract.rb
 - lib/tocer/configuration/defaults.yml
-- lib/tocer/configuration/loader.rb
+- lib/tocer/configuration/model.rb
 - lib/tocer/container.rb
 - lib/tocer/elements/comment_block.rb
 - lib/tocer/import.rb
@@ -212,8 +251,8 @@ 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 generating table of contents for Markdown files.
+summary: A command line interface for generating Markdown table of contents.
 test_files: []

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

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

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

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-require "dry/container"
-
-module Tocer
-  module CLI
-    module Actions
-      # Provides a single container with application and action specific dependencies.
-      module Container
-        extend Dry::Container::Mixin
-
-        merge Tocer::Container
-
-        register(:config) { Config.new }
-        register(:insert) { Insert.new }
-      end
-    end
-  end
-end

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

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

data/lib/tocer/cli/actions/insert.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-module Tocer
-  module CLI
-    module Actions
-      # Handles the insert action.
-      class Insert
-        include Tocer::Import[:logger]
-
-        def initialize(runner: Runner.new, **)
-          super(**)
-          @runner = runner
-        end
-
-        def call configuration
-          runner.call(configuration) { |path| logger.info { "  #{path}" } }
-        end
-
-        private
-
-        attr_reader :runner
-      end
-    end
-  end
-end

data/lib/tocer/cli/parser.rb

@@ -1,35 +0,0 @@
-# frozen_string_literal: true
-
-require "core"
-require "optparse"
-
-module Tocer
-  module CLI
-    # Assembles and parses all Command Line Interface (CLI) options.
-    class Parser
-      include Import[:configuration]
-
-      CLIENT = OptionParser.new nil, 40, "  "
-      SECTIONS = [Parsers::Core, Parsers::Flag].freeze # Order matters.
-
-      def initialize(sections: SECTIONS, client: CLIENT, **)
-        super(**)
-        @sections = sections
-        @client = client
-        @configuration_duplicate = configuration.dup
-      end
-
-      def call arguments = Core::EMPTY_ARRAY
-        sections.each { |parser| parser.call configuration_duplicate, client: }
-        client.parse arguments
-        configuration_duplicate.freeze
-      end
-
-      def to_s = client.to_s
-
-      private
-
-      attr_reader :sections, :client, :configuration_duplicate
-    end
-  end
-end

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

@@ -1,74 +0,0 @@
-# frozen_string_literal: true
-
-require "core"
-require "refinements/structs"
-
-module Tocer
-  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: edit or view."
-          ) do |action|
-            configuration.merge! action_config: action
-          end
-        end
-
-        def add_insert
-          root_dir = configuration.root_dir
-
-          client.on(
-            "-i",
-            "--insert [PATH]",
-            %(Insert/update table of contents. Default: "#{root_dir}".)
-          ) do |path|
-            configuration.merge! action_insert: true, root_dir: path || root_dir
-          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
-      end
-    end
-  end
-end

data/lib/tocer/cli/parsers/flag.rb

@@ -1,52 +0,0 @@
-# frozen_string_literal: true
-
-require "core"
-require "refinements/structs"
-
-module Tocer
-  module CLI
-    module Parsers
-      # Handles parsing of Command Line Interface (CLI) flags.
-      class Flag
-        using Refinements::Structs
-
-        def self.call(...) = new(...).call
-
-        def initialize configuration = Container[:configuration], client: Parser::CLIENT
-          @configuration = configuration
-          @client = client
-        end
-
-        def call arguments = ::Core::EMPTY_ARRAY
-          client.separator "\nOPTIONS:\n"
-          private_methods.sort.grep(/add_/).each { |method| __send__ method }
-          client.parse arguments
-          configuration
-        end
-
-        private
-
-        attr_reader :configuration, :client
-
-        def add_label
-          client.on(
-            "--label [LABEL]",
-            %(Add label. Default: "#{configuration.label}".)
-          ) do |value|
-            configuration.merge! label: value if value
-          end
-        end
-
-        def add_include
-          client.on(
-            "--includes [a,b,c]",
-            Array,
-            %(Add include patterns. Default: #{configuration.includes}.)
-          ) do |items|
-            configuration.merge! includes: items if items
-          end
-        end
-      end
-    end
-  end
-end

data/lib/tocer/configuration/content.rb

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-module Tocer
-  module Configuration
-    # Defines the content of the configuration for use throughout the gem.
-    Content = Struct.new(
-      :action_config,
-      :action_help,
-      :action_insert,
-      :action_version,
-      :includes,
-      :label,
-      :root_dir,
-      keyword_init: true
-    ) do
-      def initialize *arguments
-        super
-        freeze
-      end
-    end
-  end
-end

data/lib/tocer/configuration/loader.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-require "pathname"
-require "refinements/structs"
-require "runcom"
-require "yaml"
-
-module Tocer
-  module Configuration
-    # Represents the fully assembled Command Line Interface (CLI) configuration.
-    class Loader
-      using Refinements::Structs
-
-      DEFAULTS = YAML.load_file(Pathname(__dir__).join("defaults.yml")).freeze
-      CLIENT = Runcom::Config.new "tocer/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)
-
-      private
-
-      attr_reader :content, :client
-    end
-  end
-end