sleeping_king_studios-docs 0.2.1 → 0.3.0

data/lib/sleeping_king_studios/docs.rb

@@ -1,27 +1,39 @@
 # frozen_string_literal: true
 
+require 'cuprum/cli'
+require 'sleeping_king_studios/tools'
+
 # Hic iacet Arthurus, rex quondam, rexque futurus.
 module SleepingKingStudios
   # Tooling for working with YARD documentation.
   module Docs
-    class << self
-      # @return [String] the absolute path to the gem directory.
-      def gem_path
-        pattern = /#{File.join('', 'lib', 'sleeping_king_studios', '')}?\z/
-
-        __dir__.sub(pattern, '')
-      end
-
-      # @return [String] The current version of the gem.
-      def version
-        VERSION
-      end
+    autoload :Data,   'sleeping_king_studios/docs/data'
+    autoload :Errors, 'sleeping_king_studios/docs/errors'
+    autoload :Jekyll, 'sleeping_king_studios/docs/jekyll'
+    autoload :Yard,   'sleeping_king_studios/docs/yard'
+
+    @initializer = SleepingKingStudios::Tools::Toolbox::Initializer.new do
+      Cuprum::Cli.initializer.call
+
+      SleepingKingStudios::Tools.initializer.call
     end
 
-    autoload :Commands,      'sleeping_king_studios/docs/commands'
-    autoload :Data,          'sleeping_king_studios/docs/data'
-    autoload :Errors,        'sleeping_king_studios/docs/errors'
-    autoload :Registry,      'sleeping_king_studios/docs/registry'
-    autoload :RegistryQuery, 'sleeping_king_studios/docs/registry_query'
+    # @return [String] the absolute path to the gem directory.
+    def self.gem_path
+      pattern = /#{File.join('', 'lib', 'sleeping_king_studios', '')}?\z/
+
+      __dir__.sub(pattern, '')
+    end
+
+    # @return [SleepingKingStudios::Tools::Toolbox::Initializer] the initializer
+    #   for the module.
+    def self.initializer
+      @initializer
+    end
+
+    # @return [String] The current version of the gem.
+    def self.version
+      VERSION
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sleeping_king_studios-docs
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Rob "Merlin" Smith
@@ -29,6 +29,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.3.1
+- !ruby/object:Gem::Dependency
+  name: cuprum-cli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: erubi
   requirement: !ruby/object:Gem::Requirement
@@ -44,25 +58,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.13'
 - !ruby/object:Gem::Dependency
-  name: sleeping_king_studios-tools
+  name: plumbum
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.2.1
+        version: '0.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
-    - - ">="
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: sleeping_king_studios-tools
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.2.1
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
@@ -119,18 +141,6 @@ files:
 - LICENSE
 - README.md
 - lib/sleeping_king_studios/docs.rb
-- lib/sleeping_king_studios/docs/commands.rb
-- lib/sleeping_king_studios/docs/commands/generate.rb
-- lib/sleeping_king_studios/docs/commands/generators.rb
-- lib/sleeping_king_studios/docs/commands/generators/base.rb
-- lib/sleeping_king_studios/docs/commands/generators/data_generator.rb
-- lib/sleeping_king_studios/docs/commands/generators/reference_generator.rb
-- lib/sleeping_king_studios/docs/commands/installation.rb
-- lib/sleeping_king_studios/docs/commands/installation/install_jekyll.rb
-- lib/sleeping_king_studios/docs/commands/installation/install_templates.rb
-- lib/sleeping_king_studios/docs/commands/installation/install_workflow.rb
-- lib/sleeping_king_studios/docs/commands/parse.rb
-- lib/sleeping_king_studios/docs/commands/write_file.rb
 - lib/sleeping_king_studios/docs/data.rb
 - lib/sleeping_king_studios/docs/data/base.rb
 - lib/sleeping_king_studios/docs/data/class_object.rb
@@ -163,77 +173,35 @@ files:
 - lib/sleeping_king_studios/docs/errors/file_not_found.rb
 - lib/sleeping_king_studios/docs/errors/invalid_directory.rb
 - lib/sleeping_king_studios/docs/errors/invalid_file.rb
