csvops 0.4.0.alpha → 0.5.0.alpha

data/test/csvtool/application/use_cases/run_row_randomization_test.rb

@@ -2,123 +2,133 @@
 
 require_relative "../../../test_helper"
 require "csvtool/application/use_cases/run_row_randomization"
+require "csvtool/domain/row_randomization_session/randomization_source"
+require "csvtool/domain/row_randomization_session/randomization_options"
+require "csvtool/domain/row_randomization_session/randomization_session"
+require "csvtool/domain/shared/output_destination"
 require "tmpdir"
 
 class RunRowRandomizationTest < Minitest::Test
-  def test_prints_header_then_all_randomized_rows
-    fixture = File.expand_path("../../../fixtures/sample_people.csv", __dir__)
-    output = StringIO.new
-    input = StringIO.new("#{fixture}\n\n\n\n\n")
-
-    Csvtool::Application::UseCases::RunRowRandomization.new(stdin: input, stdout: output).call
-
-    assert_includes output.string, "CSV file path:"
-    header_index = output.string.index("name,city")
-    assert header_index
-    %w[Alice,London Bob,Paris Cara,Berlin].each do |row|
-      row_index = output.string.index(row)
-      assert row_index
-      assert_operator header_index, :<, row_index
+  class RaisingWriter
+    def call(**_kwargs)
+      raise Errno::ENOENT
     end
   end
 
-  def test_missing_file_shows_friendly_error
-    output = StringIO.new
-    input = StringIO.new("/tmp/does-not-exist.csv\n")
-
-    Csvtool::Application::UseCases::RunRowRandomization.new(stdin: input, stdout: output).call
+  def fixture_path(name)
+    File.expand_path("../../../fixtures/#{name}", __dir__)
+  end
 
-    assert_includes output.string, "File not found: /tmp/does-not-exist.csv"
+  def build_session(file_path:, separator: ",", headers_present: true, seed: nil, output: :console, output_path: nil)
+    source = Csvtool::Domain::RowRandomizationSession::RandomizationSource.new(
+      path: file_path,
+      separator: separator,
+      headers_present: headers_present
+    )
+    options = Csvtool::Domain::RowRandomizationSession::RandomizationOptions.new(seed: seed)
+    session = Csvtool::Domain::RowRandomizationSession::RandomizationSession.start(source: source, options: options)
+
+    session.with_output_destination(
+      if output == :file
+        Csvtool::Domain::Shared::OutputDestination.file(path: output_path)
+      else
+        Csvtool::Domain::Shared::OutputDestination.console
+      end
+    )
   end
 
-  def test_can_write_randomized_rows_to_file
-    fixture = File.expand_path("../../../fixtures/sample_people.csv", __dir__)
-    output = StringIO.new
+  def test_read_headers_returns_headers_when_enabled
+    use_case = Csvtool::Application::UseCases::RunRowRandomization.new
 
-    Dir.mktmpdir do |dir|
-      output_path = File.join(dir, "randomized.csv")
-      input = StringIO.new("#{fixture}\n\n\n\n2\n#{output_path}\n")
+    result = use_case.read_headers(file_path: fixture_path("sample_people.csv"), col_sep: ",", headers_present: true)
 
-      Csvtool::Application::UseCases::RunRowRandomization.new(stdin: input, stdout: output).call
-
-      written = File.read(output_path).lines.map(&:strip)
-      assert_equal "name,city", written.first
-      assert_equal ["Alice,London", "Bob,Paris", "Cara,Berlin"].sort, written[1..].sort
-      assert_includes output.string, "Wrote output to #{output_path}"
-    end
+    assert result.ok?
+    assert_equal ["name", "city"], result.data[:headers]
   end
 
