csvops 0.5.0.alpha → 0.6.0.alpha

data/test/csvtool/cli_unit_test.rb

@@ -16,7 +16,7 @@ class CliUnitTest < Minitest::Test
   end
 
   def test_menu_command_can_exit_zero
-    status = Csvtool::CLI.start(["menu"], stdin: StringIO.new("5\n"), stdout: StringIO.new, stderr: StringIO.new)
+    status = Csvtool::CLI.start(["menu"], stdin: StringIO.new("6\n"), stdout: StringIO.new, stderr: StringIO.new)
     assert_equal 0, status
   end
 
@@ -28,7 +28,7 @@ class CliUnitTest < Minitest::Test
   def test_menu_routes_to_row_range_shell
     stdout = StringIO.new
     fixture = File.expand_path("../fixtures/sample_people.csv", __dir__)
-    input = ["2", fixture, "", "2", "3", "", "5"].join("\n") + "\n"
+    input = ["2", fixture, "", "2", "3", "", "6"].join("\n") + "\n"
     status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: stdout, stderr: StringIO.new)
     assert_equal 0, status
     assert_includes stdout.string, "name,city"
@@ -39,7 +39,7 @@ class CliUnitTest < Minitest::Test
   def test_menu_routes_to_randomize_rows_shell
     stdout = StringIO.new
     fixture = File.expand_path("../fixtures/sample_people.csv", __dir__)
-    input = ["3", fixture, "", "", "", "", "5"].join("\n") + "\n"
+    input = ["3", fixture, "", "", "", "", "6"].join("\n") + "\n"
     status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: stdout, stderr: StringIO.new)
     assert_equal 0, status
     assert_includes stdout.string, "name,city"
@@ -52,7 +52,7 @@ class CliUnitTest < Minitest::Test
     stdout = StringIO.new
     source_fixture = File.expand_path("../fixtures/dedupe_source.csv", __dir__)
     reference_fixture = File.expand_path("../fixtures/dedupe_reference.csv", __dir__)
-    input = ["4", source_fixture, "", "", reference_fixture, "", "", "customer_id", "external_id", "", "", "", "5"].join("\n") + "\n"
+    input = ["4", source_fixture, "", "", reference_fixture, "", "", "customer_id", "external_id", "", "", "", "6"].join("\n") + "\n"
     status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: stdout, stderr: StringIO.new)
     assert_equal 0, status
     assert_includes stdout.string, "customer_id,name"

data/test/csvtool/domain/csv_parity_session/parity_options_test.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative "../../../test_helper"
+require "csvtool/domain/csv_parity_session/parity_options"
+
+class ParityOptionsTest < Minitest::Test
+  def test_requires_separator
+    assert_raises(ArgumentError) do
+      Csvtool::Domain::CsvParitySession::ParityOptions.new(separator: "", headers_present: true)
+    end
+  end
+
+  def test_exposes_headers_present
+    options = Csvtool::Domain::CsvParitySession::ParityOptions.new(separator: ",", headers_present: false)
+    assert_equal false, options.headers_present?
+  end
+end

data/test/csvtool/domain/csv_parity_session/parity_session_test.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require_relative "../../../test_helper"
+require "csvtool/domain/csv_parity_session/source_pair"
+require "csvtool/domain/csv_parity_session/parity_options"
+require "csvtool/domain/csv_parity_session/parity_session"
+
+class ParitySessionTest < Minitest::Test
+  def test_stores_source_pair_and_options
+    source_pair = Csvtool::Domain::CsvParitySession::SourcePair.new(left_path: "/tmp/l.csv", right_path: "/tmp/r.csv")
+    options = Csvtool::Domain::CsvParitySession::ParityOptions.new(separator: ",", headers_present: true)
+
+    session = Csvtool::Domain::CsvParitySession::ParitySession.start(source_pair: source_pair, options: options)
+
+    assert_equal source_pair, session.source_pair
+    assert_equal options, session.options
+  end
+end

