pragmater 12.2.0 → 13.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 882b859ccab89edc6bc3ac8087e2fc01b55eaed5d3e4e1e789a7635fd77bd485
-  data.tar.gz: ee6d15c015fa56a52f7deecdb7ce58cc1561957cdc2f17e39ead1ee67972f74a
+  metadata.gz: 7b8bbafa69b9ca2657b65492b451e9117b45f9ccb997d7a2eee400ca545a470d
+  data.tar.gz: 46979ac45da1860b2153bd1fcb0b60861bd0ed1ff4280d087b878ec2bdfe1ff1
 SHA512:
-  metadata.gz: '0847fdb2ab90ef4911a85a4c294dd00f2990477fadfa3cafac1785a6e92b2dc2e32f91a895b0102c48a542115dea1fee42a96ab96bbddf445e2a579bde70ccbf'
-  data.tar.gz: e1508b6eb3c052277f345d6444b4e6d11372a00a59632816975f6b17fbc3a72fbfa6e6f95f9715a8a1333f689898fa5b469d1a444f8f0d6c8cd9a9002b445529
+  metadata.gz: f43c0b2fe3751f48ab99d9f2ee9d21b81feeb1992bef7f692d3efe91dc50181c80fa2c9563fdaed7ad89e30608330a35f3bb1d6f682245c52385283e7772d7ad
+  data.tar.gz: 19996ab2e495ff39396f5e45c8bed0caad1799d40a6a2f56a91ccb4af73d89d0725a441234065872570568d899cfdafd69420f88dbc33d1485abe98afbca745b

data/README.adoc

@@ -58,27 +58,30 @@ gem install pragmater
 From the command line, type: `pragmater --help`
 
 ....
-USAGE:
-  -c, --config ACTION                      Manage gem configuration: edit or view.
-  -h, --help                               Show this message.
-  -i, --insert [PATH]                      Insert pragmas. Default: ".".
-  -r, --remove [PATH]                      Remove pragmas. Default: ".".
-  -v, --version                            Show gem version.
-
-OPTIONS:
-      --comments a,b,c                     Add pragma comments. Default: [].
-      --includes a,b,c                     Add include patterns. Default: [].
+USAGE
+  pragmater [OPTIONS]
+  pragmater COMMAND [OPTIONS]
+
+OPTIONS
+  -v, --version            Show version.
+  -h, --help [COMMAND]     Show this message.
+
+COMMANDS
+  config                   Manage configuration.
+                           Path is dynamic per current directory.
+  insert                   Insert pragma comments.
+  remove                   Remove pragma comments.
 ....
 
-Both the `--insert` and `--remove` commands support the same options for specifying pragmas and/or
+Both the `insert` and `remove` commands support the same options for specifying pragmas and/or
 included files. Example:
 
 [source,bash]
 ----
-pragmater --insert --comments "# frozen_string_literal: true" --includes "Gemfile" "Guardfile" "Rakefile" ".gemspec" "config.ru" "bin/**/*" "**/*.rake" "**/*.rb"
+pragmater insert --comments "# frozen_string_literal: true" --patterns "Gemfile" "Guardfile" "Rakefile" ".gemspec" "config.ru" "bin/**/*" "**/*.rake" "**/*.rb"
 ----
 
-The `--insert` and `--remove` commands default to the current working directory so a path isn’t
+The `insert` and `remove` commands default to the current working directory so a path isn’t
 necessary unless you want to run Pragmater in a directory structure other than your current working
 directory.
 
@@ -93,9 +96,9 @@ The default configuration is as follows:
 
 [source,yaml]
 ----
-:comments: []
-:includes: []
-:root_dir: "."
+comments: []
+patterns: []
+root_dir: "."
 ----
 
 Feel free to take the above configuration, modify, and save as your own custom `configuration.yml`.
@@ -246,7 +249,7 @@ freeze strings.
 === Consistency
 
 As an added bonus, this gem ensures pragmas for all analyzed files are formatted in a consistent
-style. This means there is always a space after the octothorpe (`#`). Here are multiple pragmas
+style. This means there is always a space after the octothorp (`#`). Here are multiple pragmas
 presented together for a visual comparison:
 
 [source,ruby]

data/lib/pragmater/cli/actions/comment.rb

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

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

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "refinements/structs"
+require "sod"
+
+module Pragmater
+  module CLI
+    module Actions
+      # Stores 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/pragmater/cli/actions/root.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "refinements/structs"
+require "sod"
+
+module Pragmater
+  module CLI
+    module Actions
+      # Stores 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/pragmater/cli/commands/insert.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require "sod"
+
+module Pragmater
+  module CLI
+    module Commands
+      # Inserts pragmas.
+      class Insert < Sod::Command
+        include Import[:inputs, :kernel]
+
+        handle "insert"
+
+        description "Insert pragma comments."
+
+        on Actions::Root
+        on Actions::Comment
+        on Actions::Pattern
+
+        def initialize(handler: Inserter.new, **)
+          super(**)
+          @handler = handler
+        end
+
+        def call = handler.call(inputs) { |path| kernel.puts path }
+
+        private
+
+        attr_reader :handler
+      end
+    end
+  end
+end

