brutal 1.6.0.beta1 → 1.6.0.beta2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 37fdb51264d859c50519c1bfc0f511542eb8bcca0817049e11191977d06cb7b1
-  data.tar.gz: 54e26e7e3ad8cc403fdb6c1db116186c61d06b0766eb8fa5e96ed7688913872b
+  metadata.gz: 2a8a912485598e917360c280db92eee2b3acc53180dd0587b2147ea0eb26e649
+  data.tar.gz: 5a7a1f13b748e8deb7d5a1529ca2e11eb35b687aabab84f7b9fc9ebc58d0b174
 SHA512:
-  metadata.gz: d42f48f5e24be39950a9e5a1bfb521a84a37402b8cb3cca1eb680767ce63410ab44b836310ba7792af80a8d9c9f803ba30c9e08dff4f1094fde184409f81c95c
-  data.tar.gz: 40a6cf45ccdc12816d677fd5c8d19ed4c6305ec135c66fc2e56bd11f595291d9c16715b979ff920b1ed36cc90bddfe783db3653fb7f072cbc77ef8a0d760c769
+  metadata.gz: ec1ffa0f11a17812ff0000bc7e8b4ba8a04c826e37f9ef5e777681312fcb87962020f034b4802b617471894019f9c046598a012eeb6491c6548f0fef233af66d
+  data.tar.gz: 363647b4219053d2433fa198aac832b8f8f630e36d7b9282f0c36c34c2a255e5874ee91e481440be6bea2c87bb7763225ddbd04bfbf0204ad949bea98b5fbb01

data/README.md

@@ -38,7 +38,7 @@ It is therefore the responsibility of the developer to analyze the generated beh
 Add this line to your application's Gemfile:
 
 ```ruby
-gem "brutal", ">= 1.6.0.beta1", require: false
+gem "brutal", ">= 1.6.0.beta2", require: false
 ```
 
 And then execute:
@@ -53,7 +53,22 @@ Or install it yourself as:
 gem install brutal --pre
 ```
 
-## Command line
+## Usage
+
+### YAML manifest
+
+__Brutal__ needs configuration files in YAML format to know how to write tests.
+Configuration file names are suffixed by `_brutal.yaml` and composed of 7 top-level sections:
+
+* `header` - Specifies a block of lines to be executed once before all examples.
+* `before` - Specifies a block of lines to be executed before each example.
+* `subject` - Specifies the template of the code to be declined across contexts.
+* `contexts` - Specifies a list of variables to populate the subject's template.
+* `actuals` - Specifies templates to challenge evaluated subjects & get results.
+* `after` - Specifies a block of lines to be executed after each example.
+* `footer` - Specifies a block of lines to be executed once after all examples.
+
+### Command line
 
 The `brutal` command comes with several options you can use to customize Brutal's behavior.
 
@@ -64,25 +79,13 @@ brutal --help
 ```
 
 ```txt
-Usage: #{$PROGRAM_NAME} [options] [files or directories]
+Usage: brutal [options] [files or directories]
 
     --format=FORMAT Choose "ruby" (default).
     --help          Display this help.
     --version       Display the version.
 ```
 
-## Usage
-
-__Brutal__ needs configuration files in YAML format to know how to write tests.
-Configuration file names are suffixed by `_brutal.yaml` and composed of 4 top-level sections:
-
-* `header` - Specifies the code to execute before generating the test suite.
-* `subject` - Specifies the template of the code to be declined across contexts.
-* `contexts` - Specifies a list of variables to populate the subject's template.
-* `actuals` - Specifies templates to challenge evaluated subjects & get results.
-
-When the configuration file is present, the generation of a test suite can be done with the command:
-
 Assuming that in the workspace there is a configuration file named `user_brutal.yaml`, the test suite can be generated via one of these commands:
 
 ```sh
@@ -101,17 +104,19 @@ or even:
 brutal
 ```
 