-  def test_supports_tsv_separator
-    fixture = File.expand_path("../../../fixtures/sample_people.tsv", __dir__)
-    output = StringIO.new
-    input = StringIO.new("#{fixture}\n2\n\n\n\n")
+  def test_read_headers_returns_nil_when_headers_disabled
+    use_case = Csvtool::Application::UseCases::RunRowRandomization.new
 
-    Csvtool::Application::UseCases::RunRowRandomization.new(stdin: input, stdout: output).call
+    result = use_case.read_headers(file_path: fixture_path("sample_people_no_headers.csv"), col_sep: ",", headers_present: false)
 
-    assert_includes output.string, "name\tcity"
-    assert_includes output.string, "Alice\tLondon"
-    assert_includes output.string, "Bob\tParis"
-    assert_includes output.string, "Cara\tBerlin"
+    assert result.ok?
+    assert_nil result.data[:headers]
   end
 
-  def test_supports_custom_separator
-    fixture = File.expand_path("../../../fixtures/sample_people_colon.txt", __dir__)
-    output = StringIO.new
-    input = StringIO.new("#{fixture}\n5\n:\n\n\n\n")
+  def test_read_headers_fails_for_missing_file
+    use_case = Csvtool::Application::UseCases::RunRowRandomization.new
 
-    Csvtool::Application::UseCases::RunRowRandomization.new(stdin: input, stdout: output).call
+    result = use_case.read_headers(file_path: "/tmp/not-present.csv", col_sep: ",", headers_present: true)
 
-    assert_includes output.string, "name:city"
-    assert_includes output.string, "Alice:London"
-    assert_includes output.string, "Bob:Paris"
-    assert_includes output.string, "Cara:Berlin"
+    refute result.ok?
+    assert_equal :file_not_found, result.error
   end
 
-  def test_headerless_mode_randomizes_all_rows
-    fixture = File.expand_path("../../../fixtures/sample_people_no_headers.csv", __dir__)
-    output = StringIO.new
-    input = StringIO.new("#{fixture}\n\nn\n\n\n")
+  def test_randomize_streams_rows_for_console_mode
+    use_case = Csvtool::Application::UseCases::RunRowRandomization.new
+    session = build_session(file_path: fixture_path("sample_people.csv"), seed: 123)
+    rows = []
 
-    Csvtool::Application::UseCases::RunRowRandomization.new(stdin: input, stdout: output).call
+    result = use_case.randomize(session: session, headers: ["name", "city"], on_row: ->(fields) { rows << fields })
 
-    refute_includes output.string, "name,city"
-    assert_includes output.string, "Alice,London"
-    assert_includes output.string, "Bob,Paris"
-    assert_includes output.string, "Cara,Berlin"
+    assert result.ok?
+    assert_equal 3, rows.length
+    assert_equal [["Alice", "London"], ["Bob", "Paris"], ["Cara", "Berlin"]].sort, rows.sort
   end
 
-  def test_same_seed_produces_same_output_order
-    fixture = File.expand_path("../../../fixtures/sample_people_many.csv", __dir__)
-    input_data = "#{fixture}\n\n\n123\n\n"
-
-    out1 = StringIO.new
-    out2 = StringIO.new
+  def test_randomize_writes_rows_to_file
+    use_case = Csvtool::Application::UseCases::RunRowRandomization.new
 
-    Csvtool::Application::UseCases::RunRowRandomization.new(stdin: StringIO.new(input_data), stdout: out1).call
-    Csvtool::Application::UseCases::RunRowRandomization.new(stdin: StringIO.new(input_data), stdout: out2).call
-
-    rows1 = out1.string.lines.map(&:strip).select { |line| line.include?(",") && !line.start_with?("name,city") }
-    rows2 = out2.string.lines.map(&:strip).select { |line| line.include?(",") && !line.start_with?("name,city") }
-    assert_equal rows1, rows2
+    Dir.mktmpdir do |dir|
+      output_path = File.join(dir, "randomized.csv")
+      session = build_session(
+        file_path: fixture_path("sample_people.csv"),
+        seed: 123,
+        output: :file,
+        output_path: output_path
+      )
+
+      result = use_case.randomize(session: session, headers: ["name", "city"])
+
+      assert result.ok?
+      assert_equal output_path, result.data[:output_path]
+      lines = File.read(output_path).lines.map(&:strip)
+      assert_equal "name,city", lines.first
+      assert_equal ["Alice,London", "Bob,Paris", "Cara,Berlin"].sort, lines[1..].sort
+    end
   end
 
