csvops 0.2.0.alpha → 0.4.0.alpha

data/test/csvtool/cli_test.rb

@@ -11,7 +11,7 @@ class TestCli < Minitest::Test
 
   def test_menu_can_exit_cleanly
     output = StringIO.new
-    status = Csvtool::CLI.start(["menu"], stdin: StringIO.new("3\n"), stdout: output, stderr: StringIO.new)
+    status = Csvtool::CLI.start(["menu"], stdin: StringIO.new("5\n"), stdout: output, stderr: StringIO.new)
     assert_equal 0, status
     assert_includes output.string, "CSV Tool Menu"
   end
@@ -26,7 +26,7 @@ class TestCli < Minitest::Test
       "",
       "y",
       "",
-      "3"
+      "5"
     ].join("\n") + "\n"
 
     output = StringIO.new
@@ -58,7 +58,7 @@ class TestCli < Minitest::Test
       "2",
       "3",
       "",
-      "3"
+      "5"
     ].join("\n") + "\n"
 
     status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: output, stderr: StringIO.new)
@@ -79,7 +79,7 @@ class TestCli < Minitest::Test
       "0",
       "3",
       "",
-      "3"
+      "5"
     ].join("\n") + "\n"
 
     status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: output, stderr: StringIO.new)
@@ -98,7 +98,7 @@ class TestCli < Minitest::Test
       "2",
       "3",
       "",
-      "3"
+      "5"
     ].join("\n") + "\n"
 
     status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: output, stderr: StringIO.new)
@@ -119,7 +119,7 @@ class TestCli < Minitest::Test
       "2",
       "3",
       "",
-      "3"
+      "5"
     ].join("\n") + "\n"
 
     status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: output, stderr: StringIO.new)
@@ -144,7 +144,7 @@ class TestCli < Minitest::Test
         "3",
         "2",
         output_path,
-        "3"
+        "5"
       ].join("\n") + "\n"
 
       status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: output, stderr: StringIO.new)
@@ -164,7 +164,7 @@ class TestCli < Minitest::Test
       "1",
       "2",
       "",
-      "3"
+      "5"
     ].join("\n") + "\n"
 
     status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: output, stderr: StringIO.new)
@@ -175,6 +175,225 @@ class TestCli < Minitest::Test
     refute_includes output.string, "Could not parse CSV file."
   end
 