-This would create a `user_brutal.rb` file containing the test suite.
+This would create a `test_user.rb` file containing the test suite.
 
 Assuming now that in the workspace there are a large number of configuration files named in the `spec/` folder, the complete test suite could be generated recursively via this command:
 
 ```sh
-brutal spec/ # => generate tests from each configuration file matching ./spec/**/*_brutal.yaml in to ./spec/**/*_brutal.rb
+brutal spec/
 ```
 
+This would create one test file per configuration file matching `./spec/**/*_brutal.yaml` in to `./spec/**/test_*.rb`.
+
 ### Some examples
 
-<https://github.com/fixrb/brutal/blob/v1.6.0.beta1/examples/>
+<https://github.com/fixrb/brutal/tree/main/examples/>
 
 ## Rake integration example
 
@@ -119,7 +124,7 @@ Generated test suite files could be matched as follows:
 
 ```ruby
 Rake::TestTask.new do |t|
-  t.pattern = "**/*_brutal.rb"
+  t.pattern = "**/test_*.rb"
 end
 ```
 

data/bin/brutal

@@ -2,13 +2,17 @@
 # frozen_string_literal: true
 
 require_relative File.join("..", "lib", "brutal", "command_line_arguments_parser")
-format, pathnames = Brutal::CommandLineArgumentsParser.new(*ARGV).call
+
+formats, pathnames = Brutal::CommandLineArgumentsParser.new(*ARGV).call
 
 require_relative File.join("..", "lib", "brutal")
-generator = Brutal.new(format: format)
 
-pathnames.each do |pathname|
-  Dir.chdir(pathname.dirname) do
-    generator.call(pathname.basename)
+formats.each do |format|
+  generator = Brutal.new(format)
+
+  pathnames.each do |pathname|
+    Dir.chdir(pathname.dirname) do
+      generator.call(pathname.basename)
+    end
   end
 end

data/lib/brutal/command_line_arguments_parser.rb

@@ -1,64 +1,68 @@
 # frozen_string_literal: true
 
+require_relative File.join("manifest", "file", "name")
+
 require "pathname"
 
 class Brutal
   # Accept an arbitrary number of arguments passed from the command-line.
   class CommandLineArgumentsParser
-    DEFAULT_FORMAT = "ruby"
-    FILE_SUFFIX = "_brutal.yaml"
-    FILE_PATTERN = ::File.join("**", "*#{FILE_SUFFIX}")
-    CURRENT_EXECUTION_CONTEXT = "."
+    MANIFEST_FILENAME_SUFFIX  = Manifest::File::Name::SUFFIX
+    MANIFEST_FILENAME_PATTERN = ::File.join("**", "*#{MANIFEST_FILENAME_SUFFIX}")
+    CURRENT_DIRECTORY_CONTEXT = "."
+    GEM_NAME                  = "brutal"
+    HELP_OPTION               = "--help"
+    VERSION_OPTION            = "--version"
+    RUBY_FORMAT_OPTION        = "--format=ruby"
+    DEFAULT_FORMAT_OPTION     = RUBY_FORMAT_OPTION
+
+    FORMAT_OPTIONS = {
+      RUBY_FORMAT_OPTION => :Ruby
+    }.freeze
+
+    DEFAULT_FORMAT  = FORMAT_OPTIONS.fetch(DEFAULT_FORMAT_OPTION)
+    DEFAULT_FORMATS = [DEFAULT_FORMAT].freeze
 
     attr_reader :pathnames
 
     def initialize(*args)
-      @any_path = false
+      args.each do |arg|
+        help!     if arg == HELP_OPTION
+        version!  if arg == VERSION_OPTION
+      end
+
+      @formats   = []
       @pathnames = []
+
+      args << CURRENT_DIRECTORY_CONTEXT unless any_path_given?(*args)
       args.each { |arg| parse!(arg) }
-      parse!(CURRENT_EXECUTION_CONTEXT) unless any_path?
     end
 
     def call
-      [format, pathnames]
+      [formats, pathnames]
     end
 
     private
 
