csvops 0.4.0.alpha → 0.6.0.alpha

data/test/csvtool/infrastructure/csv/csv_parity_comparator_test.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require_relative "../../../test_helper"
+require "csvtool/infrastructure/csv/csv_parity_comparator"
+
+class CsvParityComparatorTest < Minitest::Test
+  def fixture_path(name)
+    File.expand_path("../../../fixtures/#{name}", __dir__)
+  end
+
+  def test_reports_match_when_rows_are_equal_ignoring_order
+    comparator = Csvtool::Infrastructure::CSV::CsvParityComparator.new
+
+    result = comparator.call(
+      left_path: fixture_path("sample_people.csv"),
+      right_path: fixture_path("parity_people_reordered.csv"),
+      col_sep: ",",
+      headers_present: true
+    )
+
+    assert_equal true, result[:match]
+    assert_equal 0, result[:left_only_count]
+    assert_equal 0, result[:right_only_count]
+  end
+
+  def test_reports_mismatch_counts_for_different_rows
+    comparator = Csvtool::Infrastructure::CSV::CsvParityComparator.new
+
+    result = comparator.call(
+      left_path: fixture_path("sample_people.csv"),
+      right_path: fixture_path("parity_people_mismatch.csv"),
+      col_sep: ",",
+      headers_present: true
+    )
+
+    assert_equal false, result[:match]
+    assert_equal 1, result[:left_only_count]
+    assert_equal 1, result[:right_only_count]
+    assert_equal "Cara,Berlin", result[:left_only_examples][0][:row]
+    assert_equal 1, result[:left_only_examples][0][:count_delta]
+    assert_equal "Dina,Rome", result[:right_only_examples][0][:row]
+    assert_equal 1, result[:right_only_examples][0][:count_delta]
+  end
+
+  def test_respects_duplicate_counts
+    comparator = Csvtool::Infrastructure::CSV::CsvParityComparator.new
+
+    result = comparator.call(
+      left_path: fixture_path("parity_duplicates_left.csv"),
+      right_path: fixture_path("parity_duplicates_right.csv"),
+      col_sep: ",",
+      headers_present: true
+    )
+
+    assert_equal false, result[:match]
+    assert_equal 1, result[:left_only_count]
+    assert_equal 0, result[:right_only_count]
+    assert_equal "1,Alice", result[:left_only_examples][0][:row]
+    assert_equal 1, result[:left_only_examples][0][:count_delta]
+  end
+
+  def test_preserves_exact_semantics_for_larger_fixture_with_different_order
+    comparator = Csvtool::Infrastructure::CSV::CsvParityComparator.new
+
+    result = comparator.call(
+      left_path: fixture_path("sample_people_many.csv"),
+      right_path: fixture_path("parity_people_many_reordered.csv"),
+      col_sep: ",",
+      headers_present: true
+    )
+
+    assert_equal true, result[:match]
+    assert_equal 12, result[:left_rows]
+    assert_equal 12, result[:right_rows]
+    assert_equal 0, result[:left_only_count]
+    assert_equal 0, result[:right_only_count]
+  end
+end

data/test/csvtool/infrastructure/output/csv_cross_csv_dedupe_file_writer_test.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require_relative "../../../test_helper"
+require "csvtool/infrastructure/output/csv_cross_csv_dedupe_file_writer"
+require "tmpdir"
+
+class InfrastructureCsvCrossCsvDedupeFileWriterTest < Minitest::Test
+  class FakeDeduper
+    def each_retained(**_kwargs)
+      yield %w[1 Alice]
+      yield %w[3 Cara]
+      { source_rows: 5, removed_rows: 3, kept_rows_count: 2 }
+    end
+  end
+
+  def test_writes_retained_rows_and_returns_stats
+    writer = Csvtool::Infrastructure::Output::CsvCrossCsvDedupeFileWriter.new(deduper: FakeDeduper.new)
+
+    Dir.mktmpdir do |dir|
+      output_path = File.join(dir, "deduped.csv")
+      stats = writer.call(
+        path: output_path,
+        headers: ["customer_id", "name"],
+        col_sep: ",",
+        dedupe_options: { source_path: "source.csv", reference_path: "reference.csv" }
+      )
+
+      assert_equal "customer_id,name\n1,Alice\n3,Cara\n", File.read(output_path)
+      assert_equal 2, stats[:kept_rows_count]
+    end
+  end
+end