+- lib/sleeping_king_studios/docs/errors/outdated_documentation.rb
+- lib/sleeping_king_studios/docs/errors/registry_error.rb
 - lib/sleeping_king_studios/docs/jekyll.rb
+- lib/sleeping_king_studios/docs/jekyll/commands.rb
+- lib/sleeping_king_studios/docs/jekyll/commands/backfill_versions.rb
+- lib/sleeping_king_studios/docs/jekyll/commands/check.rb
+- lib/sleeping_king_studios/docs/jekyll/commands/clobber.rb
+- lib/sleeping_king_studios/docs/jekyll/commands/document_version.rb
+- lib/sleeping_king_studios/docs/jekyll/commands/generate.rb
+- lib/sleeping_king_studios/docs/jekyll/commands/install.rb
+- lib/sleeping_king_studios/docs/jekyll/commands/install_templates.rb
+- lib/sleeping_king_studios/docs/jekyll/commands/install_workflow.rb
+- lib/sleeping_king_studios/docs/jekyll/commands/reference.rb
+- lib/sleeping_king_studios/docs/jekyll/commands/update.rb
+- lib/sleeping_king_studios/docs/jekyll/generators.rb
+- lib/sleeping_king_studios/docs/jekyll/generators/data_generator.rb
+- lib/sleeping_king_studios/docs/jekyll/generators/reference_generator.rb
+- lib/sleeping_king_studios/docs/jekyll/generators/version_generator.rb
 - lib/sleeping_king_studios/docs/jekyll/plugins.rb
 - lib/sleeping_king_studios/docs/jekyll/plugins/liquid.rb
 - lib/sleeping_king_studios/docs/jekyll/plugins/liquid/filters.rb
 - lib/sleeping_king_studios/docs/jekyll/plugins/liquid/filters/anchorize_slug.rb
 - lib/sleeping_king_studios/docs/jekyll/plugins/required.rb
-- lib/sleeping_king_studios/docs/registry.rb
-- lib/sleeping_king_studios/docs/registry_query.rb
-- lib/sleeping_king_studios/docs/tasks.rb
-- lib/sleeping_king_studios/docs/tasks/base.rb
-- lib/sleeping_king_studios/docs/tasks/generate.rb
-- lib/sleeping_king_studios/docs/tasks/installation.rb
-- lib/sleeping_king_studios/docs/tasks/installation/install_jekyll.rb
-- lib/sleeping_king_studios/docs/tasks/installation/install_templates.rb
-- lib/sleeping_king_studios/docs/tasks/installation/install_workflow.rb
-- lib/sleeping_king_studios/docs/tasks/update.rb
-- lib/sleeping_king_studios/docs/templates/config.yml.erb
-- lib/sleeping_king_studios/docs/templates/deploy-pages.yml.erb
-- lib/sleeping_king_studios/docs/templates/includes/breadcrumbs.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/attribute.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/attributes/heading.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/class.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/constant.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/constants/heading.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/constants/inherited.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/constants/overview.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/definitions/breadcrumbs.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/definitions/class_attributes.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/definitions/class_methods.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/definitions/constants.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/definitions/constructor.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/definitions/definitions.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/definitions/details.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/definitions/instance_attributes.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/definitions/instance_methods.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/definitions/overview.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/definitions/subclasses.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/definitions/table-of-contents.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/definitions/table-of-contents/class_attributes.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/definitions/table-of-contents/class_methods.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/definitions/table-of-contents/constants.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/definitions/table-of-contents/instance_attributes.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/definitions/table-of-contents/instance_methods.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/definitions/table-of-contents/overview.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/method.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/methods/aliases.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/methods/heading.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/methods/inherited.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/methods/overload.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/methods/overloads.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/methods/overview.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/methods/parameters.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/methods/post_overview.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/methods/raises.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/methods/return_types.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/methods/returns.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/methods/yields.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/module.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/namespace.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/parent_link.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/reference_link.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/see_link.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/type.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/type_list.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/types/array_type.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/types/hash_type.md
-- lib/sleeping_king_studios/docs/templates/includes/reference/types/ordered_type.md
-- lib/sleeping_king_studios/docs/templates/pages/index.md.erb
-- lib/sleeping_king_studios/docs/templates/pages/reference.md.erb
-- lib/sleeping_king_studios/docs/templates/pages/versions.md.erb
 - lib/sleeping_king_studios/docs/version.rb