-  def test_invalid_seed_shows_friendly_error
-    fixture = File.expand_path("../../../fixtures/sample_people.csv", __dir__)
-    output = StringIO.new
-    input = StringIO.new("#{fixture}\n\n\nabc\n")
+  def test_same_seed_produces_stable_order
+    use_case = Csvtool::Application::UseCases::RunRowRandomization.new
+    session_1 = build_session(file_path: fixture_path("sample_people_many.csv"), seed: 123)
+    session_2 = build_session(file_path: fixture_path("sample_people_many.csv"), seed: 123)
+    rows_1 = []
+    rows_2 = []
 
-    Csvtool::Application::UseCases::RunRowRandomization.new(stdin: input, stdout: output).call
+    result_1 = use_case.randomize(session: session_1, headers: ["name", "city"], on_row: ->(fields) { rows_1 << fields })
+    result_2 = use_case.randomize(session: session_2, headers: ["name", "city"], on_row: ->(fields) { rows_2 << fields })
 
-    assert_includes output.string, "Seed must be an integer."
+    assert result_1.ok?
+    assert result_2.ok?
+    assert_equal rows_1, rows_2
   end
 
-  def test_malformed_csv_shows_friendly_error
-    fixture = File.expand_path("../../../fixtures/sample_people_bad_tail.csv", __dir__)
-    output = StringIO.new
-    input = StringIO.new("#{fixture}\n\n\n\n\n")
-
-    Csvtool::Application::UseCases::RunRowRandomization.new(stdin: input, stdout: output).call
-
-    assert_includes output.string, "Could not parse CSV file."
+  def test_randomize_returns_cannot_write_output_file_when_writer_fails
+    use_case = Csvtool::Application::UseCases::RunRowRandomization.new(
+      csv_randomized_row_file_writer: RaisingWriter.new
+    )
+    session = build_session(
+      file_path: fixture_path("sample_people.csv"),
+      seed: 123,
+      output: :file,
+      output_path: "/tmp/randomized.csv"
+    )
+
+    result = use_case.randomize(session: session, headers: ["name", "city"])
+
+    refute result.ok?
+    assert_equal :cannot_write_output_file, result.error
+    assert_equal "/tmp/randomized.csv", result.data[:path]
+    assert_equal Errno::ENOENT, result.data[:error_class]
   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/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/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

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

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative "../../../../../test_helper"
+require "csvtool/interface/cli/workflows/presenters/row_extraction_presenter"
+
+class RowExtractionPresenterTest < Minitest::Test
+  def test_prints_header_once_then_rows
+    out = StringIO.new
+    presenter = Csvtool::Interface::CLI::Workflows::Presenters::RowExtractionPresenter.new(
+      stdout: out,
+      headers: ["name", "city"],
+      col_sep: ","
+    )
+
+    presenter.print_row(["Alice", "London"])
+    presenter.print_row(["Bob", "Paris"])
+
+    assert_equal "name,city\nAlice,London\nBob,Paris\n", out.string
+  end
+
+  def test_prints_file_written_message
+    out = StringIO.new
+    presenter = Csvtool::Interface::CLI::Workflows::Presenters::RowExtractionPresenter.new(
+      stdout: out,
+      headers: ["name"],
+      col_sep: ","
+    )
+
+    presenter.print_file_written("/tmp/out.csv")
+
+    assert_includes out.string, "Wrote output to /tmp/out.csv"
+  end
+end