data/test/csvtool/infrastructure/output/csv_file_writer_test.rb

@@ -2,7 +2,6 @@
 
 require_relative "../../../test_helper"
 require "csvtool/infrastructure/output/csv_file_writer"
-require "csvtool/interface/cli/errors/presenter"
 require "tmpdir"
 
 class InfrastructureCsvFileWriterTest < Minitest::Test
@@ -13,10 +12,7 @@ class InfrastructureCsvFileWriterTest < Minitest::Test
   end
 
   def test_writes_header_and_values
-    stdout = StringIO.new
     writer = Csvtool::Infrastructure::Output::CsvFileWriter.new(
-      stdout: stdout,
-      errors: Csvtool::Interface::CLI::Errors::Presenter.new(stdout: stdout),
       value_streamer: FakeStreamer.new
     )
 

data/test/csvtool/infrastructure/output/csv_randomized_row_file_writer_test.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require_relative "../../../test_helper"
+require "csvtool/infrastructure/output/csv_randomized_row_file_writer"
+require "tmpdir"
+
+class InfrastructureCsvRandomizedRowFileWriterTest < Minitest::Test
+  class FakeRandomizer
+    def each(file_path:, col_sep:, headers:, seed:)
+      yield ["Bob", "Paris"]
+      yield ["Cara", "Berlin"]
+    end
+  end
+
+  def test_writes_randomized_rows_with_headers
+    writer = Csvtool::Infrastructure::Output::CsvRandomizedRowFileWriter.new(row_randomizer: FakeRandomizer.new)
+
+    Dir.mktmpdir do |dir|
+      output_path = File.join(dir, "randomized.csv")
+      writer.call(
+        path: output_path,
+        headers: ["name", "city"],
+        file_path: "ignored.csv",
+        col_sep: ",",
+        headers_present: true,
+        seed: 123
+      )
+
+      assert_equal "name,city\nBob,Paris\nCara,Berlin\n", File.read(output_path)
+    end
+  end
+end

data/test/csvtool/infrastructure/output/csv_row_file_writer_test.rb

@@ -2,7 +2,6 @@
 
 require_relative "../../../test_helper"
 require "csvtool/infrastructure/output/csv_row_file_writer"
-require "csvtool/interface/cli/errors/presenter"
 require "tmpdir"
 
 class InfrastructureCsvRowFileWriterTest < Minitest::Test
@@ -15,10 +14,7 @@ class InfrastructureCsvRowFileWriterTest < Minitest::Test
   end
 
   def test_writes_header_and_rows_to_file
-    stdout = StringIO.new
     writer = Csvtool::Infrastructure::Output::CsvRowFileWriter.new(
-      stdout: stdout,
-      errors: Csvtool::Interface::CLI::Errors::Presenter.new(stdout: stdout),
       row_streamer: FakeRowStreamer.new
     )
 
@@ -35,6 +31,7 @@ class InfrastructureCsvRowFileWriterTest < Minitest::Test
 
       assert_equal "name,city\nBob,Paris\nCara,Berlin\n", File.read(output_path)
       assert_equal true, stats[:matched]
+      assert_equal true, stats[:wrote_rows]
     end
   end
 end

data/test/csvtool/interface/cli/errors/presenter_test.rb

@@ -24,6 +24,7 @@ class ErrorsPresenterTest < Minitest::Test
     presenter.invalid_end_row
     presenter.invalid_row_range_order
     presenter.row_range_out_of_bounds(3)
+    presenter.header_mismatch
 
     text = out.string
     assert_includes text, "File not found: /tmp/x.csv"
@@ -42,5 +43,6 @@ class ErrorsPresenterTest < Minitest::Test
     assert_includes text, "End row must be a positive integer."
     assert_includes text, "End row must be greater than or equal to start row."
     assert_includes text, "Row range is out of bounds. File has 3 data rows."
+    assert_includes text, "CSV headers do not match."
   end
 end

data/test/csvtool/interface/cli/menu_loop_test.rb