+- lib/sleeping_king_studios/docs/yard.rb
+- lib/sleeping_king_studios/docs/yard/build.rb
+- lib/sleeping_king_studios/docs/yard/parse.rb
+- lib/sleeping_king_studios/docs/yard/registry.rb
+- lib/sleeping_king_studios/docs/yard/registry_query.rb
 homepage: http://sleepingkingstudios.com
 licenses:
 - MIT
@@ -258,7 +226,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.2
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Tools for generating a versioned documentation site from YARD docs.
 test_files: []

data/lib/sleeping_king_studios/docs/commands/generate.rb

@@ -1,268 +0,0 @@
-# frozen_string_literal: true
-
-require 'cuprum/command'
-require 'sleeping_king_studios/tools/toolbelt'
-
-require 'sleeping_king_studios/docs/commands'
-
-module SleepingKingStudios::Docs::Commands
-  # Generates YARD documentation files.
-  class Generate < SleepingKingStudios::Docs::Commands::Generators::Base # rubocop:disable Metrics/ClassLength
-    # @overload initialize(docs_path:, **options)
-    #   @param docs_path [String] the directory path for generating the
-    #     documentation files.
-    #   @param options [Hash] the configured options for the generator.
-    #
-    #   @option options dry_run [Boolean] if true, does not make any changes to
-    #     the filesystem.
-    #   @option options force [Boolean] if true, overwrites any existing files.
-    #   @option options version [String] the code version for the generated
-    #     documentation.
-    #   @option options verbose [Boolean] if true, prints status messages to
-    #     STDOUT.
-    def initialize(
-      docs_path:,
-      error_stream:  $stderr,
-      output_stream: $stdout,
-      **options
-    )
-      super(docs_path:, **options)
-
-      @error_stream  = error_stream
-      @output_stream = output_stream
-    end
-
-    private
-
-    attr_reader :failures
-
-    def build_constant(native:)
-      SleepingKingStudios::Docs::Data::ConstantObject.new(native:)
-    end
-
-    def build_class(native:)
-      SleepingKingStudios::Docs::Data::ClassObject.new(native:)
-    end
-
-    def build_method(native:)
-      SleepingKingStudios::Docs::Data::MethodObject.new(native:)
-    end
-
-    def build_module(native:)
-      SleepingKingStudios::Docs::Data::ModuleObject.new(native:)
-    end
-
-    def build_root_namespace(native:)
-      SleepingKingStudios::Docs::Data::RootObject.new(native:)
-    end
-
-    def data_command
-      @data_command ||=
-        SleepingKingStudios::Docs::Commands::Generators::DataGenerator
-        .new(docs_path:, **options)
-    end
-
-    def generate_classes
-      puts "\nGenerating Classes:" if verbose? && !registry_classes.empty?
-
-      registry_classes.each do |native|
-        data_object = build_class(native:)
-
-        puts "- #{data_object.name}" if verbose?
-
-        generate_data_file(data_object:)
-        generate_reference_file(data_object:)
-      end
-    end
-
-    def generate_constants
-      puts "\nGenerating Constants:" if verbose? && !registry_constants.empty?
-
-      registry_constants.each do |native|
-        data_object = build_constant(native:)
-
-        puts "- #{data_object.name}" if verbose?
-
-        generate_data_file(data_object:)
-      end
-    end
-
-    def generate_data_file(data_object:, **options)
-      report_result(
-        command:     data_command,
-        data_object:,
-        result:      data_command.call(data_object:, **options),
-        **options
-      )
-    end
-
-    def generate_methods
-      puts "\nGenerating Methods:" if verbose? && !registry_methods.empty?
-
-      registry_methods.each do |native|
-        data_object = build_method(native:)
-
-        puts "- #{data_object.name}" if verbose?
-
-        generate_data_file(data_object:)
-      end
-    end
-
-    def generate_modules
-      puts "\nGenerating Modules:" if verbose? && !registry_modules.empty?
-
-      registry_modules.each do |native|
-        data_object = build_module(native:)
-
-        puts "- #{data_object.name}" if verbose?
-
-        generate_data_file(data_object:)
-        generate_reference_file(data_object:)
-      end
-    end
-
-    def generate_reference_file(data_object:, **options)
-      report_result(
-        command:     reference_command,
-        data_object:,
-        result:      reference_command.call(
-          data_object:,
-          **options
-        ),
-        **options
-      )
-    end
-
-    def generate_root_namespace
-      puts 'Generating Root Namespace:' if verbose?
-
-      data_object = build_root_namespace(native: registry_root)
-
-      puts '- root namespace' if verbose?
-
-      generate_data_file(data_object:, data_type: :namespace)
-    end
-
-    def parse_registry(file_path:)
-      SleepingKingStudios::Docs::Commands::Parse.new.call(file_path)
-    end
-
-    def process(file_path: nil)
-      step { parse_registry(file_path:) }
-
-      @failures = []
-
-      generate_root_namespace
-      generate_classes
-      generate_constants
-      generate_methods
-      generate_modules
-
-      report_all_failures
-
-      nil
-    end
-
-    def puts(string)
-      output_stream.puts(string)
-    end
-
-    def reference_command
-      @reference_command ||=
-        SleepingKingStudios::Docs::Commands::Generators::ReferenceGenerator
-        .new(docs_path:, **options)
-    end
-
-    def registry
-      SleepingKingStudios::Docs::Registry.instance
-    end
-
-    def registry_classes
-      registry
-        .select { |obj| obj.type == :class }
-        .reject { |obj| obj.tags.any? { |tag| tag.tag_name == 'private' } }
-        .sort_by(&:path)
-    end
-
-    def registry_constants
-      registry
-        .select { |obj| obj.type == :constant && obj.visibility == :public }
-        .reject { |obj| obj.tags.any? { |tag| tag.tag_name == 'private' } }
-        .sort_by(&:path)
-    end
-
-    def registry_methods
-      registry
-        .select { |obj| obj.type == :method && obj.visibility == :public }
-        .reject { |obj| obj.tags.any? { |tag| tag.tag_name == 'private' } }
-        .reject(&:is_alias?)
-        .sort_by(&:path)
-    end
-
-    def registry_modules
-      registry
-        .select { |obj| obj.type == :module }
-        .reject { |obj| obj.tags.any? { |tag| tag.tag_name == 'private' } }
-        .sort_by(&:path)
-    end
-
-    def registry_root
-      registry
-        .find { |obj| obj.type == :root }
-    end
-
-    def report_all_failures
-      return if failures.empty?
-      return unless verbose?
-
-      warn "\nFailures:"
-
-      failures.each do |failure|
-        report_failure(**failure, nested: true)
-      end
-    end
-
-    def report_failure(file_path:, result:, nested: false)
-      message = nested ? '  - ' : ''
-      message +=
-        "FAILURE: unable to write file to #{file_path} - " \
-        "#{result.error.class}: #{result.error.message}"
-
-      warn message
-    end
-
-    def report_result(command:, data_object:, result:, data_type: nil) # rubocop:disable Metrics/MethodLength
-      data_type ||= data_object_type(data_object:)
-      file_path   = command.file_path(
-        data_object:,
-        data_type:
-      )
-
-      if result.success?
-        report_success(file_path:)
-      else
-        failures << { file_path:, result: }
-
-        report_failure(file_path:, result:, nested: verbose?)
-      end
-
-      result
-    end
-
-    def report_success(file_path:)
-      return unless verbose?
-
-      message = "  - SUCCESS: file written to #{file_path}"
-
-      puts message
-    end
-
-    def tools
-      SleepingKingStudios::Tools::Toolbelt.instance
-    end
-
-    def warn(string)
-      error_stream.puts(string)
-    end
-  end
-end

