tocer 11.1.0 → 12.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4ec19b457ac3dc565f57323110cbaddd9132578a736deb9553a70af366a97077
-  data.tar.gz: 95f1af9f69fb6f618f3d108b4611d96ee91efe4d64ddd54ebce08e67064cffb4
+  metadata.gz: 54f47168583181c2e9290f659b36c8666b97c55c662ea52e3bf136d0dadbb28d
+  data.tar.gz: a448262c07f51eb6bab23cbc5ef0381d15b812dda6a5bc95454fa4c1582e1863
 SHA512:
-  metadata.gz: acdf181698830f77b2e9b5fd519bb359b7d1ae3492f7cecc65b65af39030102b00a64d93fc95d500ca875198c080b5092822f89ff3a0f5bf4fd2b3baa1f99fe4
-  data.tar.gz: 68b931c8521026959aa12fee39d282b35ac987a1f4b9a2c9236413fb6fd56f3fed6c83815680fdd2e0f2873699bb45e4ea86d7586d91b5748268f59501498f8c
+  metadata.gz: 01ce7ad6fb11a30aff977bdda2b7d93a71153e2217abad79c2be279488203ef714d34b166156fa6e2df7e45aa2fa6f204a67edf84823d0ac123648f954667d4f
+  data.tar.gz: 45315d4e0d4dbb10018d84df038b7b4883e743a262a4ca2745427da8b38e2f8f67c2a9d1fdb1e5fc387028789b8ed552fcb3528a5dfa66a15a80648ebca630af

checksums.yaml.gz.sig