+  def test_randomize_rows_workflow_prints_header_and_all_data_rows
+    output = StringIO.new
+    input = [
+      "3",
+      fixture_path("sample_people.csv"),
+      "",
+      "",
+      "",
+      "",
+      "5"
+    ].join("\n") + "\n"
+
+    status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: output, stderr: StringIO.new)
+
+    assert_equal 0, status
+    assert_includes output.string, "name,city"
+    assert_includes output.string, "Alice,London"
+    assert_includes output.string, "Bob,Paris"
+    assert_includes output.string, "Cara,Berlin"
+  end
+
+  def test_randomize_rows_workflow_can_write_to_file
+    output = StringIO.new
+
+    Dir.mktmpdir do |dir|
+      output_path = File.join(dir, "randomized_rows.csv")
+      input = [
+        "3",
+        fixture_path("sample_people.csv"),
+        "",
+        "",
+        "",
+        "2",
+        output_path,
+        "5"
+      ].join("\n") + "\n"
+
+      status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: output, stderr: StringIO.new)
+
+      assert_equal 0, status
+      assert_includes output.string, "Wrote output to #{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_randomize_rows_workflow_supports_tsv_separator
+    output = StringIO.new
+    input = [
+      "3",
+      fixture_path("sample_people.tsv"),
+      "2",
+      "",
+      "",
+      "",
+      "5"
+    ].join("\n") + "\n"
+
+    status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: output, stderr: StringIO.new)
+
+    assert_equal 0, status
+    assert_includes output.string, "name\tcity"
+    assert_includes output.string, "Alice\tLondon"
+  end
+
+  def test_randomize_rows_workflow_headerless_mode_randomizes_all_rows
+    output = StringIO.new
+    input = [
+      "3",
+      fixture_path("sample_people_no_headers.csv"),
+      "",
+      "n",
+      "",
+      "",
+      "5"
+    ].join("\n") + "\n"
+
+    status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: output, stderr: StringIO.new)
+
+    assert_equal 0, status
+    refute_includes output.string, "name,city"
+    assert_includes output.string, "Alice,London"
+    assert_includes output.string, "Bob,Paris"
+    assert_includes output.string, "Cara,Berlin"
+  end
+
+  def test_randomize_rows_invalid_seed_returns_to_menu
+    output = StringIO.new
+    input = [
+      "3",
+      fixture_path("sample_people.csv"),
+      "",
+      "",
+      "abc",
+      "5"
+    ].join("\n") + "\n"
+
+    status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: output, stderr: StringIO.new)
+
+    assert_equal 0, status
+    assert_includes output.string, "Seed must be an integer."
+    assert_operator output.string.scan("CSV Tool Menu").length, :>=, 2
+  end
+
+  def test_dedupe_workflow_shell_prompts_and_returns_to_menu
+    output = StringIO.new
+    input = [
+      "4",
+      fixture_path("dedupe_source.csv"),
+      "",
+      "",
+      fixture_path("dedupe_reference.csv"),
+      "",
+      "",
+      "customer_id",
+      "external_id",
+      "",
+      "",
+      "",
+      "5"
+    ].join("\n") + "\n"
+
+    status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: output, stderr: StringIO.new)
+
+    assert_equal 0, status
+    assert_includes output.string, "Reference CSV file path:"
+    assert_includes output.string, "Source key column name:"
+    assert_includes output.string, "Reference key column name:"
+    assert_includes output.string, "customer_id,name"
+    assert_includes output.string, "1,Alice"
+    assert_includes output.string, "3,Cara"
+    assert_includes output.string, "Summary: source_rows=5 removed_rows=3 kept_rows=2"
+  end
+
+  def test_dedupe_workflow_can_write_to_file
+    output = StringIO.new
+
+    Dir.mktmpdir do |dir|
+      output_path = File.join(dir, "deduped.csv")
+      input = [
+        "4",
+        fixture_path("dedupe_source.csv"),
+        "",
+        "",
+        fixture_path("dedupe_reference.csv"),
+        "",
+        "",
+      "customer_id",
+      "external_id",
+      "",
+      "",
+      "2",
+      output_path,
+      "5"
+      ].join("\n") + "\n"
+
+      status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: output, stderr: StringIO.new)
+
+      assert_equal 0, status
+      assert_includes output.string, "Wrote output to #{output_path}"
+      assert_equal "customer_id,name\n1,Alice\n3,Cara\n", File.read(output_path)
+      assert_includes output.string, "Summary: source_rows=5 removed_rows=3 kept_rows=2"
+    end
+  end
+
+  def test_dedupe_workflow_supports_tsv_separators
+    output = StringIO.new
+    input = [
+      "4",
+      fixture_path("dedupe_source.tsv"),
+      "2",
+      "",
+      fixture_path("dedupe_reference.tsv"),
+      "2",
+      "",
+      "customer_id",
+      "external_id",
+      "",
+      "",
+      "",
+      "5"
+    ].join("\n") + "\n"
+
+    status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: output, stderr: StringIO.new)
+
+    assert_equal 0, status
+    assert_includes output.string, "customer_id\tname"
+    assert_includes output.string, "1\tAlice"
+    assert_includes output.string, "3\tCara"
+  end
+
+  def test_dedupe_workflow_headerless_mode_supports_index
+    output = StringIO.new
+    input = [
+      "4",
+      fixture_path("dedupe_source_no_headers.csv"),
+      "",
+      "n",
+      fixture_path("dedupe_reference_no_headers.csv"),
+      "",
+      "n",
+      "1",
+      "1",
+      "",
+      "",
+      "",
+      "5"
+    ].join("\n") + "\n"
+
+    status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: output, stderr: StringIO.new)
+
+    assert_equal 0, status
+    refute_includes output.string, "customer_id,name"
+    assert_includes output.string, "1,Alice"
+    assert_includes output.string, "3,Cara"
+    assert_includes output.string, "Summary: source_rows=5 removed_rows=3 kept_rows=2"
+  end
+
   def test_end_to_end_file_output_writes_expected_csv
     output = StringIO.new
     output_path = nil
@@ -191,7 +410,7 @@ class TestCli < Minitest::Test
         "y",
         "2",
         output_path,
-        "3"
+        "5"
       ].join("\n") + "\n"
 
       status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: output, stderr: StringIO.new)
@@ -211,7 +430,7 @@ class TestCli < Minitest::Test
       "1",
       "",
       "n",
-      "3"
+      "5"
     ].join("\n") + "\n"
 
     output = StringIO.new
@@ -226,7 +445,7 @@ class TestCli < Minitest::Test
     output = StringIO.new
     status = Csvtool::CLI.start(
       ["menu"],
-      stdin: StringIO.new("1\n/tmp/does-not-exist.csv\n3\n"),
+      stdin: StringIO.new("1\n/tmp/does-not-exist.csv\n4\n"),
       stdout: output,
       stderr: StringIO.new
     )