-    def any_path?
-      @any_path
-    end
-
-    def format
-      @format || DEFAULT_FORMAT
+    def formats
+      @formats.empty? ? DEFAULT_FORMATS : @formats
     end
 
     def parse!(arg)
       case arg
-      when "--format=ruby"
-        format!("Ruby")
-      when "--help"
-        help!
-      when "--version"
-        version!
+      when RUBY_FORMAT_OPTION
+        @formats << FORMAT_OPTIONS.fetch(RUBY_FORMAT_OPTION)
       else
-        pathname = ::Pathname.new(arg)
-        load!(pathname)
+        load!(::Pathname.new(arg))
       end
     end
 
-    def format!(name)
-      raise ::ArgumentError, "Format already filled in." unless format.nil?
-
-      @format = name
-    end
-
     def help!
-      puts help_command_output
+      puts help_message
       exit
     end
 
-    def help_command_output
+    def help_message
       <<~TXT
         Usage: #{$PROGRAM_NAME} [options] [files or directories]
 
@@ -69,21 +73,31 @@ class Brutal
     end
 
     def load!(pathname)
-      @any_path = true
-
       if pathname.directory?
-        pathname.glob(FILE_PATTERN).each { |filename| load!(filename) }
+        pathname.glob(MANIFEST_FILENAME_PATTERN).each { |filename| load!(filename) }
       elsif pathname.file?
-        if pathname.to_s.end_with?(FILE_SUFFIX)
-          @pathnames << pathname
-        else
-          warn "Skipping #{pathname} because not suffixed with #{FILE_SUFFIX}."
-        end
+        load_file!(pathname)
       else
         raise ::ArgumentError, "#{pathname} is neither a file nor a directory."
       end
     end
 
+    def load_file!(pathname)
+      if pathname.fnmatch?(MANIFEST_FILENAME_PATTERN)
+        @pathnames << pathname
+      else
+        warn "Skipping #{pathname} because not matched against #{MANIFEST_FILENAME_PATTERN}."
+      end
+    end
+
+    def any_path_given?(*args)
+      path_args(*args).any?
+    end
+
+    def path_args(*args)
+      args - FORMAT_OPTIONS.keys
+    end
+
     def version!
       abort "Gem not found on the system.  Unknown version." if not_loaded_spec?
 
@@ -92,7 +106,7 @@ class Brutal
     end
 
     def loaded_spec
-      ::Gem.loaded_specs["brutal"]
+      ::Gem.loaded_specs[GEM_NAME]
     end
 
     def not_loaded_spec?

data/lib/brutal/format/ruby/filename.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+class Brutal
+  module Format
+    class Ruby
+      module Filename
+        # Brutal Ruby format file prefix.
+        PREFIX = "test_"
+
+        # Brutal Ruby format file suffix.
+        SUFFIX = ".rb"
+      end
+    end
+  end
+end

data/lib/brutal/format/ruby.rb

@@ -1,33 +1,59 @@
 # frozen_string_literal: true
 
+require_relative File.join("ruby", "filename")
+
 class Brutal
   module Format
     # Ruby format class
     class Ruby
+      # Whitespace character.
+      SPACE = " "
+
+      # Hyphen-minus character.
+      HYPHEN_MINUS = "-"
+
+      # Two spaces per indentation level.
+      INDENTATION = SPACE * 2
+
       # Specifies templates to challenge evaluated subjects & get results.
       attr_reader :actuals
 
       # Specifies a list of variables to populate the subject's template.
       attr_reader :contexts
 
-      # Specifies the code to execute before generating the test suite.
+      # Specifies a block of lines to be executed once before all examples.
       attr_reader :header
 
+      # Specifies a block of lines to be executed before each example.
+      attr_reader :before
+
       # Specifies the template of the code to be declined across contexts.
       attr_reader :subject
 
+      # Specifies a block of lines to be executed after each example.
+      attr_reader :after
+
+      # Specifies a block of lines to be executed once after all examples.
+      attr_reader :footer
+
       # Initialize a new scaffold generator.