@@ -1,2 +1,2 @@
-�/R=K]��/�k>.+i�#b��?�Z�'I�RZ��ק�p$}�X��4g�t��1�#z����nR����iQ�0�idžGG1����Zh
-�o/���Dw��%{<����
�(*\�?R[#gݒ���*2�N�uba�󛕅���3T_Jn��Rx@�P��TU�C
0
+��e~pJ��
��Hݸ�"�,4�pto�[�^��v����_���3����Ҿ?oM,|�������Lp�� -B�\ڶ�K�)�瑄�ֳa�QΝ>|1�Q�龞5�6�z�Ё�o���t�)Y{k���.+g�B�穚�ʀ�����ع@��_�}b���+������;A{
�!y�µ
+Rc�3g�ѬR[Ns���#,������rN��M�$�+ѨyX�.f��Z^�v�X��	�@��̏����0���

data/README.adoc

@@ -45,22 +45,18 @@ gem install tocer
 
 === Command Line Interface (CLI)
 
-From the command line, type: `+tocer --help+`
+From the command line, run: `tocer --help`
 
 ....
-tocer -c, [--config]         # Manage gem configuration.
-tocer -g, [--generate=PATH]  # Generate table of contents.
-tocer -h, [--help=COMMAND]   # Show this message or get help for a command.
-tocer -v, [--version]        # Show gem version.
-....
-
-For specific `+--generate+` options, run `+tocer --help --generate+` to see the following:
-
-....
--l, [--label=LABEL]             # Label
-                                # Default: ## Table of Contents
--i, [--includes=one two three]  # File include list
-                                # Default: ["README.md"]
+USAGE:
+  -b, --build [PATH]                       Build table of contents. Default path: "."
+  -c, --config ACTION                      Manage gem configuration: edit or view.
+  -h, --help                               Show this message.
+  -v, --version                            Show gem version.
+
+BUILD OPTIONS:
+  -i, --includes [a,b,c]                   Include pattern list. Default: ["README.md"].
+  -l, --label [LABEL]                      Label. Default: "## Table of Contents".
 ....
 
 To generate the table of contents at a specific position within your Markdown files, add the
@@ -72,10 +68,6 @@ following lines to your file(s) prior to generation:
 <!-- Tocer[finish] -->
 ----
 
-Alternatively, you can run `+tocer -g <directory>+` on files that do not have Tocer support and it
-will prepend the table of contents to your file(s), complete with an auto-generated table of
-contents.
-
 In the case that Tocer has already auto-generated a table of contents for a Markdown file, the
 existing table of contents has become stale, or placement of the table of contents has changed you
 can re-run Tocer on that file to auto-update it with new table of contents.
@@ -101,8 +93,8 @@ 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. Default: `"# Table of Contents"`.
-* `includes`: The list of included files. Default: `"*.md"`.
+* `label`: The header label for the table of contents.
+* `includes`: The list of included files.
 
 There are multiple ways the include list can be defined. Here are some examples:
 

data/bin/tocer

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

data/lib/tocer.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "tocer/identity"
-require "tocer/configuration"
 require "tocer/elements/comment_block"
 require "tocer/parsers/header"
 require "tocer/transformers/link"
@@ -10,4 +9,12 @@ require "tocer/transformers/finder"
 require "tocer/builder"
 require "tocer/writer"
 require "tocer/runner"
-require "tocer/cli"
+require "tocer/cli/configuration/content"
+require "tocer/cli/configuration/loader"
+require "tocer/cli/parsers"
+require "tocer/cli/parsers/build"
+require "tocer/cli/parsers/core"
+require "tocer/cli/parsers/assembler"
+require "tocer/cli/processors/build"
+require "tocer/cli/processors/config"
+require "tocer/cli/shell"

data/lib/tocer/builder.rb

@@ -3,7 +3,7 @@
 require "forwardable"
 
 module Tocer
-  # Builds a table of contents for a Markdown document.
+  # Builds table of contents for a Markdown document.
   class Builder
     extend Forwardable
 
@@ -11,33 +11,35 @@ module Tocer
 
     def_delegators :comment_block, :start_index, :finish_index, :prependable?
 
-    def initialize label: "## Table of Contents", comment_block: Elements::CommentBlock.new
-      @label = label
+    def initialize comment_block: Elements::CommentBlock.new, transformer: Transformers::Finder.new
       @comment_block = comment_block
+      @transformer = transformer
       @url_count = Hash.new 0
       @code_block = false
     end
 
-    def call lines
+    def call lines, label: CLI::Configuration::Loader.call.label
       return "" if headers(lines).empty?
 
-      [
-        "#{comment_block.start_tag}\n\n",
-        "#{label}\n\n",
-        links(lines).join("\n"),
-        "\n\n#{comment_block.finish_tag}\n"
-      ].join
+      assemble(lines, label).join
     end
 
     private
 
-    attr_reader :label, :comment_block, :url_count
+    attr_reader :comment_block, :transformer, :url_count
     attr_accessor :code_block
 
-    def links lines
-      headers(lines).map { |markdown| transform markdown }
+    def assemble lines, label
+      [
+        "#{comment_block.start_tag}\n\n",
+        "#{label}\n\n",
+        links(lines).join("\n"),
+        "\n\n#{comment_block.finish_tag}\n"
+      ]
     end
 
+    def links(lines) = headers(lines).map { |markdown| transform markdown }
+
     def headers lines
       lines.select do |line|
         toggle_code_block line
@@ -52,16 +54,14 @@ module Tocer
     end
 
     def transform markdown
-      Transformers::Finder.new.call(markdown).then do |transformer|
-        url = transformer.url
-        link = transformer.call url_suffix: url_suffix(url)
+      transformer.call(markdown).then do |instance|
+        url = instance.url
+        link = instance.call url_suffix: url_suffix(url)
         url_count[url] += 1
         link
       end
     end
 
-    def url_suffix url
-      url_count[url].then { |count| count.zero? ? "" : count }
-    end
+    def url_suffix(url) = url_count[url].then { |count| count.zero? ? "" : count }
   end
 end

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

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Tocer
+  module CLI
+    module Configuration
+      # Defines the content of the configuration for use throughout the gem.
+      Content = Struct.new :label, :includes, keyword_init: true
+    end
+  end
+end

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

@@ -0,0 +1,3 @@
+:label: "## Table of Contents"
+:includes:
+  - "README.md"

data/lib/tocer/cli/configuration/loader.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require "pathname"
+require "refinements/structs"
+require "runcom"
+require "yaml"
+
+module Tocer
+  module CLI
+    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 "#{Identity::NAME}/configuration.yml", defaults: DEFAULTS
+
+        def self.call = new.call
+
+        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
+end

data/lib/tocer/cli/parsers.rb

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

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

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Tocer
+  module CLI
+    module Parsers
+      # Assembles and parses all Command Line Interface (CLI) options.
+      class Assembler
+        SECTIONS = [Core, Build].freeze # Order is important.
+
+        def initialize configuration: CLI::Configuration::Loader.call,
+                       sections: SECTIONS,
+                       client: CLIENT
+          @options = configuration.to_h
+          @sections = sections
+          @client = client
+        end
+
+        def call arguments = []
+          sections.each { |parser| parser.call client: client, options: options }
+          client.parse! arguments
+          options
+        end
+
+        def to_h = options
+
+        def to_s = client.to_s
+
+        private
+
+        attr_reader :options, :sections, :client
+      end
+    end
+  end
+end

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

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Tocer
+  module CLI
+    module Parsers
+      # Handles parsing of Command Line Interface (CLI) build options.
+      class Build
+        def self.call options: {}, configuration: Configuration::Loader.call, client: CLIENT
+          new(options: options, configuration: configuration, client: client).call
+        end
+
+        def initialize options: {}, configuration: Configuration::Loader.call, client: CLIENT
+          @options = options
+          @configuration = configuration
+          @client = client
+        end
+
+        def call arguments = []
+          client.separator "\nBUILD OPTIONS:\n"
+          private_methods.sort.grep(/add_/).each { |method| __send__ method }
+          arguments.empty? ? arguments : client.parse!(arguments)
+        end
+
+        private
+
+        attr_reader :options, :configuration, :client
+
+        def add_label
+          client.on(
+            "-l",
+            "--label [LABEL]",
+            %(Label. Default: "#{CLI::Configuration::Loader.call.label}".)
+          ) do |value|
+            options[:label] = value || configuration.to_h.fetch(:label)
+          end
+        end
+
+        def add_include
+          client.on(
+            "-i",
+            "--includes [a,b,c]",
+            Array,
+            %(Include pattern list. Default: #{CLI::Configuration::Loader.call.includes}.)
+          ) do |value|
+            list = Array value
+            options[:includes] = list.empty? ? configuration.to_h.fetch(:includes) : list
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require "tocer/identity"
+
+module Tocer
+  module CLI
+    module Parsers
+      # Handles parsing of Command Line Interface (CLI) core options.
+      class Core
+        def self.call(options: {}, client: CLIENT) = new(options: options, client: client).call
+
+        def initialize options: {}, client: CLIENT
+          @options = options
+          @client = client
+        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 :options, :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|
+            options[:config] = action
+          end
+        end
+
+        def add_build
+          client.on "-b", "--build [PATH]", %(Build table of contents. Default path: ".") do |value|
+            options[:build] = value || "."
+          end
+        end
+
+        def add_version
+          client.on "-v", "--version", "Show gem version." do
+            options[:version] = Identity::VERSION_LABEL
+          end
+        end
+
+        def add_help
+          client.on "-h", "--help", "Show this message." do
+            options[:help] = true
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tocer/cli/processors/build.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Tocer
+  module CLI
+    module Processors
+      # Handles the Command Line Interface (CLI) for building of table of contents.
+      class Build
+        def initialize runner: Runner.new
+          @runner = runner
+        end
+
+        def call root_dir = ".", configuration = {}
+          runner.call(root_dir: root_dir, **configuration.slice(:label, :includes)) do |path|
+            puts "  #{path}"
+          end
+        end
+
+        private
+
+        attr_reader :runner
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Tocer
+  module CLI
+    module Processors
+      # Handles the Command Line Interface (CLI) configuration processing.
+      class Config
+        def initialize configuration: CLI::Configuration::Loader::CLIENT, kernel: Kernel
+          @configuration = configuration
+          @kernel = kernel
+        end
+
+        def call action
+          case action
+            when :edit then edit
+            when :view then view
+            else fail StandardError, "Invalid configuration action: #{action}."
+          end
+        end
+
+        private
+
+        attr_reader :configuration, :kernel
+
+        def edit = kernel.system("$EDITOR #{configuration.current}")
+
+        def view = kernel.system("cat #{configuration.current}")
+      end
+    end
+  end
+end

data/lib/tocer/cli/shell.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Tocer
+  module CLI
+    # The main Command Line Interface (CLI) object.
+    class Shell
+      PROCESSORS = {config: Processors::Config.new, build: Processors::Build.new}.freeze
+
+      def initialize parser: Parsers::Assembler.new, processors: PROCESSORS
+        @parser = parser
+        @processors = processors
+      end
+
+      def call arguments = []
+        parse arguments
+
+        case options
+          in config: action then process_config action
+          in build: path then process_build path
+          in version: then puts version
+          else usage
+        end
+      end
+
+      private
+
+      attr_reader :parser, :processors
+
+      def parse arguments = []
+        parser.call arguments
+      rescue StandardError => error
+        puts error.message
+      end
+
+      def process_config(action) = processors.fetch(:config).call(action)
+
+      def process_build(path) = processors.fetch(:build).call(path, options)
+
+      def options = parser.to_h
+
+      def usage = puts(parser.to_s)
+    end
+  end
+end

data/lib/tocer/elements/comment_block.rb

@@ -17,33 +17,21 @@ module Tocer
         @message = message
       end
 
-      def start_index lines
-        self.class.index lines, start_id
-      end
+      def start_index(lines) = self.class.index(lines, start_id)
 
-      def start_tag
-        comment start_id, message
-      end
+      def start_tag = comment(start_id, message)
 
-      def finish_index lines
-        self.class.index lines, finish_id
-      end
+      def finish_index(lines) = self.class.index(lines, finish_id)
 
-      def finish_tag
-        comment finish_id, message
-      end
+      def finish_tag = comment(finish_id, message)
 
-      def prependable? lines
-        start_index(lines).zero? && finish_index(lines).zero?
-      end
+      def prependable?(lines) = start_index(lines).zero? && finish_index(lines).zero?
 
       private
 
       attr_reader :start_id, :finish_id, :message
 
-      def comment id, message
-        "<!-- #{id}: #{message} -->"
-      end
+      def comment(id, message) = "<!-- #{id}: #{message} -->"
     end
   end
 end

data/lib/tocer/identity.rb

@@ -5,7 +5,8 @@ module Tocer
   module Identity
     NAME = "tocer"
     LABEL = "Tocer"
-    VERSION = "11.1.0"
+    VERSION = "12.0.3"
     VERSION_LABEL = "#{LABEL} #{VERSION}"
+    SUMMARY = "A command line interface for generating table of contents for Markdown files."
   end
 end

data/lib/tocer/parsers/header.rb

@@ -10,13 +10,9 @@ module Tocer
         @markdown = markdown
       end
 
-      def prefix
-        String markdown[/#{PUNCTUATION}{1,}/o]
-      end
+      def prefix = String(markdown[/#{PUNCTUATION}{1,}/o])
 
-      def content
-        markdown[prefix.length + 1, markdown.length].strip
-      end
+      def content = markdown[prefix.length + 1, markdown.length].strip
 
       private
 

data/lib/tocer/rake/tasks.rb

@@ -2,17 +2,18 @@
 
 require "rake"
 require "tocer"
+require "refinements/structs"
 
 module Tocer
   module Rake
+    # Provides Rake tasks for convenience.
     class Tasks
       include ::Rake::DSL
+      using Refinements::Structs
 
-      def self.setup
-        new.install
-      end
+      def self.setup = new.install
 
-      def initialize configuration: Tocer::Configuration.default, runner: Runner
+      def initialize configuration: CLI::Configuration::Loader.new.call, runner: Runner.new
         @configuration = configuration
         @runner = runner
       end
@@ -20,9 +21,7 @@ module Tocer
       def install
         desc "Add/Update Table of Contents (README)"
         task :toc, %i[label includes] do |_task, arguments|
-          inputs = {label: arguments[:label], includes: arguments[:includes]}.compact
-          updated_configuration = configuration.merge inputs
-          runner.new(configuration: updated_configuration.to_h).call
+          runner.call(**configuration.merge(**arguments.to_h).to_h)
         end
       end
 

data/lib/tocer/runner.rb

@@ -1,32 +1,27 @@
 # frozen_string_literal: true
 
-require "pathname"
+require "refinements/pathnames"
 
 module Tocer
-  # Generates/updates Table of Contents for files in given path.
+  # Generates/updates Table of Contents for files in root path.
   class Runner
-    def initialize path = ".", configuration: {}, writer: Writer
-      @path = Pathname path
+    using Refinements::Pathnames
+
+    def initialize configuration: CLI::Configuration::Loader.call, writer: Writer.new
       @configuration = configuration
       @writer = writer
     end
 
-    def files
-      return [] unless path.exist? && path.directory? && !includes.empty?
-
-      Pathname.glob(%(#{path}/{#{includes.join ","}})).select(&:file?)
-    end
-
-    def call
-      files.each { |file| writer.new(file, label: configuration.fetch(:label)).call }
+    def call root_dir: ".", label: configuration.label, includes: configuration.includes
+      Pathname(root_dir).files(%({#{includes.join ","}}))
+                        .each do |path|
+                          yield path if block_given?
+                          writer.call path, label: label
+                        end
     end
 
     private
 
-    attr_reader :path, :configuration, :writer
-
-    def includes
-      Array configuration[:includes]
-    end
+    attr_reader :configuration, :writer
   end
 end

data/lib/tocer/transformers/finder.rb

@@ -4,10 +4,7 @@ module Tocer
   module Transformers
     # Finds appropriate header transformer for matching pattern.
     class Finder
-      TRANSFORMERS = {
-        /\[.+\]\(.+\)/ => Transformers::Link,
-        /.*/ => Transformers::Text
-      }.freeze
+      TRANSFORMERS = {/\[.+\]\(.+\)/ => Transformers::Link, /.*/ => Transformers::Text}.freeze
 
       def initialize transformers: TRANSFORMERS
         @transformers = transformers

data/lib/tocer/transformers/link.rb

@@ -12,45 +12,27 @@ module Tocer
         @parser = parser.new text
       end
 
-      def label
-        parser.content.gsub embedded_link, embedded_link_label
-      end
+      def label = parser.content.gsub(embedded_link, embedded_link_label)
 
-      def url
-        label.downcase.gsub(/\s/, "-").gsub(/[^\w\-]+/, "")
-      end
+      def url = label.downcase.gsub(/\s/, "-").gsub(/[^\w\-]+/, "")
 
-      def call url_suffix: ""
-        "#{indented_bullet}[#{label}](##{computed_url url_suffix})"
-      end
+      def call(url_suffix: "") = "#{indented_bullet}[#{label}](##{computed_url url_suffix})"
 
       private
 
       attr_reader :parser
 
-      def computed_url suffix = ""
-        [url, suffix.to_s].compress.join "-"
-      end
+      def computed_url(suffix = "") = [url, suffix.to_s].compress.join("-")
 
-      def embedded_link
-        "[#{embedded_link_label}](#{embedded_link_url})"
-      end
+      def embedded_link = "[#{embedded_link_label}](#{embedded_link_url})"
 
-      def embedded_link_label
-        parser.content[/\[(.*)\]/, 1]
-      end
+      def embedded_link_label = parser.content[/\[(.*)\]/, 1]
 
-      def embedded_link_url
-        parser.content[/\((.*)\)/, 1]
-      end
+      def embedded_link_url = parser.content[/\((.*)\)/, 1]
 
-      def indented_bullet
-        prefix_to_spaces.gsub(/\s{2}$/, "- ")
-      end
+      def indented_bullet = prefix_to_spaces.gsub(/\s{2}$/, "- ")
 
-      def prefix_to_spaces
-        Array.new(parser.prefix.length, "  ").join
-      end
+      def prefix_to_spaces = Array.new(parser.prefix.length, "  ").join
     end
   end
 end

data/lib/tocer/transformers/text.rb

@@ -12,33 +12,21 @@ module Tocer
         @parser = parser.new text
       end
 
-      def label
-        parser.content
-      end
+      def label = parser.content
 
-      def url
-        label.downcase.gsub(/\s/, "-").gsub(/[^\w\-]+/, "")
-      end
+      def url = label.downcase.gsub(/\s/, "-").gsub(/[^\w\-]+/, "")
 
-      def call url_suffix: ""
-        "#{indented_bullet}[#{label}](##{computed_url url_suffix})"
-      end
+      def call(url_suffix: "") = "#{indented_bullet}[#{label}](##{computed_url url_suffix})"
 
       private
 
       attr_reader :parser
 
-      def computed_url suffix = ""
-        [url, suffix.to_s].compress.join "-"
-      end
+      def computed_url(suffix = "") = [url, suffix.to_s].compress.join("-")
 
-      def indented_bullet
-        prefix_to_spaces.gsub(/\s{2}$/, "- ")
-      end
+      def indented_bullet = prefix_to_spaces.gsub(/\s{2}$/, "- ")
 
-      def prefix_to_spaces
-        Array.new(parser.prefix.length, "  ").join
-      end
+      def prefix_to_spaces = Array.new(parser.prefix.length, "  ").join
     end
   end
 end

data/lib/tocer/writer.rb

@@ -1,8 +1,15 @@
 # frozen_string_literal: true
 
+require "refinements/arrays"
+require "refinements/pathnames"
+
 module Tocer
   # Writes table of contents to a Markdown document.
+  # :reek:DataClump
   class Writer
+    using Refinements::Arrays
+    using Refinements::Pathnames
+
     def self.add start_index:, old_lines:, new_lines:
       computed_new_lines = start_index.zero? ? new_lines : new_lines + "\n"
       old_lines.insert start_index, *computed_new_lines
@@ -13,26 +20,22 @@ module Tocer
       lines.reject.with_index { |_, index| range.include? index }
     end
 
-    def initialize file_path, label: "## Table of Contents", builder: Builder.new(label: label)
-      @file_path = file_path
+    def initialize builder: Builder.new
       @builder = builder
     end
 
-    def call
-      lines = File.readlines file_path
-      body = builder.prependable?(lines) ? prepend(lines) : replace(lines)
-      File.open(file_path, "w") { |file| file.write body }
+    def call path, label: CLI::Configuration::Loader.call.label
+      path.rewrite do |body|
+        lines = body.each_line.to_a
+        builder.prependable?(lines) ? prepend(lines, label) : replace(lines, label)
+      end
     end
 
     private
 
-    attr_reader :file_path, :builder
-
-    def content lines
-      builder.call lines
-    end
+    attr_reader :builder
 
-    def replace lines
+    def replace lines, label
       start_index = builder.start_index lines
       finish_index = builder.finish_index lines
       klass = self.class
@@ -40,12 +43,12 @@ module Tocer
       klass.add(
         start_index: start_index,
         old_lines: klass.remove(start_index, finish_index, lines),
-        new_lines: content(lines[finish_index, lines.length])
+        new_lines: content(lines[finish_index, lines.length], label)
       ).join
     end
 
-    def prepend lines
-      content(lines) + "\n" + lines.join
-    end
+    def prepend(lines, label) = [content(lines, label), lines.join].compress.join("\n")
+
+    def content(lines, label) = builder.call(lines, label: label)
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tocer
 version: !ruby/object:Gem::Version
-  version: 11.1.0
+  version: 12.0.3
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -10,9 +10,9 @@ bindir: bin
 cert_chain:
 - |
   -----BEGIN CERTIFICATE-----
-  MIIC/jCCAeagAwIBAgIBAzANBgkqhkiG9w0BAQsFADAlMSMwIQYDVQQDDBpicm9v
-  a2UvREM9YWxjaGVtaXN0cy9EQz1pbzAeFw0yMDAzMTUxNDQ1MzJaFw0yMTAzMTUx
-  NDQ1MzJaMCUxIzAhBgNVBAMMGmJyb29rZS9EQz1hbGNoZW1pc3RzL0RDPWlvMIIB
+  MIIC/jCCAeagAwIBAgIBBDANBgkqhkiG9w0BAQsFADAlMSMwIQYDVQQDDBpicm9v
+  a2UvREM9YWxjaGVtaXN0cy9EQz1pbzAeFw0yMTAzMTkxMjQ4MDZaFw0yMjAzMTkx
+  MjQ4MDZaMCUxIzAhBgNVBAMMGmJyb29rZS9EQz1hbGNoZW1pc3RzL0RDPWlvMIIB
   IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA6l1qpXTiomH1RfMRloyw7MiE
   xyVx/x8Yc3EupdH7uhNaTXQGyORN6aOY//1QXXMHIZ9tW74nZLhesWMSUMYy0XhB
   brs+KkurHnc9FnEJAbG7ebGvl/ncqZt72nQvaxpDxvuCBHgJAz+8i5wl6FhLw+oT
@@ -20,15 +20,15 @@ cert_chain:
   D5vkU0YlAm1r98BymuJlcQ1qdkVEI1d48ph4kcS0S0nv1RiuyVb6TCAR3Nu3VaVq
   3fPzZKJLZBx67UvXdbdicWPiUR75elI4PXpLIic3xytaF52ZJYyKZCNZJhNwfQID
   AQABozkwNzAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQU0nzow9vc
-  2CdikiiE3fJhP/gY4ggwDQYJKoZIhvcNAQELBQADggEBAIHhAlD3po4sTYqacXaQ
-  XI9jIhrfMy//2PgbHWcETtlJPBeNUbbSNBABcllUHKqYsVDlSvSmss034KSWNR8F
-  bF1GcloicyvcCC4y6IoW4it0COAcdeaaxkxiBSgKdQFpff9REnDlIKK4uQ9lLxIo
-  Y2G5xubiziKZkyfWFuSr67PIjW3Bu673D1JVBArhA1qbgQmYQcy1CkGOjo+iO8Nf
-  7u/QSfBHb+r/bXhKscDgPpnKwbUmvgO2+94zJG9KsrmIydlzYfsD09aXKx0t6Xy4
-  2XV8FRa7/JimI07sPLC13eLY3xd/aYTi85Z782KIA4j0G8XEEWAX0ouBhlXPocZv
-  QWc=
+  2CdikiiE3fJhP/gY4ggwDQYJKoZIhvcNAQELBQADggEBAEjpaOXHHp8s/7GL2qCb
+  YAs7urOLv9VHSPfQWAwaTMVnSsIf3Sw4xzISOP/mmfEPBPXtz61K5esrE/uTFtgb
+  FyjxQk2H0sEWgrRXGGNHBWQRhhEs7LP/TByoC15A0br++xLxRz4r7HBLGAWQQDpg
+  66BJ2TBVjxS6K64tKbq7+ACyrOZGgTfNHACh4M076y0x0oRf/rwBrU39/KRfuhbb
+  cm+nNCEtO35gTmZ2bVDHLGvWazi3gJt6+huQjfXTCUUG2YYBxwhu+GPdAGQPxpf9
+  lkHilIrX69jq8wMPpBhlaw2mRmeSL50Wv5u6xVBvOHhXFSP1crXM95vfLhLyRYod
+  W2A=
   -----END CERTIFICATE-----
-date: 2021-01-20 00:00:00.000000000 Z
+date: 2021-08-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: refinements
@@ -58,20 +58,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '7.0'
-- !ruby/object:Gem::Dependency
-  name: thor
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.20'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.20'
 description:
 email:
 - brooke@alchemists.io
@@ -87,8 +73,16 @@ files:
 - bin/tocer
 - lib/tocer.rb
 - lib/tocer/builder.rb
-- lib/tocer/cli.rb
-- lib/tocer/configuration.rb
+- lib/tocer/cli/configuration/content.rb
+- lib/tocer/cli/configuration/defaults.yml
+- lib/tocer/cli/configuration/loader.rb
+- lib/tocer/cli/parsers.rb
+- lib/tocer/cli/parsers/assembler.rb
+- lib/tocer/cli/parsers/build.rb
+- lib/tocer/cli/parsers/core.rb
+- lib/tocer/cli/processors/build.rb
+- lib/tocer/cli/processors/config.rb
+- lib/tocer/cli/shell.rb
 - lib/tocer/elements/comment_block.rb
 - lib/tocer/identity.rb
 - lib/tocer/parsers/header.rb
@@ -122,7 +116,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.5
+rubygems_version: 3.2.25
 signing_key:
 specification_version: 4
 summary: A command line interface for generating table of contents for Markdown files.

data/lib/tocer/cli.rb

@@ -1,85 +0,0 @@
-# frozen_string_literal: true
-
-require "thor"
-require "thor/actions"
-require "runcom"
-
-module Tocer
-  # The Command Line Interface (CLI) for the gem.
-  class CLI < Thor
-    include Thor::Actions
-
-    package_name Identity::VERSION_LABEL
-
-    def initialize args = [], options = {}, config = {}
-      super args, options, config
-      @configuration = Tocer::Configuration.default
-    rescue Runcom::Errors::Base => error
-      abort error.message
-    end
-
-    desc "-g, [--generate=PATH]", "Generate table of contents."
-    map %w[-g --generate] => :generate
-    method_option :label,
-                  aliases: "-l",
-                  desc: "Label",
-                  type: :string,
-                  default: Tocer::Configuration.default.to_h.fetch(:label)
-    method_option :includes,
-                  aliases: "-i",
-                  desc: "File include list",
-                  type: :array,
-                  default: Tocer::Configuration.default.to_h.fetch(:includes)
-    # :reek:TooManyStatements
-    def generate path = "."
-      updated_configuration = configuration.merge label: options.label, includes: options.includes
-      runner = Runner.new path, configuration: updated_configuration.to_h
-      files = runner.files
-
-      return if files.empty?
-
-      runner.call
-
-      say "Processed table of contents for:"
-      files.each { |file| say "  #{file}" }
-    end
-
-    desc "-c, [--config]", "Manage gem configuration."
-    map %w[-c --config] => :config
-    method_option :edit,
-                  aliases: "-e",
-                  desc: "Edit gem configuration.",
-                  type: :boolean,
-                  default: false
-    method_option :info,
-                  aliases: "-i",
-                  desc: "Print gem configuration.",
-                  type: :boolean,
-                  default: false
-    def config
-      path = configuration.current
-
-      if options.edit? then `#{ENV["EDITOR"]} #{path}`
-      elsif options.info?
-        path ? say(path) : say("Configuration doesn't exist.")
-      else help :config
-      end
-    end
-
-    desc "-v, [--version]", "Show gem version."
-    map %w[-v --version] => :version
-    def version
-      say Identity::VERSION_LABEL
-    end
-
-    desc "-h, [--help=COMMAND]", "Show this message or get help for a command."
-    map %w[-h --help] => :help
-    def help task = nil
-      say and super
-    end
-
-    private
-
-    attr_reader :configuration
-  end
-end

data/lib/tocer/configuration.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-require "runcom"
-
-module Tocer
-  module Configuration
-    def self.default
-      Runcom::Config.new "#{Identity::NAME}/configuration.yml",
-                         defaults: {
-                           label: "## Table of Contents",
-                           includes: ["README.md"]
-                         }
-    end
-  end
-end