csvops 0.1.0.alpha → 0.2.0.alpha

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8621d11595ca64afe19513bbeb253a9568ef78566aff8eec116a2b169e899fce
-  data.tar.gz: '009a655572331c7699ca8c6034d9bcf45db517e90da4ae4317d3b42c6b4aa7dd'
+  metadata.gz: 5a04bb138984be7581485f1db2ac6b145ca446846d54179e47ee42f28e4bcf48
+  data.tar.gz: 2cb0f7ae0e9dea000f9422c922bae2842649eec253752c362cd4301ecf60a29d
 SHA512:
-  metadata.gz: 542f540de68616558cfe40e39fecbb4a3b91fa7a2bf8fd59397e5a9aad855503795e928c1ddae18c3577e6e3558b34166e3c240e6b7744e11d0c6b8a11297aa6
-  data.tar.gz: 04a5beb85795c5b10984a8a12980a1079a8a4f07f447d6621d6e6961ded35ee18edb5834e5e8fbad99b0f7fd0c76c2aae31f7d2ccc48f3b54a520d7bcbf91931
+  metadata.gz: ea2610440ae2db2052b4e317ad6ec066ed7641fe5a09cf3b5e9a5ea8e80249474f636d3899cf5cc99ae07f23da279148c301296a5f0a24af61aae2d35605717c
+  data.tar.gz: 60da56d279491e8e3b9401d2bca7910beac884eb9bab38ee67b18dc48e3880caf1c9a82454905eb0d4d2dd71611ad6141b2b708bd962e13045faf569bd67540c

data/README.md

@@ -34,7 +34,8 @@ bundle exec csvtool menu
 ```text
 CSV Tool Menu
 1. Extract column
-2. Exit
+2. Extract rows (range)
+3. Exit
 >
 ```
 
@@ -126,7 +127,7 @@ bundle exec rake test
 
 ## Alpha release
 
-Current prerelease version: `0.1.0.alpha`
+Current prerelease version: `0.2.0.alpha`
 
 Install prerelease from RubyGems:
 
@@ -136,25 +137,25 @@ gem install csvops --pre
 
 Release runbook:
 
-- `/Users/roberthall/Projects/csvops/docs/release-v0.1.0-alpha.md`
+- `docs/release-v0.2.0-alpha.md`
 
 ## Architecture
 
 The codebase follows a DDD-lite layered structure:
 
-- `domain/`: core domain model and invariants (`ExtractionSession` aggregate + value objects/entities).
-- `application/`: use-case orchestration (`RunExtraction`).
+- `domain/`: core domain models and invariants (`ColumnSession` and `RowSession` aggregates + supporting entities/value objects).
+- `application/`: use-case orchestration (`RunExtraction`, `RunRowExtraction`).
 - `infrastructure/`: CSV reading/streaming and output adapters (console/file).
 - `interface/cli/`: menu, prompts, and user-facing error presentation.
 - `Csvtool::CLI`: entrypoint wiring from command args to interface/application flow.
 
 ## Domain model
 
-Bounded context: `Column Extraction`.
+Bounded contexts: `Column Extraction` and `Row Extraction`.
 
-Core DDD structure:
+### Column Extraction
 
-- Aggregate root: `ExtractionSession`
+- Aggregate root: `ColumnSession`
   - Controls extraction state transitions (`start`, `with_preview`, `confirm!`, `with_output_destination`).
   - Enforces session-level invariants.
 - Entities:
@@ -181,7 +182,7 @@ Core DDD structure:
 ```mermaid
 flowchart LR
   UI["Interface CLI\n(Menu + Prompts + Errors)"] --> APP["Application Use Case\nRunExtraction"]
-  APP --> AGG["Domain Aggregate\nExtractionSession"]
+  APP --> AGG["Domain Aggregate\nColumnSession"]
 
   AGG --> E1["Entity\nCsvSource"]
   AGG --> E2["Entity\nColumnSelection"]
@@ -191,13 +192,51 @@ flowchart LR
   APP --> INFOUT["Infrastructure Output\nConsoleWriter + CsvFileWriter"]
 ```
 