-      def initialize(header, subject, *actuals, **contexts)
-        warn("Empty subject!")        if subject.empty?
-        warn("Empty actual values!")  if actuals.empty?
-        warn("Empty contexts!")       if contexts.empty?
+      def initialize(header, before, subject, after, footer, *actuals, **contexts)
+        header = "# Brutal test suite"      if header.empty?
+        before = "# Starting an example"    if before.empty?
+        after  = "# Finishing an example"   if after.empty?
+        footer = "# End of the brutal test" if footer.empty?
 
-        eval(header) # rubocop:disable Security/Eval
+        warn("Empty subject!")              if subject.empty?
+        warn("Empty actual values!")        if actuals.empty?
+        warn("Empty contexts!")             if contexts.empty?
 
         @header   = header
+        @before   = before
         @subject  = subject
         @actuals  = actuals
         @contexts = contexts
+        @after    = after
+        @footer   = footer
       end
 
       # Return a Ruby string that can be evaluated.
@@ -41,7 +67,11 @@ class Brutal
       #
       # @return [String]
       def to_s
-        ruby_lines.join(separator_ruby_code)
+        eval(header) # rubocop:disable Security/Eval
+
+        ruby_lines.compact.join(separator_code)
+      ensure
+        eval(footer) # rubocop:disable Security/Eval
       end
 
       def attributes(*values)
@@ -63,13 +93,13 @@ class Brutal
       end
 
       def ruby_lines
-        [header_ruby_code] + actual_ruby_codes
+        [header_code] + actual_codes + [footer_code]
       end
 
-      def actual_ruby_codes
+      def actual_codes
         combinations_values.map do |values|
           actual_str = format(inspect(subject), **attributes(*values))
-          string = actual_ruby_code(actual_str)
+          string = actual_code(actual_str)
           actual = eval(actual_str) # rubocop:disable Security/Eval, Lint/UselessAssignment
 
           actuals.each do |actual_value|
@@ -81,32 +111,52 @@ class Brutal
         end
       end
 
-      def actual_ruby_code(actual_str)
-        <<~RUBY_CODE
+      def actual_code(actual_str)
+        <<~CODE
+          #{before_code}
           actual = begin
-          #{actual_str.gsub(/^/, '  ')}
+          #{actual_str.gsub(/^/, INDENTATION)}
           end
 
-        RUBY_CODE
+          #{after_code}
+        CODE
       end
 
-      def header_ruby_code
-        <<~RUBY_CODE
+      def header_code
+        <<~CODE
           #{header.chomp}
-        RUBY_CODE
+        CODE
+      end
+
+      def before_code
+        <<~CODE
+          #{before.chomp}
+        CODE
+      end
+
+      def after_code
+        <<~CODE
+          #{after.chomp}
+        CODE
+      end
+
+      def footer_code
+        <<~CODE
+          #{footer.chomp}
+        CODE
       end
 
-      def separator_ruby_code
-        <<~RUBY_CODE
+      def separator_code
+        <<~CODE
 
-          #{thematic_break_ruby_code}
-        RUBY_CODE
+          #{thematic_break_code}
+        CODE
       end
 
-      def thematic_break_ruby_code
-        <<~RUBY_CODE
-          # #{'-' * 78}
-        RUBY_CODE
+      def thematic_break_code
+        <<~CODE
+          # #{HYPHEN_MINUS * 78}
+        CODE
       end
     end
   end

data/lib/brutal/format.rb

@@ -1,16 +1,11 @@
 # frozen_string_literal: true
 
-%w[
-  ruby
-].each { |filename| require_relative(File.join("format", filename)) }
+Dir[File.join(File.dirname(__FILE__), "format", "*.rb")].sort.each do |fname|
+  require_relative fname
+end
 
 class Brutal
-  # Brutal::Format
+  # A collection of formatter classes.
   module Format
-    SUPPORT = {
-      "ruby" => Ruby
-    }.freeze
-
-    DEFAULT = SUPPORT.keys.sort.fetch(-1)
   end
 end

