csvops 0.7.0.alpha → 0.8.0.alpha

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 803fa825ef1f50edcd7c0bc032a86926d356cb3ba6d943c460d59759a953fdcd
-  data.tar.gz: 2ba2afc9951aa96e777cbf3ea81dc77a41c88d2546505c885302607432461633
+  metadata.gz: 7c09a1df68b5bbb8885b254bd7ea1260617495fc042cae43ef7251d9eb66836e
+  data.tar.gz: a5fbf5098df8007e844c83134a5474f92eafe4866b4d9910519d9a1517675af9
 SHA512:
-  metadata.gz: 4f82dd7e9d3ac5ff53f8aaf40a0e5500e9b074aa052a031f6de4f5a2cc1ab711a5c375d5c203bdfaae802d36a02ecf14c4f73231a9f14e31d2f042ffeecd9a08
-  data.tar.gz: f9428d2ef29d257c99b484c7277dcff566dd5cf09ec06b78b4514c410b7858ffd6854f8aafd39a727c9c3d1e44e6940bc15456f3b11fdcac4a5b879bee9cc826
+  metadata.gz: 3695b9d49a638138d03d69122267a2889ecb6bd33605e9a256a20480ccab869c858f8f08996a213a885c2fb9a08e740712bb1dcc38fef6734d10129b20b3d611
+  data.tar.gz: df4cf19d31ac3c317ae69552cd3181c48984295268880810adf0d7b46bb606a2fa92646c35c4b1cd3343c04c5d08c734efb6b53b08f44fb3259b3dc3cbaf4509

data/README.md

@@ -39,30 +39,25 @@ CSV Tool Menu
 4. Dedupe using another CSV
 5. Validate parity
 6. Split CSV into chunks
-7. Exit
+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, `5` for parity validation, or `6` for CSV splitting.
+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.
-- `Split CSV into chunks`: source file, separator, header mode, chunk size, output directory/prefix, overwrite policy, optional manifest.
+For architecture and internal design details, see [`docs/architecture.md`](docs/architecture.md).
 
 ### 4. Example interaction (console output)
 
@@ -134,8 +129,9 @@ Legend: ` ` = prompt/menu, `+` = user input, `-` = tool output
 3. Randomize rows
 4. Dedupe using another CSV
 5. Validate parity
- 6. Split CSV into chunks
- 7. Exit
+6. Split CSV into chunks
+ 7. CSV stats summary
+ 8. Exit
 +> 4
  CSV file path: /tmp/source.csv
  Source CSV separator:
@@ -184,7 +180,8 @@ Legend: ` ` = prompt/menu, `+` = user input, `-` = tool output
 4. Dedupe using another CSV
 5. Validate parity
  6. Split CSV into chunks
- 7. Exit
+ 7. CSV stats summary
+ 8. Exit
 +> 5
  Left CSV file path: /tmp/left.csv
  Right CSV file path: /tmp/right.csv
@@ -224,7 +221,8 @@ Legend: ` ` = prompt/menu, `+` = user input, `-` = tool output
  4. Dedupe using another CSV
  5. Validate parity
  6. Split CSV into chunks
- 7. Exit
+ 7. CSV stats summary
+ 8. Exit
 +> 6
  Source CSV file path: /tmp/people.csv
  Choose separator:
@@ -247,6 +245,48 @@ Legend: ` ` = prompt/menu, `+` = user input, `-` = tool output
 -/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:
@@ -263,7 +303,7 @@ bundle exec rake test
 
 ## Alpha release
 
-Current prerelease version: `0.7.0.alpha`
+Current prerelease version: `0.8.0.alpha`
 
 Install prerelease from RubyGems:
 
@@ -273,7 +313,7 @@ gem install csvops --pre
 
 Release runbook:
 
-- `docs/release-v0.7.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`, `CrossCsvDedupeSession`, and `CsvSplitSession` aggregates + supporting entities/value objects).
-- `application/`: use-case orchestration (`RunExtraction`, `RunRowExtraction`, `RunRowRandomization`, `RunCrossCsvDedupe`, `RunCsvParity`, `RunCsvSplit`).
+- `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`, `CSV Split`), 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.
@@ -34,6 +34,7 @@ Current usage:
 - `RunCrossCsvDedupeWorkflow` uses `WorkflowStepPipeline` + `Steps::CrossCsvDedupe::*`.
 - `RunCsvParityWorkflow` uses `WorkflowStepPipeline` + `Steps::Parity::*`.
 - `RunCsvSplitWorkflow` uses `WorkflowStepPipeline` + `Steps::CsvSplit::*`.