data/lib/pragmater/cli/commands/remove.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require "sod"
+
+module Pragmater
+  module CLI
+    module Commands
+      # Removes pragmas.
+      class Remove < Sod::Command
+        include Import[:inputs, :kernel]
+
+        handle "remove"
+
+        description "Remove pragma comments."
+
+        on Actions::Root
+        on Actions::Comment
+        on Actions::Pattern
+
+        def initialize(handler: Remover.new, **)
+          super(**)
+          @handler = handler
+        end
+
+        def call = handler.call(inputs) { |path| kernel.puts path }
+
+        private
+
+        attr_reader :handler
+      end
+    end
+  end
+end

data/lib/pragmater/cli/shell.rb

@@ -1,36 +1,40 @@
 # frozen_string_literal: true
 
-require "core"
+require "sod"
 
 module Pragmater
   module CLI
     # The main Command Line Interface (CLI) object.
     class Shell
-      include Actions::Import[:config, :kernel, :logger, :run, :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} | {action_remove: true} then run.call configuration
-          in action_version: true then kernel.puts specification.labeled_version
-          else kernel.puts parser.to_s
+        dsl.new :pragmater, banner: specification.banner do
+          on(Sod::Prefabs::Commands::Config, context:)
+          on Commands::Insert
+          on Commands::Remove
+          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/pragmater/configuration/contract.rb

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

data/lib/pragmater/configuration/defaults.yml

@@ -1,3 +1,3 @@
-:comments: []
-:includes: []
-:root_dir: "."
+comments: []
+patterns: []
+root_dir: "."

data/lib/pragmater/configuration/model.rb

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

data/lib/pragmater/container.rb

@@ -2,6 +2,8 @@
 
 require "cogger"
 require "dry-container"
+require "etcher"
+require "runcom"
 require "spek"
 
 module Pragmater
@@ -9,7 +11,20 @@ module Pragmater
   module Container
     extend Dry::Container::Mixin
 
-    register(:configuration) { Configuration::Loader.call }
+    # :nocov:
+    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 "pragmater/configuration.yml" }
     register(:specification) { Spek::Loader.call "#{__dir__}/../../pragmater.gemspec" }
     register(:kernel) { Kernel }
     register(:logger) { Cogger.new formatter: :emoji }

data/lib/pragmater/inserter.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "refinements/pathnames"
+
+module Pragmater
+  # Inserts pragma comments.
+  class Inserter
+    using Refinements::Pathnames
+
+    def initialize parser: Parsers::File.new
+      @parser = parser
+    end
+
+    def call configuration = Container[:configuration]
+      Pathname(configuration.root_dir).files("{#{configuration.patterns.join ","}}").map do |path|
+        yield path if block_given?
+        path.write parser.call(path, configuration.comments, action: :insert).join
+      end
+    end
+
+    private
+
+    attr_reader :parser
+  end
+end

data/lib/pragmater/remover.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "refinements/pathnames"
+
+module Pragmater
+  # Removes pragma comments.
+  class Remover
+    using Refinements::Pathnames
+
+    def initialize parser: Parsers::File.new
+      @parser = parser
+    end
+
+    def call configuration = Container[:configuration]
+      Pathname(configuration.root_dir).files("{#{configuration.patterns.join ","}}").map do |path|
+        yield path if block_given?
+        path.write parser.call(path, configuration.comments, action: :remove).join
+      end
+    end
+
+    private
+
+    attr_reader :parser
+  end
+end

data/pragmater.gemspec

@@ -2,11 +2,11 @@
 
 Gem::Specification.new do |spec|
   spec.name = "pragmater"
