tocer 15.2.0 → 16.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 243224018a4fff16b6b0127a6131ef9ac45268a6eb8324b80093ca401901017b
-  data.tar.gz: f6c960e90162dc393b6e79f1aef75d87cf861b7aeda7daedd02a5e0dfc6e2b19
+  metadata.gz: a0d436c9b31e04495a19a9f7c5acc14e3e9ff6c367602ff4a9ca07aa10a4ea8d
+  data.tar.gz: 020ac653eb699ab2fba976834a433d0c87fa28a642c52580e0c38889a1ba8e5a
 SHA512:
-  metadata.gz: f224aeeca9421ed4b9d0aa9f2a97f172ff10b82051e5aaeb7425bc49259f898aece309080d2996f198907f0dee36b2722738c53d901719df6af6df118d32cec0
-  data.tar.gz: b9beb16da6edd1c70876e3b8477939f0084ca794566a05d4bc64d4727acddf2c7e252b59cb6183dea12f97159cda930fd7de8439a47ad9762fc8648d32b797d2
+  metadata.gz: 3a519423c227b8e3c839b9a6146e2f53ca390e768f97910860fbdc75e6859d9b0f243cd064037dcfcc8390a7bb82f47bca43f1c842ae3a069a2bf57a337c27ac
+  data.tar.gz: ff20d97e77e6eb0c05c7ab3234c15949905903ebd8774a8b5c719015966b1b3b878a9dac6b893ee8bb6ded1530071de6a521faad16e245cb5af85f113017971b

data/README.adoc

@@ -58,15 +58,18 @@ bundle add 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
@@ -93,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
@@ -105,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:
@@ -113,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[:input]
+
+        using Refinements::Structs
+
+        description "Set label."
+
+        on %w[-l --label], argument: "[TEXT]"
+
+        default { Container[:configuration].label }
+
+        def call(label = default) = input.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[:input]
+
+        using Refinements::Structs
+
+        description "Set file patterns."
+
+        on %w[-p --patterns], argument: "[a,b,c]"
+
+        default { Container[:configuration].patterns }
+
+        def call(patterns = default) = input.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[:input]
+
+        using Refinements::Structs
+
+        description "Set root directory."
+
+        on %w[-r --root], argument: "[PATH]"
+
+        default { Container[:configuration].root_dir }
+
+        def call(path = default) = input.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[:input, :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 input
+
+        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, :kernel, :logger, :specification]
+      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
-        logger.error { 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 kernel.puts specification.labeled_version
-          else kernel.puts 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,7 +11,19 @@ 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(:input, 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.new formatter: :emoji }

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.2.0"
+  spec.version = "16.0.1"
   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.8"
+  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.2.0
+  version: 16.0.1
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -35,7 +35,7 @@ cert_chain:
   3n5C8/6Zh9DYTkpcwPSuIfAga6wf4nXc9m6JAw8AuMLaiWN/r/2s4zJsUHYERJEu
   gZGm4JqtuSg8pYjPeIJxS960owq+SfuC+jxqmRA54BisFCv/0VOJi7tiJVY=
   -----END CERTIFICATE-----
-date: 2023-04-13 00:00:00.000000000 Z
+date: 2023-06-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cogger
@@ -43,14 +43,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '0.10'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        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.12
+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[:kernel]
-
-        def initialize(runner: Runner.new, **)
-          super(**)
-          @runner = runner
-        end
-
-        def call configuration
-          runner.call(configuration).each { |path| kernel.puts "  #{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