@@ -247,7 +466,7 @@ class TestCli < Minitest::Test
       "y",
       "2",
       "/tmp/not-a-dir/out.csv",
-      "3"
+      "5"
     ].join("\n") + "\n"
 
     output = StringIO.new

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("3\n"), stdout: StringIO.new, stderr: StringIO.new)
+    status = Csvtool::CLI.start(["menu"], stdin: StringIO.new("5\n"), stdout: StringIO.new, stderr: StringIO.new)
     assert_equal 0, status
   end
 
@@ -28,11 +28,36 @@ 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", "", "3"].join("\n") + "\n"
+    input = ["2", fixture, "", "2", "3", "", "5"].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"
     assert_includes stdout.string, "Bob,Paris"
     assert_includes stdout.string, "Cara,Berlin"
   end
+
+  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"
+    status = Csvtool::CLI.start(["menu"], stdin: StringIO.new(input), stdout: stdout, stderr: StringIO.new)
+    assert_equal 0, status
+    assert_includes stdout.string, "name,city"
+    assert_includes stdout.string, "Alice,London"
+    assert_includes stdout.string, "Bob,Paris"
+    assert_includes stdout.string, "Cara,Berlin"
+  end
+
+  def test_menu_routes_to_dedupe_shell
+    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"
+    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"
+    assert_includes stdout.string, "1,Alice"
+    assert_includes stdout.string, "3,Cara"
+    assert_includes stdout.string, "Summary: source_rows=5 removed_rows=3 kept_rows=2"
+  end
 end

data/test/csvtool/domain/column_session/column_session_test.rb

@@ -8,7 +8,7 @@ require "csvtool/domain/column_session/column_selection"
 require "csvtool/domain/column_session/extraction_options"
 require "csvtool/domain/column_session/preview"
 require "csvtool/domain/column_session/extraction_value"
-require "csvtool/domain/column_session/output_destination"
+require "csvtool/domain/shared/output_destination"
 
 class ColumnSessionTest < Minitest::Test
   def test_state_transitions
@@ -25,7 +25,7 @@ class ColumnSessionTest < Minitest::Test
       values: [Csvtool::Domain::ColumnSession::ExtractionValue.new("Alice")]
     )
     session = session.with_preview(preview).confirm!.with_output_destination(
-      Csvtool::Domain::ColumnSession::OutputDestination.console
+      Csvtool::Domain::Shared::OutputDestination.console
     )
 
     assert_equal true, session.confirmed?

data/test/csvtool/domain/column_session/csv_source_test.rb

@@ -11,4 +11,14 @@ class CsvSourceTest < Minitest::Test
     assert_equal "/tmp/a.csv", source.path
     assert_equal separator, source.separator
   end
+
+  def test_rejects_empty_path
+    separator = Csvtool::Domain::ColumnSession::Separator.new(",")
+
+    error = assert_raises(ArgumentError) do
+      Csvtool::Domain::ColumnSession::CsvSource.new(path: "", separator: separator)
+    end
+
+    assert_equal "path cannot be empty", error.message
+  end
 end

data/test/csvtool/domain/cross_csv_dedupe_session/column_selector_test.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require_relative "../../../test_helper"
+require "csvtool/domain/cross_csv_dedupe_session/column_selector"
+
+class CrossCsvDedupeColumnSelectorTest < Minitest::Test
+  def test_builds_header_selector_from_input
+    selector = Csvtool::Domain::CrossCsvDedupeSession::ColumnSelector.from_input(headers_present: true, input: "customer_id")
+
+    assert_equal "customer_id", selector.value
+    assert_equal true, selector.headers_present?
+  end
+
+  def test_builds_index_selector_from_input
+    selector = Csvtool::Domain::CrossCsvDedupeSession::ColumnSelector.from_input(headers_present: false, input: "2")
+
+    assert_equal 2, selector.value
+    assert_equal true, selector.index?
+  end
+
+  def test_rejects_invalid_index_input
+    error = assert_raises(ArgumentError) do
+      Csvtool::Domain::CrossCsvDedupeSession::ColumnSelector.from_input(headers_present: false, input: "0")
+    end
+
+    assert_equal "column index must be a positive integer", error.message
+  end
+
+  def test_extracts_from_headered_row
+    selector = Csvtool::Domain::CrossCsvDedupeSession::ColumnSelector.from_input(headers_present: true, input: "customer_id")
+    row = { "customer_id" => "42" }
+
+    assert_equal "42", selector.extract_from(row)
+  end
+
+  def test_extracts_from_headerless_row_by_index
+    selector = Csvtool::Domain::CrossCsvDedupeSession::ColumnSelector.from_input(headers_present: false, input: "2")
+    row = ["a", "b", "c"]
+
+    assert_equal "b", selector.extract_from(row)
+  end
+end