@@ -21,15 +21,17 @@ class MenuLoopTest < Minitest::Test
     rows_action = FakeAction.new
     randomize_rows_action = FakeAction.new
     dedupe_action = FakeAction.new
+    parity_action = FakeAction.new
     stdout = StringIO.new
     menu = Csvtool::Interface::CLI::MenuLoop.new(
-      stdin: StringIO.new("1\n5\n"),
+      stdin: StringIO.new("1\n6\n"),
       stdout: stdout,
-      menu_options: ["Extract column", "Extract rows (range)", "Randomize rows", "Dedupe using another CSV", "Exit"],
+      menu_options: ["Extract column", "Extract rows (range)", "Randomize rows", "Dedupe using another CSV", "Validate parity", "Exit"],
       extract_column_action: column_action,
       extract_rows_action: rows_action,
       randomize_rows_action: randomize_rows_action,
-      dedupe_action: dedupe_action
+      dedupe_action: dedupe_action,
+      parity_action: parity_action
     )
 
     status = menu.run
@@ -39,6 +41,7 @@ class MenuLoopTest < Minitest::Test
     assert_equal 0, rows_action.runs
     assert_equal 0, randomize_rows_action.runs
     assert_equal 0, dedupe_action.runs
+    assert_equal 0, parity_action.runs
     assert_includes stdout.string, "CSV Tool Menu"
   end
 
@@ -47,15 +50,17 @@ class MenuLoopTest < Minitest::Test
     rows_action = FakeAction.new
     randomize_rows_action = FakeAction.new
     dedupe_action = FakeAction.new
+    parity_action = FakeAction.new
     stdout = StringIO.new
     menu = Csvtool::Interface::CLI::MenuLoop.new(
-      stdin: StringIO.new("2\n5\n"),
+      stdin: StringIO.new("2\n6\n"),
       stdout: stdout,
-      menu_options: ["Extract column", "Extract rows (range)", "Randomize rows", "Dedupe using another CSV", "Exit"],
+      menu_options: ["Extract column", "Extract rows (range)", "Randomize rows", "Dedupe using another CSV", "Validate parity", "Exit"],
       extract_column_action: column_action,
       extract_rows_action: rows_action,
       randomize_rows_action: randomize_rows_action,
-      dedupe_action: dedupe_action
+      dedupe_action: dedupe_action,
+      parity_action: parity_action
     )
 
     status = menu.run
@@ -65,6 +70,7 @@ class MenuLoopTest < Minitest::Test
     assert_equal 1, rows_action.runs
     assert_equal 0, randomize_rows_action.runs
     assert_equal 0, dedupe_action.runs
+    assert_equal 0, parity_action.runs
   end
 
   def test_routes_randomize_rows_then_exit
@@ -72,15 +78,17 @@ class MenuLoopTest < Minitest::Test
     rows_action = FakeAction.new
     randomize_rows_action = FakeAction.new
     dedupe_action = FakeAction.new
+    parity_action = FakeAction.new
     stdout = StringIO.new
     menu = Csvtool::Interface::CLI::MenuLoop.new(
-      stdin: StringIO.new("3\n5\n"),
+      stdin: StringIO.new("3\n6\n"),
       stdout: stdout,
-      menu_options: ["Extract column", "Extract rows (range)", "Randomize rows", "Dedupe using another CSV", "Exit"],
+      menu_options: ["Extract column", "Extract rows (range)", "Randomize rows", "Dedupe using another CSV", "Validate parity", "Exit"],
       extract_column_action: column_action,
       extract_rows_action: rows_action,
       randomize_rows_action: randomize_rows_action,
-      dedupe_action: dedupe_action
+      dedupe_action: dedupe_action,
+      parity_action: parity_action
     )
 
     status = menu.run
@@ -90,6 +98,7 @@ class MenuLoopTest < Minitest::Test
     assert_equal 0, rows_action.runs
     assert_equal 1, randomize_rows_action.runs
     assert_equal 0, dedupe_action.runs
+    assert_equal 0, parity_action.runs
   end
 
   def test_routes_dedupe_then_exit
@@ -97,15 +106,17 @@ class MenuLoopTest < Minitest::Test
     rows_action = FakeAction.new
     randomize_rows_action = FakeAction.new
     dedupe_action = FakeAction.new