data/lib/brutal/manifest/file/name.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+class Brutal
+  class Manifest
+    class File
+      module Name
+        # Suffix for configuration file names.
+        SUFFIX = "_brutal.yaml"
+
+        # Suffix pattern for configuration file names.
+        SUFFIX_PATTERN = "*#{SUFFIX}"
+
+        # Suffix regex for configuration file names.
+        SUFFIX_REGEX = /#{SUFFIX}\z/.freeze
+      end
+    end
+  end
+end

data/lib/brutal/manifest/file.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative File.join("file", "name")
+
+require "yaml"
+
+class Brutal
+  class Manifest
+    # YAML manifest file parser.
+    class File
+      attr_reader :yaml
+
+      def initialize(pathname)
+        raise ::ArgumentError unless pathname.fnmatch?(Name::SUFFIX_PATTERN)
+
+        @yaml = pathname.read
+      end
+
+      def parse
+        ::YAML.safe_load(yaml, symbolize_names: false)
+      end
+    end
+  end
+end

data/lib/brutal/manifest.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+require_relative File.join("manifest", "file")
+
+class Brutal
+  # Brutal YAML manifest file parser.
+  class Manifest
+    # The _actuals_ top-level section key.
+    ACTUALS_KEY = "actuals"
+
+    # The _contexts_ top-level section key.
+    CONTEXTS_KEY = "contexts"
+
+    # The _header_ top-level section key.
+    HEADER_KEY = "header"
+
+    # The _before_ top-level section key.
+    BEFORE_KEY = "before"
+
+    # The _subject_ top-level section key.
+    SUBJECT_KEY = "subject"
+
+    # The _after_ top-level section key.
+    AFTER_KEY = "after"
+
+    # The _footer_ top-level section key.
+    FOOTER_KEY = "footer"
+
+    # Default _actuals_ collection.
+    DEFAULT_ACTUALS = [].freeze
+
+    # Default _contexts_ collection.
+    DEFAULT_CONTEXTS = {}.freeze
+
+    # Default _header_ code to evaluate.
+    DEFAULT_HEADER = ""
+
+    # Default _before_ code to evaluate.
+    DEFAULT_BEFORE = ""
+
+    # Default _after_ code to evaluate.
+    DEFAULT_AFTER = ""
+
+    # Default _footer_ code to evaluate.
+    DEFAULT_FOOTER = ""
+
+    # Parse a file at `pathname`.  Returns the YAML manifest instance.
+    def self.parse_file(pathname)
+      load(File.new(pathname).parse)
+    end
+
+    # Load the configuration parameters.
+    #
+    # @param params [Hash] Receive the 7 top-level section parameters.
+    def self.load(params)
+      new(
+        actuals:  params.fetch(ACTUALS_KEY, DEFAULT_ACTUALS),
+        contexts: params.fetch(CONTEXTS_KEY, DEFAULT_CONTEXTS),
+        header:   params.fetch(HEADER_KEY, DEFAULT_HEADER),
+        before:   params.fetch(BEFORE_KEY, DEFAULT_BEFORE),
+        subject:  params.fetch(SUBJECT_KEY),
+        after:    params.fetch(AFTER_KEY, DEFAULT_AFTER),
+        footer:   params.fetch(FOOTER_KEY, DEFAULT_FOOTER)
+      )
+    end
+
+    # Specifies templates to challenge evaluated subjects & get results.
+    attr_reader :actuals
+
+    # Specifies a list of variables to populate the subject's template.
+    attr_reader :contexts
+
+    # Specifies a block of lines to be executed once before all examples.
+    attr_reader :header
+
+    # Specifies a block of lines to be executed before each example.
+    attr_reader :before
+
+    # Specifies the template of the code to be declined across contexts.
+    attr_reader :subject
+
+    # Specifies a block of lines to be executed after each example.
+    attr_reader :after
+
+    # Specifies a block of lines to be executed once after all examples.
+    attr_reader :footer
+
+    # Initialize a new configuration.
+    def initialize(actuals:, contexts:, header:, before:, subject:, after:, footer:)
+      raise ::TypeError, actuals.inspect  unless actuals.is_a?(::Array)
+      raise ::TypeError, contexts.inspect unless contexts.is_a?(::Hash)
+      raise ::TypeError, header.inspect   unless header.is_a?(::String)
+      raise ::TypeError, before.inspect   unless before.is_a?(::String)
+      raise ::TypeError, subject.inspect  unless subject.is_a?(::String)
+      raise ::TypeError, after.inspect    unless after.is_a?(::String)
+      raise ::TypeError, footer.inspect   unless footer.is_a?(::String)
+
+      @actuals  = actuals
+      @contexts = contexts
+      @header   = header
+      @before   = before
+      @subject  = subject
+      @after    = after
+      @footer   = footer
+    end
+  end
+end