data/test/csvtool/domain/cross_csv_dedupe_session/cross_csv_dedupe_session_test.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require_relative "../../../test_helper"
+require "csvtool/domain/cross_csv_dedupe_session/cross_csv_dedupe_session"
+require "csvtool/domain/cross_csv_dedupe_session/csv_profile"
+require "csvtool/domain/cross_csv_dedupe_session/column_selector"
+require "csvtool/domain/cross_csv_dedupe_session/key_mapping"
+require "csvtool/domain/cross_csv_dedupe_session/match_options"
+require "csvtool/domain/shared/output_destination"
+
+class CrossCsvDedupeSessionTest < Minitest::Test
+  def test_start_and_with_output_destination
+    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
+    )
+    key_mapping = Csvtool::Domain::CrossCsvDedupeSession::KeyMapping.new(
+      source_selector: Csvtool::Domain::CrossCsvDedupeSession::ColumnSelector.from_input(headers_present: true, input: "source_id"),
+      reference_selector: Csvtool::Domain::CrossCsvDedupeSession::ColumnSelector.from_input(headers_present: true, input: "reference_id")
+    )
+    match_options = Csvtool::Domain::CrossCsvDedupeSession::MatchOptions.new(
+      trim_whitespace: true,
+      case_insensitive: false
+    )
+
+    session = Csvtool::Domain::CrossCsvDedupeSession::CrossCsvDedupeSession.start(
+      source: source,
+      reference: reference,
+      key_mapping: key_mapping,
+      match_options: match_options
+    )
+
+    destination = Csvtool::Domain::Shared::OutputDestination.console
+    updated = session.with_output_destination(destination)
+
+    assert_equal source, updated.source
+    assert_equal reference, updated.reference
+    assert_equal key_mapping, updated.key_mapping
+    assert_equal match_options, updated.match_options
+    assert_equal destination, updated.output_destination
+  end
+
+  def test_rejects_invalid_source_type
+    reference = Csvtool::Domain::CrossCsvDedupeSession::CsvProfile.new(
+      path: "/tmp/reference.csv",
+      separator: ",",
+      headers_present: true
+    )
+    key_mapping = Csvtool::Domain::CrossCsvDedupeSession::KeyMapping.new(
+      source_selector: Csvtool::Domain::CrossCsvDedupeSession::ColumnSelector.from_input(headers_present: true, input: "source_id"),
+      reference_selector: Csvtool::Domain::CrossCsvDedupeSession::ColumnSelector.from_input(headers_present: true, input: "reference_id")
+    )
+    match_options = Csvtool::Domain::CrossCsvDedupeSession::MatchOptions.new(
+      trim_whitespace: true,
+      case_insensitive: false
+    )
+
+    error = assert_raises(ArgumentError) do
+      Csvtool::Domain::CrossCsvDedupeSession::CrossCsvDedupeSession.start(
+        source: "bad",
+        reference: reference,
+        key_mapping: key_mapping,
+        match_options: match_options
+      )
+    end
+
+    assert_equal "source must be CsvProfile", error.message
+  end
+end

data/test/csvtool/domain/cross_csv_dedupe_session/csv_profile_test.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative "../../../test_helper"
+require "csvtool/domain/cross_csv_dedupe_session/csv_profile"
+
+class CrossCsvDedupeCsvProfileTest < Minitest::Test
+  def test_initializes_with_expected_fields
+    profile = Csvtool::Domain::CrossCsvDedupeSession::CsvProfile.new(
+      path: "/tmp/source.csv",
+      separator: ",",
+      headers_present: true
+    )
+
+    assert_equal "/tmp/source.csv", profile.path
+    assert_equal ",", profile.separator
+    assert_equal true, profile.headers_present?
+  end
+
+  def test_requires_path
+    error = assert_raises(ArgumentError) do
+      Csvtool::Domain::CrossCsvDedupeSession::CsvProfile.new(path: "", separator: ",", headers_present: true)
+    end
+
+    assert_equal "path cannot be empty", error.message
+  end
+end