+- `RunCsvStatsWorkflow` uses `WorkflowStepPipeline` + `Steps::CsvStats::*`.
 
 ## Adding New Concepts
 
@@ -109,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`, `CSV Parity`, and `CSV Split`.
+Bounded contexts: `Column Extraction`, `Row Extraction`, `Row Randomization`, `Cross-CSV Dedupe`, `CSV Parity`, `CSV Split`, and `CSV Stats`.
 
 ### Cross-CSV Dedupe (Large-file behavior)
 
@@ -476,6 +477,63 @@ classDiagram
   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
@@ -487,6 +545,7 @@ 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
@@ -494,6 +553,7 @@ 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.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_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

data/lib/csvtool/cli.rb

@@ -8,6 +8,7 @@ require "csvtool/interface/cli/workflows/run_row_randomization_workflow"
 require "csvtool/interface/cli/workflows/run_cross_csv_dedupe_workflow"
 require "csvtool/interface/cli/workflows/run_csv_parity_workflow"
 require "csvtool/interface/cli/workflows/run_csv_split_workflow"
+require "csvtool/interface/cli/workflows/run_csv_stats_workflow"
 require "csvtool/interface/cli/errors/presenter"
 require "csvtool/infrastructure/csv/header_reader"
 require "csvtool/infrastructure/csv/value_streamer"
@@ -22,6 +23,7 @@ module Csvtool
       "Dedupe using another CSV",
       "Validate parity",
       "Split CSV into chunks",
+      "CSV stats summary",
       "Exit"
     ].freeze
 
@@ -57,6 +59,7 @@ module Csvtool
       dedupe_action = -> { Interface::CLI::Workflows::RunCrossCsvDedupeWorkflow.new(stdin: @stdin, stdout: @stdout).call }
       parity_action = -> { Interface::CLI::Workflows::RunCsvParityWorkflow.new(stdin: @stdin, stdout: @stdout).call }
       split_action = -> { Interface::CLI::Workflows::RunCsvSplitWorkflow.new(stdin: @stdin, stdout: @stdout).call }
+      stats_action = -> { Interface::CLI::Workflows::RunCsvStatsWorkflow.new(stdin: @stdin, stdout: @stdout).call }
       Interface::CLI::MenuLoop.new(
         stdin: @stdin,
         stdout: @stdout,
@@ -66,7 +69,8 @@ module Csvtool
         randomize_rows_action: randomize_rows_action,
         dedupe_action: dedupe_action,
         parity_action: parity_action,
-        split_action: split_action
+        split_action: split_action,
+        stats_action: stats_action
       ).run
     end
 

data/lib/csvtool/domain/csv_stats_session/stats_options.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Csvtool
+  module Domain
+    module CsvStatsSession
+      class StatsOptions
+        def initialize; end
+      end
+    end
+  end
+end

data/lib/csvtool/domain/csv_stats_session/stats_session.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Csvtool
+  module Domain
+    module CsvStatsSession
+      class StatsSession
+        attr_reader :source, :options, :output_destination
+
+        def self.start(source:, options:)
+          new(source: source, options: options)
+        end
+
+        def initialize(source:, options:, output_destination: nil)
+          @source = source
+          @options = options
+          @output_destination = output_destination
+        end
+
+        def with_output_destination(output_destination)
+          self.class.new(source: source, options: options, output_destination: output_destination)
+        end
+      end
+    end
+  end
+end

data/lib/csvtool/domain/csv_stats_session/stats_source.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Csvtool
+  module Domain
+    module CsvStatsSession
+      class StatsSource
+        attr_reader :path, :separator, :headers_present
+
+        def initialize(path:, separator:, headers_present:)
+          @path = path
+          @separator = separator
+          @headers_present = headers_present
+        end
+      end
+    end
+  end
+end

data/lib/csvtool/infrastructure/csv/csv_stats_scanner.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require "csv"
+
+module Csvtool
+  module Infrastructure
+    module CSV
+      class CsvStatsScanner
+        def initialize(csv: ::CSV)
+          @csv = csv
+        end
+
+        def call(file_path:, col_sep:, headers_present:)
+          data_row_count = 0
+          headers = nil
+          column_count = 0
+          column_stats = []
+
+          # Streaming scan: memory grows with per-column metrics, not row count.
+          @csv.foreach(file_path, headers: headers_present, col_sep: col_sep) do |row|
+            if headers_present
+              headers ||= row.headers
+              column_count = headers.length
+              if column_stats.empty?
+                column_stats = headers.map { |name| { name: name, blank_count: 0, non_blank_count: 0 } }
+              end
+              fields = row.fields
+              fields.fill(nil, fields.length...column_count)
+              fields.each_with_index { |value, index| apply_value(column_stats[index], value) }
+              data_row_count += 1
+            else
+              fields = row.is_a?(::CSV::Row) ? row.fields : row
+              column_count = [column_count, fields.length].max
+              while column_stats.length < column_count
+                column_stats << {
+                  name: "column_#{column_stats.length + 1}",
+                  blank_count: 0,
+                  non_blank_count: 0
+                }
+              end
+              fields.fill(nil, fields.length...column_count)
+              fields.each_with_index { |value, index| apply_value(column_stats[index], value) }
+              data_row_count += 1
+            end
+          end
+
+          {
+            row_count: data_row_count,
+            column_count: column_count,
+            headers: headers,
+            column_stats: column_stats
+          }
+        end
+
+        private
+
+        def apply_value(stats, value)
+          if value.nil? || value.strip.empty?
+            stats[:blank_count] += 1
+          else
+            stats[:non_blank_count] += 1
+          end
+        end
+      end
+    end
+  end
+end

data/lib/csvtool/infrastructure/output/csv_stats_file_writer.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "csv"
+
+module Csvtool
+  module Infrastructure
+    module Output
+      class CsvStatsFileWriter
+        def call(path:, data:)
+          ::CSV.open(path, "w") do |csv|
+            csv << %w[metric value]
+            csv << ["row_count", data[:row_count]]
+            csv << ["column_count", data[:column_count]]
+            unless data[:headers].nil? || data[:headers].empty?
+              csv << ["headers", data[:headers].join("|")]
+            end
+            data.fetch(:column_stats, []).each do |stats|
+              csv << ["column.#{stats[:name]}.non_blank", stats[:non_blank_count]]
+              csv << ["column.#{stats[:name]}.blank", stats[:blank_count]]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/csvtool/interface/cli/menu_loop.rb

@@ -4,7 +4,7 @@ module Csvtool
   module Interface
     module CLI
       class MenuLoop
-        def initialize(stdin:, stdout:, menu_options:, extract_column_action:, extract_rows_action:, randomize_rows_action:, dedupe_action:, parity_action:, split_action:)
+        def initialize(stdin:, stdout:, menu_options:, extract_column_action:, extract_rows_action:, randomize_rows_action:, dedupe_action:, parity_action:, split_action:, stats_action:)
           @stdin = stdin
           @stdout = stdout
           @menu_options = menu_options
@@ -14,6 +14,7 @@ module Csvtool
           @dedupe_action = dedupe_action
           @parity_action = parity_action
           @split_action = split_action
+          @stats_action = stats_action
         end
 
         def run
@@ -37,9 +38,11 @@ module Csvtool
             when "6"
               @split_action.call
             when "7"
+              @stats_action.call
+            when "8"
               return 0
             else
-              @stdout.puts "Please choose 1, 2, 3, 4, 5, 6, or 7."
+              @stdout.puts "Please choose 1, 2, 3, 4, 5, 6, 7, or 8."
             end
           end
         end

data/lib/csvtool/interface/cli/workflows/builders/csv_stats_session_builder.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "csvtool/domain/csv_stats_session/stats_source"
+require "csvtool/domain/csv_stats_session/stats_options"
+require "csvtool/domain/csv_stats_session/stats_session"
+
+module Csvtool
+  module Interface
+    module CLI
+      module Workflows
+        module Builders
+          class CsvStatsSessionBuilder
+            def call(file_path:, col_sep:, headers_present:, destination:)
+              source = Domain::CsvStatsSession::StatsSource.new(
+                path: file_path,
+                separator: col_sep,
+                headers_present: headers_present
+              )
+              options = Domain::CsvStatsSession::StatsOptions.new
+              session = Domain::CsvStatsSession::StatsSession.start(source: source, options: options)
+              session.with_output_destination(destination)
+            end
+          end
+        end
+      end
+    end
+  end
+end