skip empty rows by default

src/Csv.php

@@ -195,6 +195,13 @@ public function each($callback)
         }
     }
 
+    public function skipEmptyRows($shouldSkip = true)
+    {
+        $this->processor->skipEmptyRows = $shouldSkip;
+
+        return $this;
+    }
+
     /**
      * Get the CSV data as JSON.
      * Warning: This will load the entire CSV into memory, so it shouldn't be

src/CsvProcessor.php

@@ -23,6 +23,8 @@ class CsvProcessor
 
     public string $delimiter = ',';
 
+    public bool $skipEmptyRows = false;
+
     public array $headers = [];
 
     public function __construct(public FileHandler $fileHandler)
@@ -44,6 +46,10 @@ public function process()
                 continue; // Skip rows based on specified row numbers
             }
 
+            if ($this->skipEmptyRows && empty(array_filter($row))) {
+                continue; // Skip empty rows
+            }
+
             $row = $this->prepareRow($row);
 
             if ($this->filterCallback instanceof \Closure && ! call_user_func($this->filterCallback, $row)) {

tests/Fixtures/data_with_empty_rows.csv

@@ -0,0 +1,4 @@
+Foo,Bar,Baz
+Foo1,Bar1,Baz1
+,,
+Foo3,Bar3,Baz3

tests/Unit/CsvTest.php

@@ -366,3 +366,16 @@ function makeTestFile($rows = 1000)
 
     unlink($file);
 });
+
+test('it skips empty rows by default', function () {
+    $file = __DIR__.'/../Fixtures/data_with_empty_rows.csv';
+    $csv = Csv::from($file)
+        ->mapToHeaders()
+        ->skipEmptyRows();
+
+    expect($csv->count())->toBe(2);
+
+    $csv->skipEmptyRows(false);
+    expect($csv->count())->toBe(3);
+
+});