+    parity_action = FakeAction.new
     stdout = StringIO.new
     menu = Csvtool::Interface::CLI::MenuLoop.new(
-      stdin: StringIO.new("4\n5\n"),
+      stdin: StringIO.new("4\n6\n"),
       stdout: stdout,
-      menu_options: ["Extract column", "Extract rows (range)", "Randomize rows", "Dedupe using another CSV", "Exit"],
+      menu_options: ["Extract column", "Extract rows (range)", "Randomize rows", "Dedupe using another CSV", "Validate parity", "Exit"],
       extract_column_action: column_action,
       extract_rows_action: rows_action,
       randomize_rows_action: randomize_rows_action,
-      dedupe_action: dedupe_action
+      dedupe_action: dedupe_action,
+      parity_action: parity_action
     )
 
     status = menu.run
@@ -115,6 +126,35 @@ class MenuLoopTest < Minitest::Test
     assert_equal 0, rows_action.runs
     assert_equal 0, randomize_rows_action.runs
     assert_equal 1, dedupe_action.runs
+    assert_equal 0, parity_action.runs
+  end
+
+  def test_routes_parity_then_exit
+    column_action = FakeAction.new
+    rows_action = FakeAction.new
+    randomize_rows_action = FakeAction.new
+    dedupe_action = FakeAction.new
+    parity_action = FakeAction.new
+    stdout = StringIO.new
+    menu = Csvtool::Interface::CLI::MenuLoop.new(
+      stdin: StringIO.new("5\n6\n"),
+      stdout: stdout,
+      menu_options: ["Extract column", "Extract rows (range)", "Randomize rows", "Dedupe using another CSV", "Validate parity", "Exit"],
+      extract_column_action: column_action,
+      extract_rows_action: rows_action,
+      randomize_rows_action: randomize_rows_action,
+      dedupe_action: dedupe_action,
+      parity_action: parity_action
+    )
+
+    status = menu.run
+
+    assert_equal 0, status
+    assert_equal 0, column_action.runs
+    assert_equal 0, rows_action.runs
+    assert_equal 0, randomize_rows_action.runs
+    assert_equal 0, dedupe_action.runs
+    assert_equal 1, parity_action.runs
   end
 
   def test_invalid_choice_shows_prompt
@@ -122,23 +162,26 @@ class MenuLoopTest < Minitest::Test
     rows_action = FakeAction.new
     randomize_rows_action = FakeAction.new
     dedupe_action = FakeAction.new
+    parity_action = FakeAction.new
     stdout = StringIO.new
     menu = Csvtool::Interface::CLI::MenuLoop.new(
-      stdin: StringIO.new("x\n5\n"),
+      stdin: StringIO.new("x\n6\n"),
       stdout: stdout,
-      menu_options: ["Extract column", "Extract rows (range)", "Randomize rows", "Dedupe using another CSV", "Exit"],
+      menu_options: ["Extract column", "Extract rows (range)", "Randomize rows", "Dedupe using another CSV", "Validate parity", "Exit"],
       extract_column_action: column_action,
       extract_rows_action: rows_action,
       randomize_rows_action: randomize_rows_action,
-      dedupe_action: dedupe_action
+      dedupe_action: dedupe_action,
+      parity_action: parity_action
     )
 
     menu.run
 
-    assert_includes stdout.string, "Please choose 1, 2, 3, 4, or 5."
+    assert_includes stdout.string, "Please choose 1, 2, 3, 4, 5, or 6."
     assert_equal 0, column_action.runs
     assert_equal 0, rows_action.runs
     assert_equal 0, randomize_rows_action.runs
     assert_equal 0, dedupe_action.runs
+    assert_equal 0, parity_action.runs
   end
 end