data/lib/sleeping_king_studios/docs/commands/generators/base.rb

@@ -1,97 +0,0 @@
-# frozen_string_literal: true
-
-require 'cuprum/command'
-require 'cuprum/exception_handling'
-require 'sleeping_king_studios/tools/toolbelt'
-
-require 'sleeping_king_studios/docs/commands/generators'
-
-module SleepingKingStudios::Docs::Commands::Generators
-  # Abstract base class for writing generator classes.
-  class Base < Cuprum::Command
-    include Cuprum::ExceptionHandling
-
-    # @param docs_path [String] the directory path for generating the
-    #   documentation files.
-    # @param options [Hash] the configured options for the generator.
-    #
-    # @option options dry_run [Boolean] if true, does not make any changes to
-    #   the filesystem.
-    # @option options force [Boolean] if true, overwrites any existing files.
-    # @option options version [String] the code version for the generated
-    #   documentation.
-    # @option options verbose [Boolean] if true, prints status messages to
-    #   STDOUT.
-    def initialize(docs_path:, **options)
-      super()
-
-      @docs_path = docs_path
-      @options   = default_options.merge(options)
-    end
-
-    # @return [String] the directory path for generating the documentation
-    #   files.
-    attr_reader :docs_path
-
-    # @return [Hash] the configured options for the generator.
-    attr_reader :options
-
-    # @return [Boolean] if true, does not make any changes to the filesystem.
-    def dry_run?
-      @options[:dry_run]
-    end
-
-    # @return [Boolean] if true, overwrites any existing files.
-    def force?
-      @options[:force]
-    end
-
-    # @return [String] the relative path to the Jekyll templates for each data
-    #   type.
-    def template_path
-      @options.fetch(:template_path, 'reference')
-    end
-
-    # @return [Boolean] if true, prints status messages to STDOUT.
-    def verbose?
-      @options[:verbose]
-    end
-
-    # @return [String] the code version for the generated documentation.
-    def version
-      @options[:version]
-    end
-
-    private
-
-    attr_reader :error_stream
-
-    attr_reader :output_stream
-
-    def data_object_type(data_object:)
-      data_object
-        .class
-        .name
-        .split('::')
-        .last
-        .then { |str| str[0...-6] }
-        .then { |str| tools.string_tools.underscore(str) }
-    end
-
-    def default_options
-      {
-        dry_run: false,
-        force:   false,
-        verbose: false
-      }
-    end
-
-    def tools
-      SleepingKingStudios::Tools::Toolbelt.instance
-    end
-
-    def version_string
-      version || '*'
-    end
-  end
-end