data/lib/brutal.rb

@@ -1,50 +1,40 @@
 # frozen_string_literal: true
 
 %w[
-  configuration
-  file
   format
-  yaml
+  manifest
 ].each { |filename| require_relative(File.join("brutal", filename)) }
 
 # The Brutal namespace.
 class Brutal
-  attr_reader :format
+  attr_reader :engine
 
-  def initialize(format: Format::DEFAULT)
-    @format = String(format)
+  def initialize(format)
+    @engine = Format.const_get(format)
   end
 
   def call(pathname)
-    hash = parse(pathname)
-    conf = Configuration.load(hash)
-    code = scaffold(conf)
-    write(pathname, code)
-  end
-
-  def scaffold(conf)
-    engine = Format::SUPPORT.fetch(format) do
-      raise ::NotImplementedError, "#{format.inspect} format is not supported."
-    end
-
-    engine.new(conf.header, conf.subject, *conf.actuals, **conf.contexts)
+    manifest = Manifest.parse_file(pathname)
+    scaffold = brutalizer(manifest)
+    pathname = new_pathname(pathname)
+    pathname.write(scaffold)
   end
 
   private
 
-  def parse(pathname)
-    return Yaml.parse(read(pathname)) if Yaml.parse?(pathname)
+  def brutalizer(conf)
+    engine.new(conf.header, conf.before, conf.subject, conf.after, conf.footer, *conf.actuals, **conf.contexts)
+  end
 
-    raise ::ArgumentError, "Unrecognized extension.  " \
-                           "Impossible to parse #{pathname.inspect}."
+  def new_pathname(pathname)
+    pathname.dirname + "#{new_prefix}#{pathname.basename.sub(Manifest::File::Name::SUFFIX_REGEX, new_suffix)}"
   end
 
-  def read(pathname)
-    File::Read.new(pathname).call
+  def new_prefix
+    engine.const_get(:Filename).const_get(:PREFIX)
   end
 
-  def write(pathname, ruby)
-    new_pathname = File.generated_pathname(pathname)
-    File::Write.new(new_pathname).call(ruby)
+  def new_suffix
+    engine.const_get(:Filename).const_get(:SUFFIX)
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: brutal
 version: !ruby/object:Gem::Version
-  version: 1.6.0.beta1
+  version: 1.6.0.beta2
 platform: ruby
 authors:
 - Cyril Kato
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-09-01 00:00:00.000000000 Z
+date: 2022-09-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -108,20 +108,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: simplecov
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
@@ -148,13 +134,12 @@ files:
 - bin/brutal
 - lib/brutal.rb
 - lib/brutal/command_line_arguments_parser.rb
-- lib/brutal/configuration.rb
-- lib/brutal/file.rb
-- lib/brutal/file/read.rb
-- lib/brutal/file/write.rb
 - lib/brutal/format.rb
 - lib/brutal/format/ruby.rb
-- lib/brutal/yaml.rb
+- lib/brutal/format/ruby/filename.rb
+- lib/brutal/manifest.rb
+- lib/brutal/manifest/file.rb
+- lib/brutal/manifest/file/name.rb
 homepage: https://github.com/fixrb/brutal
 licenses:
 - MIT

data/lib/brutal/configuration.rb