data/test/csvtool/domain/csv_parity_session/source_pair_test.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative "../../../test_helper"
+require "csvtool/domain/csv_parity_session/source_pair"
+
+class SourcePairTest < Minitest::Test
+  def test_requires_paths
+    assert_raises(ArgumentError) { Csvtool::Domain::CsvParitySession::SourcePair.new(left_path: "", right_path: "/tmp/r.csv") }
+    assert_raises(ArgumentError) { Csvtool::Domain::CsvParitySession::SourcePair.new(left_path: "/tmp/l.csv", right_path: "") }
+  end
+end

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/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/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/presenters/csv_parity_presenter_test.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require_relative "../../../../../test_helper"
+require "csvtool/interface/cli/workflows/presenters/csv_parity_presenter"
+
+class CsvParityPresenterTest < Minitest::Test
+  def test_prints_match_summary
+    out = StringIO.new
+    presenter = Csvtool::Interface::CLI::Workflows::Presenters::CsvParityPresenter.new(stdout: out)
+
+    presenter.print_summary(
+      match: true,
+      left_rows: 3,
+      right_rows: 3,
+      left_only_count: 0,
+      right_only_count: 0
+    )
+
+    assert_includes out.string, "MATCH"
+    assert_includes out.string, "Summary: left_rows=3 right_rows=3 left_only=0 right_only=0"
+  end
+
+  def test_prints_mismatch_examples
+    out = StringIO.new
+    presenter = Csvtool::Interface::CLI::Workflows::Presenters::CsvParityPresenter.new(stdout: out)
+
+    presenter.print_summary(
+      match: false,
+      left_rows: 3,
+      right_rows: 3,
+      left_only_count: 1,
+      right_only_count: 1,
+      left_only_examples: [{ row: "Cara,Berlin", count_delta: 1 }],
+      right_only_examples: [{ row: "Dina,Rome", count_delta: 1 }]
+    )
+
+    assert_includes out.string, "MISMATCH"
+    assert_includes out.string, "Left-only examples:"
+    assert_includes out.string, "Cara,Berlin (count +1)"
+    assert_includes out.string, "Right-only examples:"
+    assert_includes out.string, "Dina,Rome (count +1)"
+  end
+end

data/test/csvtool/interface/cli/workflows/run_csv_parity_workflow_test.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+require_relative "../../../../test_helper"
+require "csvtool/interface/cli/workflows/run_csv_parity_workflow"
+
+class RunCsvParityWorkflowTest < Minitest::Test
+  class FakeUseCase
+    attr_reader :calls
+
+    def initialize
+      @calls = []
+    end
+
+    def call(session:)
+      @calls << session
+      Struct.new(:ok?, :data).new(true, {
+        match: true,
+        left_rows: 3,
+        right_rows: 3,
+        left_only_count: 0,
+        right_only_count: 0
+      })
+    end
+  end
+
+  class MismatchUseCase
+    def call(session:)
+      Struct.new(:ok?, :data).new(true, {
+        match: false,
+        left_rows: 3,
+        right_rows: 3,
+        left_only_count: 1,
+        right_only_count: 1,
+        left_only_examples: [{ row: "Cara,Berlin", count_delta: 1 }],
+        right_only_examples: [{ row: "Dina,Rome", count_delta: 1 }]
+      })
+    end
+  end
+
+  class CannotReadUseCase
+    def call(session:)
+      Struct.new(:ok?, :error, :data).new(false, :cannot_read_file, { path: "/tmp/protected.csv" })
+    end
+  end
+
+  def test_prompts_for_paths_and_calls_use_case
+    stdout = StringIO.new
+    use_case = FakeUseCase.new
+    input = StringIO.new("/tmp/left.csv\n/tmp/right.csv\n2\ny\n")
+
+    Csvtool::Interface::CLI::Workflows::RunCsvParityWorkflow
+      .new(stdin: input, stdout: stdout, use_case: use_case)
+      .call
+
+    call = use_case.calls.first
+    assert_equal "/tmp/left.csv", call.source_pair.left_path
+    assert_equal "/tmp/right.csv", call.source_pair.right_path
+    assert_equal "\t", call.options.separator
+    assert_equal true, call.options.headers_present?
+    assert_includes stdout.string, "Left CSV file path: "
+    assert_includes stdout.string, "Right CSV file path: "
+    assert_includes stdout.string, "Choose separator:"
+    assert_includes stdout.string, "Headers present? [Y/n]: "
+    assert_includes stdout.string, "MATCH"
+    assert_includes stdout.string, "Summary: left_rows=3 right_rows=3 left_only=0 right_only=0"
+  end
+
+  def test_prints_mismatch_examples_when_not_equal
+    stdout = StringIO.new
+    input = StringIO.new("/tmp/left.csv\n/tmp/right.csv\n\ny\n")
+
+    Csvtool::Interface::CLI::Workflows::RunCsvParityWorkflow
+      .new(stdin: input, stdout: stdout, use_case: MismatchUseCase.new)
+      .call
+
+    assert_includes stdout.string, "MISMATCH"
+    assert_includes stdout.string, "Left-only examples:"
+    assert_includes stdout.string, "Cara,Berlin (count +1)"
+    assert_includes stdout.string, "Right-only examples:"
+    assert_includes stdout.string, "Dina,Rome (count +1)"
+  end
+
+  def test_prints_cannot_read_error_without_stacktrace
+    stdout = StringIO.new
+    input = StringIO.new("/tmp/left.csv\n/tmp/right.csv\n\ny\n")
+
+    Csvtool::Interface::CLI::Workflows::RunCsvParityWorkflow
+      .new(stdin: input, stdout: stdout, use_case: CannotReadUseCase.new)
+      .call
+
+    assert_includes stdout.string, "Cannot read file: /tmp/protected.csv"
+    refute_includes stdout.string, "Traceback"
+  end
+end

