csvops 0.6.0.alpha → 0.8.0.alpha

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7db22cb84c1d08c58b473368f9ad37575a217d6293539309277ed2b032a2852
-  data.tar.gz: 124bebc822fefa5d1f71286701959876260c82164067c36ff94b712a0b4cc1b3
+  metadata.gz: 7c09a1df68b5bbb8885b254bd7ea1260617495fc042cae43ef7251d9eb66836e
+  data.tar.gz: a5fbf5098df8007e844c83134a5474f92eafe4866b4d9910519d9a1517675af9
 SHA512:
-  metadata.gz: a8b8dbcfb66073f46f0ecc625267081fbe730e69ef9295f5d2303af6b831a9d71ef564f78f5b44212eb33c4ad7a5fdb78b54fa98e21dd58669e9494a5d3325fb
-  data.tar.gz: 05cbcaa2ca3116ad463413e53600d32a53df0941ceb8873ed22c2ef2d4cfe1afc8f90e44c7ff4400212ebbd5083a2ceb6a983281291436e9478d5087cc98b9ad
+  metadata.gz: 3695b9d49a638138d03d69122267a2889ecb6bd33605e9a256a20480ccab869c858f8f08996a213a885c2fb9a08e740712bb1dcc38fef6734d10129b20b3d611
+  data.tar.gz: df4cf19d31ac3c317ae69552cd3181c48984295268880810adf0d7b46bb606a2fa92646c35c4b1cd3343c04c5d08c734efb6b53b08f44fb3259b3dc3cbaf4509

data/README.md

@@ -38,29 +38,26 @@ CSV Tool Menu
 3. Randomize rows
 4. Dedupe using another CSV
 5. Validate parity