@@ -1,55 +0,0 @@
-# frozen_string_literal: true
-
-class Brutal
-  # Brutal::Configuration
-  #
-  # @since 1.0.0
-  class Configuration
-    ACTUALS_KEY   = "actuals"
-    CONTEXTS_KEY  = "contexts"
-    HEADER_KEY    = "header"
-    SUBJECT_KEY   = "subject"
-
-    DEFAULT_ACTUALS   = [].freeze
-    DEFAULT_CONTEXTS  = {}.freeze
-    DEFAULT_HEADER    = "# Brutal test suite"
-    DEFAULT_SUBJECT   = ""
-
-    # Load the configuration parameters.
-    #
-    # @param params [Hash] Receive the 4 top-level section parameters.
-    def self.load(params)
-      new(
-        actuals:  params.fetch(ACTUALS_KEY, DEFAULT_ACTUALS),
-        contexts: params.fetch(CONTEXTS_KEY, DEFAULT_CONTEXTS),
-        header:   params.fetch(HEADER_KEY, DEFAULT_HEADER),
-        subject:  params.fetch(SUBJECT_KEY, DEFAULT_SUBJECT)
-      )
-    end
-
-    # Specifies templates to challenge evaluated subjects & get results.
-    attr_reader :actuals
-
-    # Specifies a list of variables to populate the subject's template.
-    attr_reader :contexts
-
-    # Specifies the code to execute before generating the test suite.
-    attr_reader :header
-
-    # Specifies the template of the code to be declined across contexts.
-    attr_reader :subject
-
-    # Initialize a new configuration.
-    def initialize(actuals:, contexts:, header:, subject:)
-      raise ::TypeError, actuals.inspect  unless actuals.is_a?(::Array)
-      raise ::TypeError, contexts.inspect unless contexts.is_a?(::Hash)
-      raise ::TypeError, header.inspect   unless header.is_a?(::String)
-      raise ::TypeError, subject.inspect  unless subject.is_a?(::String)
-
-      @actuals  = actuals.sort
-      @contexts = contexts
-      @header   = header
-      @subject  = subject
-    end
-  end
-end

data/lib/brutal/file/read.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-class Brutal
-  module File
-    # Brutal::File::Read
-    #
-    # @since 1.1.0
-    class Read
-      attr_reader :name
-
-      def initialize(name)
-        @name = name
-      end
-
-      def call
-        ::File.read(path)
-      rescue ::Errno::ENOENT => _e
-        abort "File #{path} not found!"
-      end
-
-      protected
-
-      def path
-        ::File.join(::Dir.pwd, name)
-      end
-    end
-  end
-end

data/lib/brutal/file/write.rb

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-class Brutal
-  module File
-    # Brutal::File::Write
-    #
-    # @since 1.1.0
-    class Write
-      attr_reader :name
-
-      def initialize(name)
-        @name = name
-      end
-
-      def call(scaffold)
-        file = ::File.open(path, "w")
-        file.write(scaffold)
-
-        true
-      ensure
-        file.close
-      end
-
-      protected
-
-      def path
-        ::File.join(::Dir.pwd, name)
-      end
-    end
-  end
-end

data/lib/brutal/file.rb

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-%w[
-  read
-  write
-].each { |filename| require_relative(File.join("file", filename)) }
-
-class Brutal
-  # Brutal::File
-  module File
-    RUBY_EXTENSION = ".rb"
-
-    def self.generated_pathname(pathname)
-      pathname.sub_ext(RUBY_EXTENSION)
-    end
-  end
-end

data/lib/brutal/yaml.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-require "yaml"
-
-class Brutal
-  # Brutal::Yaml
-  module Yaml
-    FILENAME_EXTENSION = ".yaml"
-
-    def self.parse(yaml)
-      ::YAML.safe_load(yaml, symbolize_names: false)
-    end
-
-    def self.parse?(pathname)
-      filename_extension = pathname.extname
-      filename_extension.eql?(FILENAME_EXTENSION)
-    end
-  end
-end