data/test/csvtool/interface/cli/prompts/dedupe_key_selector_prompt_test.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require_relative "../../../../test_helper"
+require "csvtool/interface/cli/prompts/dedupe_key_selector_prompt"
+
+class DedupeKeySelectorPromptTest < Minitest::Test
+  def test_builds_name_selector_in_header_mode
+    prompt = Csvtool::Interface::CLI::Prompts::DedupeKeySelectorPrompt.new(stdin: StringIO.new("customer_id\n"), stdout: StringIO.new)
+
+    selector = prompt.call(label: "Source", headers_present: true)
+
+    assert_equal true, selector.headers_present?
+    assert_equal "customer_id", selector.value
+  end
+
+  def test_builds_index_selector_in_headerless_mode
+    prompt = Csvtool::Interface::CLI::Prompts::DedupeKeySelectorPrompt.new(stdin: StringIO.new("2\n"), stdout: StringIO.new)
+
+    selector = prompt.call(label: "Reference", headers_present: false)
+
+    assert_equal true, selector.index?
+    assert_equal 2, selector.value
+  end
+
+  def test_returns_nil_for_invalid_selector
+    prompt = Csvtool::Interface::CLI::Prompts::DedupeKeySelectorPrompt.new(stdin: StringIO.new("\n"), stdout: StringIO.new)
+
+    assert_nil prompt.call(label: "Source", headers_present: true)
+  end
+end

data/test/csvtool/interface/cli/prompts/file_path_prompt_test.rb

@@ -8,4 +8,13 @@ class FilePathPromptTest < Minitest::Test
     prompt = Csvtool::Interface::CLI::Prompts::FilePathPrompt.new(stdin: StringIO.new("  /tmp/a.csv  \n"), stdout: StringIO.new)
     assert_equal "/tmp/a.csv", prompt.call
   end
+
+  def test_supports_custom_label
+    out = StringIO.new
+    prompt = Csvtool::Interface::CLI::Prompts::FilePathPrompt.new(stdin: StringIO.new("/tmp/a.csv\n"), stdout: out)
+
+    prompt.call(label: "Reference CSV file path: ")
+
+    assert_includes out.string, "Reference CSV file path: "
+  end
 end

data/test/csvtool/interface/cli/prompts/headers_present_prompt_test.rb

@@ -11,4 +11,14 @@ class HeadersPresentPromptTest < Minitest::Test
     assert_equal true, yes_prompt.call
     assert_equal false, no_prompt.call
   end
+
+  def test_supports_custom_label
+    out = StringIO.new
+    prompt = Csvtool::Interface::CLI::Prompts::HeadersPresentPrompt.new(stdin: StringIO.new("yes\n"), stdout: out)
+
+    result = prompt.call(label: "Source headers present? [Y/n]: ")
+
+    assert_equal true, result
+    assert_includes out.string, "Source headers present? [Y/n]: "
+  end
 end

data/test/csvtool/interface/cli/prompts/separator_prompt_test.rb

@@ -28,4 +28,14 @@ class SeparatorPromptTest < Minitest::Test
     assert_nil prompt.call
     assert_includes errors.calls, :empty_custom_separator
   end
+
+  def test_supports_custom_label
+    errors = FakeErrors.new
+    out = StringIO.new
+    prompt = Csvtool::Interface::CLI::Prompts::SeparatorPrompt.new(stdin: StringIO.new("\n"), stdout: out, errors: errors)
+
+    prompt.call(label: "Reference CSV separator:")
+
+    assert_includes out.string, "Reference CSV separator:"
+  end
 end

data/test/csvtool/interface/cli/prompts/yes_no_prompt_test.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require_relative "../../../../test_helper"
+require "csvtool/interface/cli/prompts/yes_no_prompt"
+
+class YesNoPromptTest < Minitest::Test
+  def test_uses_default_for_blank_or_invalid
+    prompt_blank = Csvtool::Interface::CLI::Prompts::YesNoPrompt.new(stdin: StringIO.new("\n"), stdout: StringIO.new)
+    prompt_invalid = Csvtool::Interface::CLI::Prompts::YesNoPrompt.new(stdin: StringIO.new("maybe\n"), stdout: StringIO.new)
+
+    assert_equal true, prompt_blank.call(label: "Q? ", default: true)
+    assert_equal false, prompt_invalid.call(label: "Q? ", default: false)
+  end
+
+  def test_accepts_yes_and_no_inputs
+    prompt_yes = Csvtool::Interface::CLI::Prompts::YesNoPrompt.new(stdin: StringIO.new("y\n"), stdout: StringIO.new)
+    prompt_no = Csvtool::Interface::CLI::Prompts::YesNoPrompt.new(stdin: StringIO.new("no\n"), stdout: StringIO.new)
+
+    assert_equal true, prompt_yes.call(label: "Q? ", default: false)
+    assert_equal false, prompt_no.call(label: "Q? ", default: true)
+  end
+end