+### Row Extraction
+
+Core DDD structure:
+
+- Aggregate root: `RowSession`
+  - Captures one row-range extraction request.
+  - Holds selected source, requested range, and output destination.
+- Entity:
+  - `RowSource` (file path + separator)
+- Value objects:
+  - `RowRange` (`start_row`, `end_row`) plus row-range validation errors
+  - `RowOutputDestination` (`console` or `file(path)`)
+- Application service:
+  - `Application::UseCases::RunRowExtraction` orchestrates row-range extraction.
+- Infrastructure adapters:
+  - `Infrastructure::CSV::HeaderReader`
+  - `Infrastructure::CSV::RowStreamer`
+  - `Infrastructure::Output::CsvRowConsoleWriter`
+  - `Infrastructure::Output::CsvRowFileWriter`
+- Interface adapters:
+  - `Interface::CLI::MenuLoop`
+  - `Interface::CLI::Prompts::*`
+  - `Interface::CLI::Errors::Presenter`
+
+```mermaid
+flowchart LR
+  UI2["Interface CLI\n(Menu + Prompts + Errors)"] --> APP2["Application Use Case\nRunRowExtraction"]
+  APP2 --> AGG2["Domain Aggregate\nRowSession"]
+
+  AGG2 --> E3["Entity\nRowSource"]
+  AGG2 --> V2["Value Objects\nRowRange / RowOutputDestination"]
+
+  APP2 --> INFCSV2["Infrastructure CSV\nHeaderReader + RowStreamer"]
+  APP2 --> INFOUT2["Infrastructure Output\nCsvRowConsoleWriter + CsvRowFileWriter"]
+```
+
 ## Project layout
 
 ```text
 bin/tool              # CLI entrypoint
 lib/csvtool/cli.rb
-lib/csvtool/domain/extraction_session/*
+lib/csvtool/domain/column_session/*
+lib/csvtool/domain/row_session/*
 lib/csvtool/application/use_cases/run_extraction.rb
+lib/csvtool/application/use_cases/run_row_extraction.rb
 lib/csvtool/infrastructure/csv/*
 lib/csvtool/infrastructure/output/*
 lib/csvtool/interface/cli/menu_loop.rb

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

@@ -0,0 +1,80 @@
+# Release Checklist: v0.2.0-alpha
+
+## 1. Verify environment
+
+```bash
+ruby -v
+bundle -v
+```
+
+Expected:
+- Ruby `3.3.0`
+
+## 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
+```
+
+Expected output for `column` command:
+
+```text
+Alice
+Bob
+Cara
+```
+
+## 5. Smoke test row extraction workflow
+
+Use menu option `2` (`Extract rows (range)`), then verify:
+- console output path works
+- file output path works
+- row-range validation errors are handled cleanly
+
+## 6. Build and validate gem package
+
+```bash
+gem build csvops.gemspec
+gem install ./csvops-0.2.0.alpha.gem
+csvtool menu
+```
+
+## 7. Commit release prep
+
+```bash
+git add -A
+git commit -m "chore(release): prepare v0.2.0-alpha"
+```
+
+## 8. Tag release
+
+```bash
+git tag -a v0.2.0-alpha -m "v0.2.0-alpha"
+git push origin main --tags
+```
+
+## 9. Publish gem (optional for alpha)
+
+```bash
+gem push csvops-0.2.0.alpha.gem
+```
+
+## 10. Create GitHub release
+
+Create release `v0.2.0-alpha` with:
+- Summary of supported commands (`menu`, `column`, `row range`)
+- Notes on output destination support (`console`, `file`)
+- Install instructions (`gem install csvops --pre`)

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

@@ -13,14 +13,14 @@ require "csvtool/infrastructure/csv/value_streamer"
 require "csvtool/services/preview_builder"
 require "csvtool/infrastructure/output/console_writer"
 require "csvtool/infrastructure/output/csv_file_writer"
-require "csvtool/domain/extraction_session/separator"
-require "csvtool/domain/extraction_session/csv_source"
-require "csvtool/domain/extraction_session/column_selection"
-require "csvtool/domain/extraction_session/extraction_options"
-require "csvtool/domain/extraction_session/extraction_value"
-require "csvtool/domain/extraction_session/preview"
-require "csvtool/domain/extraction_session/output_destination"
-require "csvtool/domain/extraction_session/extraction_session"
+require "csvtool/domain/column_session/separator"
+require "csvtool/domain/column_session/csv_source"
+require "csvtool/domain/column_session/column_selection"
+require "csvtool/domain/column_session/extraction_options"
+require "csvtool/domain/column_session/extraction_value"
+require "csvtool/domain/column_session/preview"
+require "csvtool/domain/column_session/output_destination"
+require "csvtool/domain/column_session/column_session"
 
 module Csvtool
   module Application
@@ -41,19 +41,19 @@ module Csvtool
 
           col_sep = Interface::CLI::Prompts::SeparatorPrompt.new(stdin: @stdin, stdout: @stdout, errors: @errors).call
           return if col_sep.nil?