data/test/csvtool/interface/cli/workflows/steps/parity/build_session_step_test.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative "../../../../../../test_helper"
+require "csvtool/interface/cli/workflows/steps/parity/build_session_step"
+
+class ParityBuildSessionStepTest < Minitest::Test
+  class FakeBuilder
+    attr_reader :args
+
+    def call(left_path:, right_path:, col_sep:, headers_present:)
+      @args = {
+        left_path: left_path,
+        right_path: right_path,
+        col_sep: col_sep,
+        headers_present: headers_present
+      }
+      :session
+    end
+  end
+
+  def test_builds_session_from_context
+    builder = FakeBuilder.new
+    step = Csvtool::Interface::CLI::Workflows::Steps::Parity::BuildSessionStep.new
+    context = {
+      session_builder: builder,
+      left_path: "/tmp/left.csv",
+      right_path: "/tmp/right.csv",
+      col_sep: "\t",
+      headers_present: false
+    }
+
+    result = step.call(context)
+
+    assert_nil result
+    assert_equal :session, context[:session]
+    assert_equal "/tmp/left.csv", builder.args[:left_path]
+    assert_equal "/tmp/right.csv", builder.args[:right_path]
+    assert_equal "\t", builder.args[:col_sep]
+    assert_equal false, builder.args[:headers_present]
+  end
+end

data/test/csvtool/interface/cli/workflows/steps/parity/collect_inputs_step_test.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require_relative "../../../../../../test_helper"
+require "csvtool/interface/cli/workflows/steps/parity/collect_inputs_step"
+
+class ParityCollectInputsStepTest < Minitest::Test
+  def test_collects_inputs_into_context
+    file_prompt = Object.new
+    separator_prompt = Object.new
+    headers_prompt = Object.new
+    def file_prompt.call(label:) = label.include?("Left") ? "/tmp/left.csv" : "/tmp/right.csv"
+    def separator_prompt.call = ","
+    def headers_prompt.call = true
+
+    step = Csvtool::Interface::CLI::Workflows::Steps::Parity::CollectInputsStep.new(
+      file_path_prompt: file_prompt,
+      separator_prompt: separator_prompt,
+      headers_present_prompt: headers_prompt
+    )
+    context = {}
+
+    result = step.call(context)
+
+    assert_nil result
+    assert_equal "/tmp/left.csv", context[:left_path]
+    assert_equal "/tmp/right.csv", context[:right_path]
+    assert_equal ",", context[:col_sep]
+    assert_equal true, context[:headers_present]
+  end
+end

data/test/csvtool/interface/cli/workflows/steps/parity/execute_step_test.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative "../../../../../../test_helper"
+require "csvtool/interface/cli/workflows/steps/parity/execute_step"
+
+class ParityExecuteStepTest < Minitest::Test
+  Result = Struct.new(:ok, :data) do
+    def ok? = ok
+  end
+
+  class FakeUseCase
+    attr_reader :session
+
+    def call(session:)
+      @session = session
+      Result.new(true, { match: true })
+    end
+  end
+
+  class FakePresenter
+    attr_reader :data
+
+    def print_summary(data)
+      @data = data
+    end
+  end
+
+  def test_calls_use_case_and_presenter
+    step = Csvtool::Interface::CLI::Workflows::Steps::Parity::ExecuteStep.new
+    use_case = FakeUseCase.new
+    presenter = FakePresenter.new
+    context = { use_case: use_case, session: :session, presenter: presenter, handle_error: ->(_r) {} }
+
+    result = step.call(context)
+
+    assert_nil result
+    assert_equal :session, use_case.session
+    assert_equal true, presenter.data[:match]
+  end
+end

data/test/fixtures/parity_duplicates_left.csv

@@ -0,0 +1,4 @@
+id,name
+1,Alice
+1,Alice
+2,Bob

data/test/fixtures/parity_duplicates_right.csv

@@ -0,0 +1,3 @@
+id,name
+1,Alice
+2,Bob

data/test/fixtures/parity_people_header_mismatch.csv

@@ -0,0 +1,4 @@
+full_name,city
+Alice,London
+Bob,Paris
+Cara,Berlin

data/test/fixtures/parity_people_many_reordered.csv

@@ -0,0 +1,13 @@
+name
+Name12
+Name11
+Name10
+Name09
+Name08
+Name07
+Name06
+Name05
+Name04
+Name03
+Name02
+Name01

data/test/fixtures/parity_people_mismatch.csv

@@ -0,0 +1,4 @@
+name,city
+Alice,London
+Bob,Paris
+Dina,Rome

data/test/fixtures/parity_people_reordered.csv

@@ -0,0 +1,4 @@
+name,city
+Cara,Berlin
+Alice,London
+Bob,Paris

data/test/fixtures/parity_people_reordered.tsv

@@ -0,0 +1,4 @@
+name	city
+Cara	Berlin
+Alice	London
+Bob	Paris