data/test/csvtool/interface/cli/workflows/builders/column_session_builder_test.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative "../../../../../test_helper"
+require "csvtool/interface/cli/workflows/builders/column_session_builder"
+
+class ColumnSessionBuilderTest < Minitest::Test
+  def test_builds_column_session
+    builder = Csvtool::Interface::CLI::Workflows::Builders::ColumnSessionBuilder.new
+
+    session = builder.call(file_path: "/tmp/data.csv", col_sep: ",", column_name: "name", skip_blanks: true)
+
+    assert_equal "/tmp/data.csv", session.source.path
+    assert_equal ",", session.source.separator.value
+    assert_equal "name", session.column_selection.name
+    assert_equal true, session.options.skip_blanks?
+  end
+end

data/test/csvtool/interface/cli/workflows/builders/cross_csv_dedupe_session_builder_test.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require_relative "../../../../../test_helper"
+require "csvtool/interface/cli/workflows/builders/cross_csv_dedupe_session_builder"
+require "csvtool/domain/cross_csv_dedupe_session/csv_profile"
+require "csvtool/domain/cross_csv_dedupe_session/column_selector"
+require "csvtool/domain/shared/output_destination"
+
+class CrossCsvDedupeSessionBuilderTest < Minitest::Test
+  def test_builds_cross_csv_dedupe_session
+    builder = Csvtool::Interface::CLI::Workflows::Builders::CrossCsvDedupeSessionBuilder.new
+    source = Csvtool::Domain::CrossCsvDedupeSession::CsvProfile.new(path: "/tmp/source.csv", separator: ",", headers_present: true)
+    reference = Csvtool::Domain::CrossCsvDedupeSession::CsvProfile.new(path: "/tmp/reference.csv", separator: ",", headers_present: true)
+    source_selector = Csvtool::Domain::CrossCsvDedupeSession::ColumnSelector.from_input(headers_present: true, input: "id")
+    reference_selector = Csvtool::Domain::CrossCsvDedupeSession::ColumnSelector.from_input(headers_present: true, input: "rid")
+    destination = Csvtool::Domain::Shared::OutputDestination.console
+
+    session = builder.call(
+      source: source,
+      reference: reference,
+      source_selector: source_selector,
+      reference_selector: reference_selector,
+      trim_whitespace: true,
+      case_insensitive: false,
+      destination: destination
+    )
+
+    assert_equal "/tmp/source.csv", session.source.path
+    assert_equal "/tmp/reference.csv", session.reference.path
+    assert_equal "id", session.key_mapping.source_selector.value
+    assert_equal "rid", session.key_mapping.reference_selector.value
+    assert_equal true, session.match_options.trim_whitespace?
+    assert_equal false, session.match_options.case_insensitive?
+    assert_equal true, session.output_destination.console?
+  end
+end

data/test/csvtool/interface/cli/workflows/builders/csv_parity_session_builder_test.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require_relative "../../../../../test_helper"
+require "csvtool/interface/cli/workflows/builders/csv_parity_session_builder"
+
+class CsvParitySessionBuilderTest < Minitest::Test
+  def test_builds_parity_session
+    session = Csvtool::Interface::CLI::Workflows::Builders::CsvParitySessionBuilder.new.call(
+      left_path: "/tmp/left.csv",
+      right_path: "/tmp/right.csv",
+      col_sep: "\t",
+      headers_present: false
+    )
+
+    assert_equal "/tmp/left.csv", session.source_pair.left_path
+    assert_equal "/tmp/right.csv", session.source_pair.right_path
+    assert_equal "\t", session.options.separator
+    assert_equal false, session.options.headers_present?
+  end
+end