data/test/csvtool/domain/cross_csv_dedupe_session/key_mapping_test.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require_relative "../../../test_helper"
+require "csvtool/domain/cross_csv_dedupe_session/key_mapping"
+require "csvtool/domain/cross_csv_dedupe_session/column_selector"
+
+class CrossCsvDedupeKeyMappingTest < Minitest::Test
+  def test_holds_source_and_reference_selectors
+    source_selector = Csvtool::Domain::CrossCsvDedupeSession::ColumnSelector.from_input(headers_present: true, input: "source_id")
+    reference_selector = Csvtool::Domain::CrossCsvDedupeSession::ColumnSelector.from_input(headers_present: true, input: "ref_id")
+
+    mapping = Csvtool::Domain::CrossCsvDedupeSession::KeyMapping.new(
+      source_selector: source_selector,
+      reference_selector: reference_selector
+    )
+
+    assert_equal source_selector, mapping.source_selector
+    assert_equal reference_selector, mapping.reference_selector
+  end
+
+  def test_rejects_non_selector_inputs
+    error = assert_raises(ArgumentError) do
+      Csvtool::Domain::CrossCsvDedupeSession::KeyMapping.new(
+        source_selector: "id",
+        reference_selector: "external_id"
+      )
+    end
+
+    assert_equal "selectors must be ColumnSelector", error.message
+  end
+end

data/test/csvtool/domain/cross_csv_dedupe_session/match_options_test.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require_relative "../../../test_helper"
+require "csvtool/domain/cross_csv_dedupe_session/match_options"
+
+class CrossCsvDedupeMatchOptionsTest < Minitest::Test
+  def test_predicates_return_boolean_flags
+    options = Csvtool::Domain::CrossCsvDedupeSession::MatchOptions.new(
+      trim_whitespace: true,
+      case_insensitive: false
+    )
+
+    assert_equal true, options.trim_whitespace?
+    assert_equal false, options.case_insensitive?
+  end
+
+  def test_normalize_trim_on_case_off
+    options = Csvtool::Domain::CrossCsvDedupeSession::MatchOptions.new(
+      trim_whitespace: true,
+      case_insensitive: false
+    )
+
+    assert_equal "AbC", options.normalize(" AbC ")
+  end
+
+  def test_normalize_trim_on_case_on
+    options = Csvtool::Domain::CrossCsvDedupeSession::MatchOptions.new(
+      trim_whitespace: true,
+      case_insensitive: true
+    )
+
+    assert_equal "abc", options.normalize(" AbC ")
+  end
+
+  def test_normalize_trim_off_case_on
+    options = Csvtool::Domain::CrossCsvDedupeSession::MatchOptions.new(
+      trim_whitespace: false,
+      case_insensitive: true
+    )
+
+    assert_equal " abc ", options.normalize(" AbC ")
+  end
+
+  def test_normalize_trim_off_case_off
+    options = Csvtool::Domain::CrossCsvDedupeSession::MatchOptions.new(
+      trim_whitespace: false,
+      case_insensitive: false
+    )
+
+    assert_equal " AbC ", options.normalize(" AbC ")
+  end
+end

data/test/csvtool/domain/row_randomization_session/randomization_options_test.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require_relative "../../../test_helper"
+require "csvtool/domain/row_randomization_session/randomization_options"
+
+class RandomizationOptionsTest < Minitest::Test
+  def test_accepts_nil_or_integer_seed
+    with_seed = Csvtool::Domain::RowRandomizationSession::RandomizationOptions.new(seed: 42)
+    without_seed = Csvtool::Domain::RowRandomizationSession::RandomizationOptions.new(seed: nil)
+
+    assert_equal 42, with_seed.seed
+    assert_nil without_seed.seed
+  end
+
+  def test_rejects_non_integer_seed
+    assert_raises(ArgumentError) do
+      Csvtool::Domain::RowRandomizationSession::RandomizationOptions.new(seed: "abc")
+    end
+  end
+end

data/test/csvtool/domain/row_randomization_session/randomization_session_test.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative "../../../test_helper"
+require "csvtool/domain/row_randomization_session/randomization_session"
+require "csvtool/domain/row_randomization_session/randomization_source"
+require "csvtool/domain/row_randomization_session/randomization_options"
+require "csvtool/domain/shared/output_destination"
+
+class RandomizationSessionTest < Minitest::Test
+  def test_with_output_destination_returns_updated_session
+    source = Csvtool::Domain::RowRandomizationSession::RandomizationSource.new(
+      path: "/tmp/in.csv",
+      separator: ",",
+      headers_present: true
+    )
+    options = Csvtool::Domain::RowRandomizationSession::RandomizationOptions.new(seed: 7)
+    session = Csvtool::Domain::RowRandomizationSession::RandomizationSession.start(source: source, options: options)
+    destination = Csvtool::Domain::Shared::OutputDestination.console
+
+    updated = session.with_output_destination(destination)
+
+    assert_equal source, updated.source
+    assert_equal options, updated.options
+    assert_equal destination, updated.output_destination
+  end
+end