data/lib/sleeping_king_studios/docs/commands/generators/data_generator.rb

@@ -1,68 +0,0 @@
-# frozen_string_literal: true
-
-require 'yaml'
-
-require 'sleeping_king_studios/tools/toolbelt'
-
-require 'sleeping_king_studios/docs/commands/generators'
-
-module SleepingKingStudios::Docs::Commands::Generators
-  # Generator for writing data files.
-  class DataGenerator < SleepingKingStudios::Docs::Commands::Generators::Base
-    # Determines the generated file path for the given data object.
-    #
-    # @param data_object [SleepingKingStudios::Docs::Data::Base] the data object
-    #   for which the file is generated.
-    # @param data_type [String, Symbol] the type of data file to generate.
-    #
-    # @return [String] the qualified path to the generated file.
-    def file_path(data_object:, data_type: nil)
-      data_type ||= data_object_type(data_object:)
-
-      File.join(dir_path(data_type), "#{data_object.data_path}.yml")
-    end
-
-    private
-
-    def dir_path(data_type)
-      scope = "_#{tools.string_tools.pluralize(data_type.to_s)}"
-
-      if version
-        File.join(docs_path, scope, "version--#{version}")
-      else
-        File.join(docs_path, scope)
-      end
-    end
-
-    def file_data(data_object:)
-      data_object
-        .as_json
-        .merge('version' => version_string)
-    end
-
-    def process(data_object:, data_type: nil)
-      data        = file_data(data_object:)
-      data_type ||= data_object_type(data_object:)
-
-      return success(nil) if dry_run?
-
-      write_command.call(
-        contents:  YAML.dump(data),
-        file_path: file_path(
-          data_object:,
-          data_type:
-        )
-      )
-    end
-
-    def tools
-      SleepingKingStudios::Tools::Toolbelt.instance
-    end
-
-    def write_command
-      @write_command ||=
-        SleepingKingStudios::Docs::Commands::WriteFile
-        .new(force: force?)
-    end
-  end
-end