data/test/csvtool/interface/cli/workflows/builders/row_extraction_session_builder_test.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require_relative "../../../../../test_helper"
+require "csvtool/interface/cli/workflows/builders/row_extraction_session_builder"
+require "csvtool/domain/row_session/row_range"
+require "csvtool/domain/shared/output_destination"
+
+class RowExtractionSessionBuilderTest < Minitest::Test
+  def test_builds_row_extraction_session
+    builder = Csvtool::Interface::CLI::Workflows::Builders::RowExtractionSessionBuilder.new
+    row_range = Csvtool::Domain::RowSession::RowRange.new(start_row: 2, end_row: 4)
+    destination = Csvtool::Domain::Shared::OutputDestination.console
+
+    session = builder.call(file_path: "/tmp/data.csv", col_sep: ";", row_range: row_range, destination: destination)
+
+    assert_equal "/tmp/data.csv", session.source.path
+    assert_equal ";", session.source.separator
+    assert_equal 2, session.row_range.start_row
+    assert_equal true, session.output_destination.console?
+  end
+end

data/test/csvtool/interface/cli/workflows/builders/row_randomization_session_builder_test.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative "../../../../../test_helper"
+require "csvtool/interface/cli/workflows/builders/row_randomization_session_builder"
+require "csvtool/domain/shared/output_destination"
+
+class RowRandomizationSessionBuilderTest < Minitest::Test
+  def test_builds_row_randomization_session
+    builder = Csvtool::Interface::CLI::Workflows::Builders::RowRandomizationSessionBuilder.new
+    destination = Csvtool::Domain::Shared::OutputDestination.file(path: "/tmp/out.csv")
+
+    session = builder.call(
+      file_path: "/tmp/data.csv",
+      col_sep: "\t",
+      headers_present: false,
+      seed: 12,
+      destination: destination
+    )
+
+    assert_equal "/tmp/data.csv", session.source.path
+    assert_equal "\t", session.source.separator
+    assert_equal false, session.source.headers_present?
+    assert_equal 12, session.options.seed
+    assert_equal true, session.output_destination.file?
+  end
+end

data/test/csvtool/interface/cli/workflows/presenters/column_extraction_presenter_test.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative "../../../../../test_helper"
+require "csvtool/interface/cli/workflows/presenters/column_extraction_presenter"
+
+class ColumnExtractionPresenterTest < Minitest::Test
+  def test_prints_value
+    out = StringIO.new
+    presenter = Csvtool::Interface::CLI::Workflows::Presenters::ColumnExtractionPresenter.new(stdout: out)
+
+    presenter.print_value("Alice")
+
+    assert_equal "Alice\n", out.string
+  end
+
+  def test_prints_file_written_message
+    out = StringIO.new
+    presenter = Csvtool::Interface::CLI::Workflows::Presenters::ColumnExtractionPresenter.new(stdout: out)
+
+    presenter.print_file_written("/tmp/names.csv")
+
+    assert_includes out.string, "Wrote output to /tmp/names.csv"
+  end
+end

data/test/csvtool/interface/cli/workflows/presenters/cross_csv_dedupe_presenter_test.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require_relative "../../../../../test_helper"
+require "csvtool/interface/cli/workflows/presenters/cross_csv_dedupe_presenter"
+
+class CrossCsvDedupePresenterTest < Minitest::Test
+  def test_prints_header_row_and_summary
+    out = StringIO.new
+    presenter = Csvtool::Interface::CLI::Workflows::Presenters::CrossCsvDedupePresenter.new(stdout: out, col_sep: ",")
+
+    presenter.print_header(["id", "name"])
+    presenter.print_row(["1", "Alice"])
+    presenter.print_summary(source_rows: 5, removed_rows: 3, kept_rows_count: 2)
+
+    assert_includes out.string, "\nid,name\n"
+    assert_includes out.string, "1,Alice"
+    assert_includes out.string, "Summary: source_rows=5 removed_rows=3 kept_rows=2"
+  end
+
+  def test_prints_zero_and_all_removed_messages
+    out = StringIO.new
+    presenter = Csvtool::Interface::CLI::Workflows::Presenters::CrossCsvDedupePresenter.new(stdout: out, col_sep: ",")
+
+    presenter.print_summary(source_rows: 5, removed_rows: 0, kept_rows_count: 5)
+    presenter.print_summary(source_rows: 5, removed_rows: 5, kept_rows_count: 0)
+
+    assert_includes out.string, "No rows removed; no matching keys found."
+    assert_includes out.string, "All source rows were removed by dedupe."
+  end
+end