-  spec.version = "12.2.0"
+  spec.version = "13.0.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://alchemists.io/projects/pragmater"
-  spec.summary = "A command line interface for managing/formatting source file pragma comments."
+  spec.summary = "A command line interface for managing pragma comments."
   spec.license = "Hippocratic-2.1"
 
   spec.metadata = {
@@ -23,13 +23,15 @@ 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 "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-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: pragmater
 version: !ruby/object:Gem::Version
-  version: 12.2.0
+  version: 13.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-04-13 00:00:00.000000000 Z
+date: 2023-06-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cogger
@@ -43,58 +43,86 @@ 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
+  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-schema
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.11'
+        version: '1.13'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.11'
+        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 +136,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,28 +191,27 @@ files:
 - README.adoc
 - exe/pragmater
 - lib/pragmater.rb
-- lib/pragmater/cli/actions/config.rb
-- lib/pragmater/cli/actions/container.rb
-- lib/pragmater/cli/actions/import.rb
-- lib/pragmater/cli/actions/run.rb
-- lib/pragmater/cli/parser.rb
-- lib/pragmater/cli/parsers/core.rb
-- lib/pragmater/cli/parsers/flag.rb
+- lib/pragmater/cli/actions/comment.rb
+- lib/pragmater/cli/actions/pattern.rb
+- lib/pragmater/cli/actions/root.rb
+- lib/pragmater/cli/commands/insert.rb
+- lib/pragmater/cli/commands/remove.rb
 - lib/pragmater/cli/shell.rb
-- lib/pragmater/configuration/content.rb
+- lib/pragmater/configuration/contract.rb
 - lib/pragmater/configuration/defaults.yml
-- lib/pragmater/configuration/loader.rb
+- lib/pragmater/configuration/model.rb
 - lib/pragmater/container.rb
 - lib/pragmater/formatters/general.rb
 - lib/pragmater/formatters/main.rb
 - lib/pragmater/formatters/shebang.rb
 - lib/pragmater/import.rb
+- lib/pragmater/inserter.rb
 - lib/pragmater/parsers/comments.rb
 - lib/pragmater/parsers/file.rb
 - lib/pragmater/processors/handler.rb
 - lib/pragmater/processors/inserter.rb
 - lib/pragmater/processors/remover.rb
-- lib/pragmater/runner.rb
+- lib/pragmater/remover.rb
 - pragmater.gemspec
 homepage: https://alchemists.io/projects/pragmater
 licenses:
@@ -212,8 +239,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 managing/formatting source file pragma comments.
+summary: A command line interface for managing pragma comments.
 test_files: []

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

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-module Pragmater
-  module CLI
-    module Actions
-      # Handles the config action.
-      class Config
-        include Pragmater::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/pragmater/cli/actions/container.rb

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

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

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

data/lib/pragmater/cli/actions/run.rb

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-module Pragmater
-  module CLI
-    module Actions
-      # Handles insert or remove actions.
-      class Run
-        include Pragmater::Import[:kernel]
-
-        def initialize(runner: Runner.new, **)
-          super(**)
-          @runner = runner
-        end
-
-        def call(configuration) = runner.call(configuration) { |path| kernel.puts path }
-
-        private
-
-        attr_reader :runner
-      end
-    end
-  end
-end

data/lib/pragmater/cli/parser.rb

@@ -1,35 +0,0 @@
-# frozen_string_literal: true
-
-require "core"
-require "optparse"
-
-module Pragmater
-  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 { |section| section.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/pragmater/cli/parsers/core.rb

@@ -1,74 +0,0 @@
-# frozen_string_literal: true
-
-require "core"
-require "refinements/structs"
-
-module Pragmater
-  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
-          client.on "-i", "--insert [PATH]", %(Insert pragmas. Default: "#{root_dir}".) do |path|
-            configuration.merge! action_insert: true, root_dir: path || root_dir
-          end
-        end
-
-        def add_remove
-          client.on "-r", "--remove [PATH]", %(Remove pragmas. Default: "#{root_dir}".) do |path|
-            configuration.merge! action_remove: 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
-
-        def root_dir = configuration.root_dir
-      end
-    end
-  end
-end

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

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-require "core"
-require "refinements/structs"
-
-module Pragmater
-  module CLI
-    module Parsers
-      # Parses common command line 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"
-          collate
-          client.parse arguments
-          configuration
-        end
-
-        private
-
-        attr_reader :configuration, :client
-
-        def collate = private_methods.sort.grep(/add_/).each { |method| __send__ method }
-
-        def add_comments
-          client.on "--comments a,b,c", Array, "Add pragma comments. Default: []." do |comments|
-            configuration.merge! comments:
-          end
-        end
-
-        def add_includes
-          client.on "--includes a,b,c", Array, "Add include patterns. Default: []." do |includes|
-            configuration.merge! includes:
-          end
-        end
-      end
-    end
-  end
-end

data/lib/pragmater/configuration/content.rb

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

data/lib/pragmater/configuration/loader.rb

@@ -1,35 +0,0 @@
-# frozen_string_literal: true
-
-require "pathname"
-require "refinements/hashes"
-require "refinements/structs"
-require "runcom"
-require "yaml"
-
-module Pragmater
-  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 "pragmater/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

data/lib/pragmater/runner.rb

@@ -1,37 +0,0 @@
-# frozen_string_literal: true
-
-require "refinements/pathnames"
-
-module Pragmater
-  # Adds/removes pragma comments for files in given path.
-  class Runner
-    include Import[:logger]
-
-    using Refinements::Pathnames
-
-    def initialize(parser: Parsers::File.new, **)
-      super(**)
-      @parser = parser
-    end
-
-    def call configuration = Container[:configuration]
-      Pathname(configuration.root_dir).files("{#{configuration.includes.join ","}}").map do |path|
-        yield path if block_given?
-
-        case configuration
-          in action_insert: true then write path, configuration, :insert
-          in action_remove: true then write path, configuration, :remove
-          else logger.error { "Unknown run action. Use insert or remove." }
-        end
-      end
-    end
-
-    private
-
-    attr_reader :parser
-
-    def write path, configuration, action
-      path.write parser.call(path, configuration.comments, action:).join
-    end
-  end
-end