-6. Exit
+6. Split CSV into chunks
+7. CSV stats summary
+8. Exit
 >
 ```
 
-Select `1` for column extraction, `2` for row-range extraction, `3` for row randomization, `4` for cross-CSV dedupe, or `5` for parity validation.
+Select `1` for column extraction, `2` for row-range extraction, `3` for row randomization, `4` for cross-CSV dedupe, `5` for parity validation, `6` for CSV splitting, or `7` for CSV stats.
 
 ### 3. Follow prompts
 
-Each menu action runs through a dedicated CLI workflow (`interface/cli/workflows/*`) that handles prompts/output and delegates execution to an interface-agnostic application use case.
+Each action asks only for what it needs (file path, separator, and any action-specific options), then prints results to the console or writes to a file when selected.
 
-Workflow internals are split into small composable parts:
+Typical prompt pattern:
 
-- `workflows/builders/*` for session construction
-- `workflows/support/*` for shared mapping/dispatch utilities
-- `workflows/presenters/*` for output formatting and summaries
+- choose source file(s)
+- choose separator/header options when relevant
+- choose action-specific options
+- choose output destination (console or file)
 
-Prompt flow by action:
-
-- `Extract column`: file path, separator, optional header filter + column select, skip blanks, preview/confirm, output destination.
-- `Extract rows (range)`: file path, separator, start row, end row, output destination.
-- `Randomize rows`: file path, separator, headers present, optional seed, output destination.
-- `Dedupe using another CSV`: source/reference files, separators, header modes, key selectors, match options, output destination.
-- `Validate parity`: left/right files, separator, header mode, parity summary, mismatch samples.
+For architecture and internal design details, see [`docs/architecture.md`](docs/architecture.md).
 
 ### 4. Example interaction (console output)
 
@@ -129,10 +126,12 @@ Legend: ` ` = prompt/menu, `+` = user input, `-` = tool output
  CSV Tool Menu
  1. Extract column
  2. Extract rows (range)
- 3. Randomize rows
- 4. Dedupe using another CSV
- 5. Validate parity
- 6. Exit
+3. Randomize rows
+4. Dedupe using another CSV
+5. Validate parity
+6. Split CSV into chunks
+ 7. CSV stats summary
+ 8. Exit
 +> 4
  CSV file path: /tmp/source.csv
  Source CSV separator:
@@ -177,10 +176,12 @@ Legend: ` ` = prompt/menu, `+` = user input, `-` = tool output
  CSV Tool Menu
  1. Extract column
  2. Extract rows (range)
- 3. Randomize rows
- 4. Dedupe using another CSV
- 5. Validate parity
- 6. Exit
+3. Randomize rows
+4. Dedupe using another CSV
+5. Validate parity
+ 6. Split CSV into chunks
+ 7. CSV stats summary
+ 8. Exit
 +> 5
  Left CSV file path: /tmp/left.csv
  Right CSV file path: /tmp/right.csv
@@ -208,6 +209,84 @@ Legend: ` ` = prompt/menu, `+` = user input, `-` = tool output
 - Exact duplicate semantics are preserved by count deltas per normalized row value.
 - Memory scales with the number of distinct row keys in the parity map, not the total input row count.
 
+### 10. Split interaction example
+
+Legend: ` ` = prompt/menu, `+` = user input, `-` = tool output
+
+```diff
+ CSV Tool Menu
+ 1. Extract column
+ 2. Extract rows (range)
+ 3. Randomize rows
+ 4. Dedupe using another CSV
+ 5. Validate parity
+ 6. Split CSV into chunks
+ 7. CSV stats summary
+ 8. Exit
++> 6
+ Source CSV file path: /tmp/people.csv
+ Choose separator:
+ 1. comma (,)
+ 2. tab (\t)
+ 3. semicolon (;)
+ 4. pipe (|)
+ 5. custom
++Separator choice [1]: 1
+ Headers present? [Y/n]:
++Rows per chunk: 1000
+ Output directory [/tmp]:
+ Output file prefix [people]:
+ Overwrite existing chunk files? [y/N]:
+ Write manifest file? [y/N]:
+-Split complete.
+-Chunk size: 1000
+-Data rows: 25000
+-Chunks written: 25
+-/tmp/people_part_001.csv
+```
+
+### 11. CSV stats interaction example
+
+Legend: ` ` = prompt/menu, `+` = user input, `-` = tool output
+
+```diff
+ CSV Tool Menu
+ 1. Extract column
+ 2. Extract rows (range)
+ 3. Randomize rows
+ 4. Dedupe using another CSV
+ 5. Validate parity
+ 6. Split CSV into chunks
+ 7. CSV stats summary
+ 8. Exit
++> 7
+ CSV file path: /tmp/people.csv
+ Choose separator:
+ 1. comma (,)
+ 2. tab (\t)
+ 3. semicolon (;)
+ 4. pipe (|)
+ 5. custom
++Separator choice [1]: 1
+ Headers present? [Y/n]:
+ Output destination:
+ 1. console
+ 2. file
++Output destination [1]: 1
+-CSV Stats Summary
+-Rows: 3
+-Columns: 2
+-Headers: name, city
+-Column completeness:
+-  name: non_blank=3 blank=0
+-  city: non_blank=3 blank=0
+```
+
+### 12. CSV stats large-file behavior
+
+- Stats scanning is streaming (`CSV.foreach`), processed in one pass.
+- Memory grows with per-column aggregates (`column_stats`), not with total row count.
+
 ## Testing
 
 Run tests:
@@ -224,7 +303,7 @@ bundle exec rake test
 
 ## Alpha release
 
-Current prerelease version: `0.5.0.alpha`
+Current prerelease version: `0.8.0.alpha`
 
 Install prerelease from RubyGems:
 
@@ -234,7 +313,7 @@ gem install csvops --pre
 
 Release runbook:
 
-- `docs/release-v0.5.0-alpha.md`
+- `docs/release-v0.8.0-alpha.md`
 
 
 ## Architecture

data/docs/architecture.md

@@ -2,15 +2,15 @@
 
 The codebase follows a DDD-lite layered structure:
 
-- `domain/`: core domain models and invariants (`ColumnSession`, `RowSession`, `RandomizationSession`, and `CrossCsvDedupeSession` aggregates + supporting entities/value objects).
-- `application/`: use-case orchestration (`RunExtraction`, `RunRowExtraction`, `RunRowRandomization`, `RunCrossCsvDedupe`, `RunCsvParity`).
+- `domain/`: core domain models and invariants (`ColumnSession`, `RowSession`, `RandomizationSession`, `CrossCsvDedupeSession`, `ParitySession`, `SplitSession`, and `CsvStatsSession` aggregates + supporting entities/value objects).
+- `application/`: use-case orchestration (`RunExtraction`, `RunRowExtraction`, `RunRowRandomization`, `RunCrossCsvDedupe`, `RunCsvParity`, `RunCsvSplit`, `RunCsvStats`).
 - `infrastructure/`: CSV reading/streaming/comparison and output adapters (console/file).
 - `interface/cli/`: menu, prompts, workflows, and user-facing error presentation.
 - `Csvtool::CLI`: entrypoint wiring from command args to interface/application flow.
 
 ## Workflow boundary (standardized)
 
-For all interactive domains (`Column Extraction`, `Row Extraction`, `Row Randomization`, `Cross-CSV Dedupe`, `CSV Parity`), the boundary is:
+For all interactive domains (`Column Extraction`, `Row Extraction`, `Row Randomization`, `Cross-CSV Dedupe`, `CSV Parity`, `CSV Split`, `CSV Stats`), the boundary is:
 
 - `interface/cli/workflows/*`: owns prompts, stdout rendering, and user-facing error presentation.
 - `interface/cli/workflows/builders/*`: builds domain sessions/aggregates from prompt results.
@@ -33,6 +33,8 @@ Current usage:
 - `RunRowRandomizationWorkflow` uses `WorkflowStepPipeline` + `Steps::RowRandomization::*`.
 - `RunCrossCsvDedupeWorkflow` uses `WorkflowStepPipeline` + `Steps::CrossCsvDedupe::*`.
 - `RunCsvParityWorkflow` uses `WorkflowStepPipeline` + `Steps::Parity::*`.
+- `RunCsvSplitWorkflow` uses `WorkflowStepPipeline` + `Steps::CsvSplit::*`.
+- `RunCsvStatsWorkflow` uses `WorkflowStepPipeline` + `Steps::CsvStats::*`.
 
 ## Adding New Concepts
 
@@ -108,7 +110,7 @@ For a new function type, prefer one of these patterns:
 
 ## Domain model
 
-Bounded contexts: `Column Extraction`, `Row Extraction`, `Row Randomization`, `Cross-CSV Dedupe`, and `CSV Parity`.
+Bounded contexts: `Column Extraction`, `Row Extraction`, `Row Randomization`, `Cross-CSV Dedupe`, `CSV Parity`, `CSV Split`, and `CSV Stats`.
 
 ### Cross-CSV Dedupe (Large-file behavior)
 
@@ -421,6 +423,117 @@ classDiagram
   RunCsvParity --> CsvParityComparator
 ```
 
+### CSV Split
+
+Core DDD structure:
+
+- Aggregate root: `SplitSession`
+  - Captures one CSV split request.
+  - Holds split source and split options.
+- Entities:
+  - `SplitSource` (path + separator + header mode)
+- Value objects:
+  - `SplitOptions` (chunk size, output directory, file prefix, overwrite policy, optional manifest configuration)
+- Application service:
+  - `Application::UseCases::RunCsvSplit` orchestrates split execution and returns request/result style payloads.
+- Infrastructure adapters:
+  - `Infrastructure::CSV::CsvSplitter` (streaming row-by-row chunk writer)
+  - `Infrastructure::Output::CsvSplitManifestWriter` (optional manifest output)
+- Interface adapters:
+  - `Interface::CLI::MenuLoop`
+  - `Interface::CLI::Workflows::RunCsvSplitWorkflow`
+  - `Interface::CLI::Workflows::Builders::CsvSplitSessionBuilder`
+  - `Interface::CLI::Workflows::Steps::WorkflowStepPipeline`
+  - `Interface::CLI::Workflows::Steps::CsvSplit::*`
+  - `Interface::CLI::Workflows::Presenters::CsvSplitPresenter`
+  - `Interface::CLI::Workflows::Support::ResultErrorHandler`
+  - `Interface::CLI::Prompts::*`
+  - `Interface::CLI::Errors::Presenter`
+
+```mermaid
+classDiagram
+  direction LR
+  class MenuLoop
+  class RunCsvSplitWorkflow
+  class Prompts
+  class Errors
+  class RunCsvSplit
+  class SplitSession
+  class SplitSource
+  class SplitOptions
+  class CsvSplitter
+  class CsvSplitManifestWriter
+  class CsvSplitPresenter
+
+  MenuLoop --> RunCsvSplitWorkflow : invokes
+  RunCsvSplitWorkflow --> Prompts : uses
+  RunCsvSplitWorkflow --> Errors : reports failures
+  RunCsvSplitWorkflow --> CsvSplitPresenter : renders
+  RunCsvSplitWorkflow --> RunCsvSplit : calls
+  RunCsvSplit --> SplitSession : orchestrates
+  SplitSession o-- SplitSource
+  SplitSession o-- SplitOptions
+  RunCsvSplit --> CsvSplitter
+  RunCsvSplit --> CsvSplitManifestWriter
+```
+
+### CSV Stats
+
+Core DDD structure:
+
+- Aggregate root: `StatsSession`
+  - Captures one stats summary request.
+  - Holds source profile and output destination.
+- Entity:
+  - `StatsSource` (path + separator + header mode)
+- Value objects:
+  - `StatsOptions` (currently lightweight; keeps option growth explicit)
+  - Shared `OutputDestination` (`console` or `file(path)`)
+- Application service:
+  - `Application::UseCases::RunCsvStats` orchestrates stats scanning and output routing.
+- Infrastructure adapters:
+  - `Infrastructure::CSV::CsvStatsScanner` (streaming one-pass row aggregation)
+  - `Infrastructure::Output::CsvStatsFileWriter` (metric/value artifact writer)
+- Interface adapters:
+  - `Interface::CLI::MenuLoop`
+  - `Interface::CLI::Workflows::RunCsvStatsWorkflow`
+  - `Interface::CLI::Workflows::Builders::CsvStatsSessionBuilder`
+  - `Interface::CLI::Workflows::Steps::WorkflowStepPipeline`
+  - `Interface::CLI::Workflows::Steps::CsvStats::*`
+  - `Interface::CLI::Workflows::Presenters::CsvStatsPresenter`
+  - `Interface::CLI::Workflows::Support::{OutputDestinationMapper,ResultErrorHandler}`
+  - `Interface::CLI::Prompts::*`
+  - `Interface::CLI::Errors::Presenter`
+
+```mermaid
+classDiagram
+  direction LR
+  class MenuLoop
+  class RunCsvStatsWorkflow
+  class Prompts
+  class Errors
+  class RunCsvStats
+  class StatsSession
+  class StatsSource
+  class StatsOptions
+  class OutputDestination
+  class CsvStatsScanner
+  class CsvStatsFileWriter
+  class CsvStatsPresenter
+
+  MenuLoop --> RunCsvStatsWorkflow : invokes
+  RunCsvStatsWorkflow --> Prompts : uses
+  RunCsvStatsWorkflow --> Errors : reports failures
+  RunCsvStatsWorkflow --> CsvStatsPresenter : renders
+  RunCsvStatsWorkflow --> RunCsvStats : calls
+  RunCsvStats --> StatsSession : orchestrates
+  StatsSession o-- StatsSource
+  StatsSession o-- StatsOptions
+  StatsSession o-- OutputDestination
+  RunCsvStats --> CsvStatsScanner
+  RunCsvStats --> CsvStatsFileWriter
+```
+
 ## Project layout
 
 ```text
@@ -431,12 +544,16 @@ lib/csvtool/domain/row_session/*
 lib/csvtool/domain/row_randomization_session/*
 lib/csvtool/domain/cross_csv_dedupe_session/*
 lib/csvtool/domain/csv_parity_session/*
+lib/csvtool/domain/csv_split_session/*
+lib/csvtool/domain/csv_stats_session/*
 lib/csvtool/domain/shared/output_destination.rb
 lib/csvtool/application/use_cases/run_extraction.rb
 lib/csvtool/application/use_cases/run_row_extraction.rb
 lib/csvtool/application/use_cases/run_row_randomization.rb
 lib/csvtool/application/use_cases/run_cross_csv_dedupe.rb
 lib/csvtool/application/use_cases/run_csv_parity.rb
+lib/csvtool/application/use_cases/run_csv_split.rb
+lib/csvtool/application/use_cases/run_csv_stats.rb
 lib/csvtool/infrastructure/csv/*
 lib/csvtool/infrastructure/output/*
 lib/csvtool/interface/cli/menu_loop.rb

data/docs/release-v0.7.0-alpha.md

@@ -0,0 +1,87 @@
+# Release Checklist: v0.7.0-alpha
+
+## 1. Verify environment
+
+```bash
+ruby -v
+bundle -v
+```
+
+Expected:
+- Ruby `3.3.x`
+
+## 2. Install dependencies
+
+```bash
+bundle install
+```
+
+## 3. Run quality checks
+
+```bash
+bundle exec rake test
+```
+
+## 4. Smoke test CLI commands
+
+```bash
+bundle exec csvtool menu
+bundle exec csvtool column test/fixtures/sample_people.csv name
+```
+
+## 5. Smoke test workflows
+
+### CSV split workflow (new in this release)
+
+Use menu option `6` (`Split CSV into chunks`) and verify:
+- happy path split (`N=10`) writes expected chunk files and counts
+- separator and header mode options work (CSV/TSV/headerless/custom)
+- output directory + file prefix options produce expected paths
+- overwrite protection blocks existing chunk paths unless allowed
+- optional manifest output writes valid CSV metadata
+
+### Existing workflows regression pass
+
+Use menu options `1-5` and verify:
+- column extraction still works
+- row-range extraction still works
+- row randomization still works
+- cross-CSV dedupe still works
+- parity validation still works
+
+## 6. Build and validate gem package
+
+```bash
+gem build csvops.gemspec
+gem install ./csvops-0.7.0.alpha.gem
+csvtool menu
+```
+
+## 7. Commit release prep
+
+```bash
+git add -A
+git commit -m "chore(release): prepare v0.7.0-alpha"
+```
+
+## 8. Tag release
+
+```bash
+git tag -a v0.7.0-alpha -m "v0.7.0-alpha"
+git push origin main --tags
+```
+
+## 9. Publish gem
+
+```bash
+gem push csvops-0.7.0.alpha.gem
+```
+
+## 10. Create GitHub release
+
+Create release `v0.7.0-alpha` with:
+- New `Split CSV into chunks` workflow
+- Split-domain architecture (workflow steps, builder, presenter, use case, infrastructure adapters)
+- Output strategy improvements (directory/prefix/overwrite controls)
+- Optional split manifest output
+- Large-file streaming split coverage and docs updates

data/docs/release-v0.8.0-alpha.md

@@ -0,0 +1,88 @@
+# Release Checklist: v0.8.0-alpha
+
+## 1. Verify environment
+
+```bash
+ruby -v
+bundle -v
+```
+
+Expected:
+- Ruby `3.3.x`
+
+## 2. Install dependencies
+
+```bash
+bundle install
+```
+
+## 3. Run quality checks
+
+```bash
+bundle exec rake test
+```
+
+## 4. Smoke test CLI commands
+
+```bash
+bundle exec csvtool menu
+bundle exec csvtool column test/fixtures/sample_people.csv name
+```
+
+## 5. Smoke test workflows
+
+### CSV stats workflow (new in this release)
+
+Use menu option `7` (`CSV stats summary`) and verify:
+- happy path summary prints rows/columns/headers
+- separator and header mode options work (CSV/TSV/headerless/custom)
+- column completeness output is correct for blanks
+- output destination supports console and file
+- invalid output path returns friendly error
+
+### Existing workflows regression pass
+
+Use menu options `1-6` and verify:
+- column extraction still works
+- row-range extraction still works
+- row randomization still works
+- cross-CSV dedupe still works
+- parity validation still works
+- CSV split still works
+
+## 6. Build and validate gem package
+
+```bash
+gem build csvops.gemspec
+gem install ./csvops-0.8.0.alpha.gem
+csvtool menu
+```
+
+## 7. Commit release prep
+
+```bash
+git add -A
+git commit -m "chore(release): prepare v0.8.0-alpha"
+```
+
+## 8. Tag release
+
+```bash
+git tag -a v0.8.0-alpha -m "v0.8.0-alpha"
+git push origin main --tags
+```
+
+## 9. Publish gem
+
+```bash
+gem push csvops-0.8.0.alpha.gem
+```
+
+## 10. Create GitHub release
+
+Create release `v0.8.0-alpha` with:
+- New `CSV stats summary` workflow
+- Stats-domain architecture (workflow steps, builder, presenter, use case, infrastructure adapters)
+- Console/file output destination support for stats summary artifacts
+- Streaming stats scanner coverage for large files
+- Stats documentation updates in README + architecture guide

data/lib/csvtool/application/use_cases/run_csv_split.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+require "csv"
+require "fileutils"
+require "csvtool/infrastructure/csv/header_reader"
+require "csvtool/infrastructure/csv/csv_splitter"
+require "csvtool/infrastructure/output/csv_split_manifest_writer"
+
+module Csvtool
+  module Application
+    module UseCases
+      class RunCsvSplit
+        Result = Struct.new(:ok, :error, :data, keyword_init: true) do
+          def ok?
+            ok
+          end
+        end
+
+        def initialize(
+          header_reader: Infrastructure::CSV::HeaderReader.new,
+          csv_splitter: Infrastructure::CSV::CsvSplitter.new,
+          csv_split_manifest_writer: Infrastructure::Output::CsvSplitManifestWriter.new
+        )
+          @header_reader = header_reader
+          @csv_splitter = csv_splitter
+          @csv_split_manifest_writer = csv_split_manifest_writer
+        end
+
+        def read_headers(file_path:, col_sep:, headers_present:)
+          return failure(:file_not_found, path: file_path) unless File.file?(file_path)
+          return success(headers: nil) unless headers_present
+
+          headers = @header_reader.call(file_path: file_path, col_sep: col_sep)
+          return failure(:no_headers) if headers.empty?
+
+          success(headers: headers)
+        rescue CSV::MalformedCSVError
+          failure(:could_not_parse_csv)
+        rescue Errno::EACCES
+          failure(:cannot_read_file, path: file_path)
+        end
+
+        def call(session:)
+          source = session.source
+          output_directory = session.options.output_directory || File.dirname(source.path)
+          file_prefix = session.options.file_prefix || File.basename(source.path, ".*")
+          FileUtils.mkdir_p(output_directory)
+
+          stats = @csv_splitter.call(
+            file_path: source.path,
+            col_sep: source.separator,
+            headers_present: source.headers_present,
+            chunk_size: session.options.chunk_size,
+            output_directory: output_directory,
+            file_prefix: file_prefix,
+            overwrite_existing: session.options.overwrite_existing
+          )
+          manifest_path = maybe_write_manifest(
+            session: session,
+            output_directory: output_directory,
+            file_prefix: file_prefix,
+            stats: stats
+          )
+          success(stats.merge(output_directory: output_directory, file_prefix: file_prefix, manifest_path: manifest_path))
+        rescue Infrastructure::CSV::CsvSplitter::OutputFileExistsError => e
+          failure(:output_file_exists, path: e.path)
+        rescue CSV::MalformedCSVError
+          failure(:could_not_parse_csv)
+        rescue Errno::EACCES, Errno::ENOENT => e
+          failure(:cannot_write_output_file, path: output_directory, error_class: e.class)
+        end
+
+        private
+
+        def success(data)
+          Result.new(ok: true, error: nil, data: data)
+        end
+
+        def failure(code, data = {})
+          Result.new(ok: false, error: code, data: data)
+        end
+
+        def maybe_write_manifest(session:, output_directory:, file_prefix:, stats:)
+          return nil unless session.options.write_manifest
+
+          manifest_path = session.options.manifest_path || File.join(output_directory, "#{file_prefix}_manifest.csv")
+          @csv_split_manifest_writer.call(
+            path: manifest_path,
+            chunk_paths: stats[:chunk_paths],
+            chunk_row_counts: stats[:chunk_row_counts]
+          )
+          manifest_path
+        end
+      end
+    end
+  end
+end

data/lib/csvtool/application/use_cases/run_csv_stats.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require "csv"
+require "csvtool/infrastructure/csv/csv_stats_scanner"
+require "csvtool/infrastructure/output/csv_stats_file_writer"
+
+module Csvtool
+  module Application
+    module UseCases
+      class RunCsvStats
+        Result = Struct.new(:ok, :error, :data, keyword_init: true) do
+          def ok?
+            ok
+          end
+        end
+
+        def initialize(
+          scanner: Infrastructure::CSV::CsvStatsScanner.new,
+          csv_stats_file_writer: Infrastructure::Output::CsvStatsFileWriter.new
+        )
+          @scanner = scanner
+          @csv_stats_file_writer = csv_stats_file_writer
+        end
+
+        def call(session:)
+          path = session.source.path
+          return failure(:file_not_found, path: path) unless File.file?(path)
+
+          stats = @scanner.call(
+            file_path: path,
+            col_sep: session.source.separator,
+            headers_present: session.source.headers_present
+          )
+          if session.output_destination&.file?
+            @csv_stats_file_writer.call(path: session.output_destination.path, data: stats)
+            return success(stats.merge(output_path: session.output_destination.path))
+          end
+          success(stats)
+        rescue CSV::MalformedCSVError
+          failure(:could_not_parse_csv)
+        rescue Errno::EACCES => e
+          if session.output_destination&.file?
+            return failure(:cannot_write_output_file, path: session.output_destination.path, error_class: e.class)
+          end
+          failure(:cannot_read_file, path: path)
+        rescue Errno::ENOENT => e
+          return failure(:cannot_write_output_file, path: session.output_destination.path, error_class: e.class) if session.output_destination&.file?
+
+          failure(:cannot_read_file, path: path)
+        end
+
+        private
+
+        def success(data)
+          Result.new(ok: true, error: nil, data: data)
+        end
+
+        def failure(code, data = {})
+          Result.new(ok: false, error: code, data: data)
+        end
+      end
+    end
+  end
+end