-          separator = Domain::ExtractionSession::Separator.new(col_sep)
+          separator = Domain::ColumnSession::Separator.new(col_sep)
 
-          source = Domain::ExtractionSession::CsvSource.new(path: file_path, separator: separator)
+          source = Domain::ColumnSession::CsvSource.new(path: file_path, separator: separator)
           headers = @header_reader.call(file_path: source.path, col_sep: source.separator.value)
           return @errors.no_headers if headers.empty?
 
           column_name = Interface::CLI::Prompts::ColumnSelectorPrompt.new(stdin: @stdin, stdout: @stdout, errors: @errors).call(headers)
           return if column_name.nil?
-          column_selection = Domain::ExtractionSession::ColumnSelection.new(name: column_name)
+          column_selection = Domain::ColumnSession::ColumnSelection.new(name: column_name)
 
           skip_blanks = Interface::CLI::Prompts::SkipBlanksPrompt.new(stdin: @stdin, stdout: @stdout).call
-          options = Domain::ExtractionSession::ExtractionOptions.new(skip_blanks: skip_blanks, preview_limit: 10)
-          session = Domain::ExtractionSession::ExtractionSession.start(
+          options = Domain::ColumnSession::ExtractionOptions.new(skip_blanks: skip_blanks, preview_limit: 10)
+          session = Domain::ColumnSession::ColumnSession.start(
             source: source,
             column_selection: column_selection,
             options: options
@@ -66,8 +66,8 @@ module Csvtool
             skip_blanks: session.options.skip_blanks?,
             limit: session.options.preview_limit
           )
-          preview = Domain::ExtractionSession::Preview.new(
-            values: preview_values.map { |value| Domain::ExtractionSession::ExtractionValue.new(value) }
+          preview = Domain::ColumnSession::Preview.new(
+            values: preview_values.map { |value| Domain::ColumnSession::ExtractionValue.new(value) }
           )
           session = session.with_preview(preview)
 
@@ -79,9 +79,9 @@ module Csvtool
           return if output_destination.nil?
           domain_destination =
             if output_destination[:mode] == :file
-              Domain::ExtractionSession::OutputDestination.file(path: output_destination[:path])
+              Domain::ColumnSession::OutputDestination.file(path: output_destination[:path])
             else
-              Domain::ExtractionSession::OutputDestination.console
+              Domain::ColumnSession::OutputDestination.console
             end
           session = session.with_output_destination(domain_destination)
 

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

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+require "csv"
+require "csvtool/interface/cli/errors/presenter"
+require "csvtool/interface/cli/prompts/file_path_prompt"
+require "csvtool/interface/cli/prompts/separator_prompt"
+require "csvtool/interface/cli/prompts/output_destination_prompt"
+require "csvtool/infrastructure/csv/header_reader"
+require "csvtool/infrastructure/csv/row_streamer"
+require "csvtool/infrastructure/output/csv_row_console_writer"
+require "csvtool/infrastructure/output/csv_row_file_writer"
+require "csvtool/domain/row_session/row_range"
+require "csvtool/domain/row_session/row_source"
+require "csvtool/domain/row_session/row_output_destination"
+require "csvtool/domain/row_session/row_session"
+
+module Csvtool
+  module Application
+    module UseCases
+      class RunRowExtraction
+        def initialize(stdin:, stdout:)
+          @stdin = stdin
+          @stdout = stdout
+          @errors = Interface::CLI::Errors::Presenter.new(stdout: stdout)
+          @header_reader = Infrastructure::CSV::HeaderReader.new
+          @row_streamer = Infrastructure::CSV::RowStreamer.new
+        end
+
+        def call
+          file_path = Interface::CLI::Prompts::FilePathPrompt.new(stdin: @stdin, stdout: @stdout).call
+          return @errors.file_not_found(file_path) unless File.file?(file_path)
+
+          col_sep = Interface::CLI::Prompts::SeparatorPrompt.new(stdin: @stdin, stdout: @stdout, errors: @errors).call
+          return if col_sep.nil?
+          source = Domain::RowSession::RowSource.new(path: file_path, separator: col_sep)
+
+          @stdout.print "Start row (1-based, inclusive): "
+          start_row_input = @stdin.gets&.strip.to_s
+          @stdout.print "End row (1-based, inclusive): "
+          end_row_input = @stdin.gets&.strip.to_s
+
+          headers = @header_reader.call(file_path: source.path, col_sep: source.separator)
+          return @errors.no_headers if headers.empty?
+
+          row_range = Domain::RowSession::RowRange.from_inputs(
+            start_row_input: start_row_input,
+            end_row_input: end_row_input
+          )
+          session = Domain::RowSession::RowSession.start(source: source, row_range: row_range)
+
+          output_destination = Interface::CLI::Prompts::OutputDestinationPrompt.new(
+            stdin: @stdin,
+            stdout: @stdout,
+            errors: @errors
+          ).call
+          return if output_destination.nil?
+          destination =
+            if output_destination[:mode] == :file
+              Domain::RowSession::RowOutputDestination.file(path: output_destination[:path])
+            else
+              Domain::RowSession::RowOutputDestination.console
+            end
+          session = session.with_output_destination(destination)
+
+          stats =
+          if session.output_destination.file?
+            Infrastructure::Output::CsvRowFileWriter.new(
+              stdout: @stdout,
+              errors: @errors,
+              row_streamer: @row_streamer
+            ).call(
+              output_path: session.output_destination.path,
+              file_path: session.source.path,
+              col_sep: session.source.separator,
+              headers: headers,
+              start_row: session.row_range.start_row,
+              end_row: session.row_range.end_row
+            )
+          else
+            Infrastructure::Output::CsvRowConsoleWriter.new(stdout: @stdout, row_streamer: @row_streamer).call(
+              file_path: session.source.path,
+              col_sep: session.source.separator,
+              headers: headers,
+              start_row: session.row_range.start_row,
+              end_row: session.row_range.end_row
+            )
+          end
+          return if stats.nil?
+
+          @errors.row_range_out_of_bounds(stats[:row_count]) unless stats[:matched]
+        rescue Domain::RowSession::InvalidStartRowError
+          @errors.invalid_start_row
+        rescue Domain::RowSession::InvalidEndRowError
+          @errors.invalid_end_row
+        rescue Domain::RowSession::InvalidRowRangeOrderError
+          @errors.invalid_row_range_order
+        rescue ArgumentError => e
+          return @errors.empty_output_path if e.message == "file output path cannot be empty"
+
+          raise e
+        rescue CSV::MalformedCSVError
+          @errors.could_not_parse_csv
+        rescue Errno::EACCES
+          @errors.cannot_read_file(file_path)
+        end
+        
+        private
+      end
+    end
+  end
+end

data/lib/csvtool/cli.rb

@@ -3,6 +3,7 @@
 require "csv"
 require "csvtool/interface/cli/menu_loop"
 require "csvtool/application/use_cases/run_extraction"
+require "csvtool/application/use_cases/run_row_extraction"
 require "csvtool/interface/cli/errors/presenter"
 require "csvtool/infrastructure/csv/header_reader"
 require "csvtool/infrastructure/csv/value_streamer"
@@ -12,6 +13,7 @@ module Csvtool
   class CLI
     MENU_OPTIONS = [
       "Extract column",
+      "Extract rows (range)",
       "Exit"
     ].freeze
 
@@ -41,12 +43,14 @@ module Csvtool
     private
 
     def run_menu_loop
-      extract_action = -> { Application::UseCases::RunExtraction.new(stdin: @stdin, stdout: @stdout).call }
+      extract_column_action = -> { Application::UseCases::RunExtraction.new(stdin: @stdin, stdout: @stdout).call }
+      extract_rows_action = -> { Application::UseCases::RunRowExtraction.new(stdin: @stdin, stdout: @stdout).call }
       Interface::CLI::MenuLoop.new(
         stdin: @stdin,
         stdout: @stdout,
         menu_options: MENU_OPTIONS,
-        extract_action: extract_action
+        extract_column_action: extract_column_action,
+        extract_rows_action: extract_rows_action
       ).run
     end
 

data/lib/csvtool/domain/{extraction_session → column_session}/column_selection.rb

@@ -2,7 +2,7 @@
 
 module Csvtool
   module Domain
-    module ExtractionSession
+    module ColumnSession
       class ColumnSelection
         attr_reader :name
 

data/lib/csvtool/domain/{extraction_session/extraction_session.rb → column_session/column_session.rb}

@@ -2,8 +2,8 @@
 
 module Csvtool
   module Domain
-    module ExtractionSession
-      class ExtractionSession
+    module ColumnSession
+      class ColumnSession
         attr_reader :source, :column_selection, :options, :preview, :output_destination
 
         def self.start(source:, column_selection:, options:)

data/lib/csvtool/domain/{extraction_session → column_session}/csv_source.rb

@@ -2,7 +2,7 @@
 
 module Csvtool
   module Domain
-    module ExtractionSession
+    module ColumnSession
       class CsvSource
         attr_reader :path, :separator
 

data/lib/csvtool/domain/{extraction_session → column_session}/extraction_options.rb

@@ -2,7 +2,7 @@
 
 module Csvtool
   module Domain
-    module ExtractionSession
+    module ColumnSession
       class ExtractionOptions
         attr_reader :skip_blanks, :preview_limit
 

data/lib/csvtool/domain/{extraction_session → column_session}/extraction_value.rb

@@ -2,7 +2,7 @@
 
 module Csvtool
   module Domain
-    module ExtractionSession
+    module ColumnSession
       class ExtractionValue
         attr_reader :value
 

data/lib/csvtool/domain/{extraction_session → column_session}/output_destination.rb

@@ -2,7 +2,7 @@
 
 module Csvtool
   module Domain
-    module ExtractionSession
+    module ColumnSession
       class OutputDestination
         attr_reader :mode, :path
 

data/lib/csvtool/domain/{extraction_session → column_session}/preview.rb

@@ -2,7 +2,7 @@
 
 module Csvtool
   module Domain
-    module ExtractionSession
+    module ColumnSession
       class Preview
         attr_reader :values
 

data/lib/csvtool/domain/{extraction_session → column_session}/separator.rb

@@ -2,7 +2,7 @@
 
 module Csvtool
   module Domain
-    module ExtractionSession
+    module ColumnSession
       class Separator
         attr_reader :value
 

data/lib/csvtool/domain/row_session/row_output_destination.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Csvtool
+  module Domain
+    module RowSession
+      class RowOutputDestination
+        attr_reader :mode, :path
+
+        def self.console
+          new(mode: :console)
+        end
+
+        def self.file(path:)
+          new(mode: :file, path: path)
+        end
+
+        def initialize(mode:, path: nil)
+          raise ArgumentError, "invalid output mode" unless %i[console file].include?(mode)
+          raise ArgumentError, "file output path cannot be empty" if mode == :file && path.to_s.empty?
+
+          @mode = mode
+          @path = path
+        end
+
+        def file?
+          @mode == :file
+        end
+      end
+    end
+  end
+end

data/lib/csvtool/domain/row_session/row_range.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Csvtool
+  module Domain
+    module RowSession
+      class InvalidStartRowError < StandardError; end
+      class InvalidEndRowError < StandardError; end
+      class InvalidRowRangeOrderError < StandardError; end
+
+      class RowRange
+        attr_reader :start_row, :end_row
+
+        def self.from_inputs(start_row_input:, end_row_input:)
+          unless /\A[1-9]\d*\z/.match?(start_row_input.to_s)
+            raise InvalidStartRowError, "invalid start row"
+          end
+          unless /\A[1-9]\d*\z/.match?(end_row_input.to_s)
+            raise InvalidEndRowError, "invalid end row"
+          end
+
+          start_row = start_row_input.to_i
+          end_row = end_row_input.to_i
+          raise InvalidRowRangeOrderError, "end row before start row" if end_row < start_row
+
+          new(start_row: start_row, end_row: end_row)
+        end
+
+        def initialize(start_row:, end_row:)
+          raise InvalidStartRowError, "invalid start row" unless start_row.to_i >= 1
+          raise InvalidEndRowError, "invalid end row" unless end_row.to_i >= 1
+          raise InvalidRowRangeOrderError, "end row before start row" if end_row < start_row
+
+          @start_row = start_row
+          @end_row = end_row
+        end
+      end
+    end
+  end
+end

data/lib/csvtool/domain/row_session/row_session.rb

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

data/lib/csvtool/domain/row_session/row_source.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Csvtool
+  module Domain
+    module RowSession
+      class RowSource
+        attr_reader :path, :separator
+
+        def initialize(path:, separator:)
+          @path = path
+          @separator = separator
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "csv"
+
+module Csvtool
+  module Infrastructure
+    module CSV
+      class RowStreamer
+        def each_in_range(file_path:, col_sep:, start_row:, end_row:)
+          row_index = 0
+          matched = false
+
+          ::CSV.foreach(file_path, headers: true, col_sep: col_sep) do |row|
+            row_index += 1
+            next if row_index < start_row
+            break if row_index > end_row
+
+            matched = true
+            yield row.fields
+          end
+
+          { matched: matched, row_count: row_index }
+        end
+      end
+    end
+  end
+end