cisv 0.0.42 → 0.0.60

package/README.md

@@ -5,20 +5,15 @@
 ![Size](https://deno.bundlejs.com/badge?q=spring-easing)
 ![Downloads](https://badgen.net/npm/dw/cisv)
 
+> # DISCLAIMER
+>
+> This csv parser does not covers all quotes/comments edge cases, it is meant for now to be just extremly fast, thus not PROD ready yet.
 
 Cisv is a csv parser on steroids... literally.
 It's a high-performance CSV parser/writer leveraging SIMD instructions and zero-copy memory mapping. Available as both a Node.js native addon and standalone CLI tool with extensive configuration options.
 
 I wrote about basics in a blog post, you can read here :https://sanixdk.xyz/blogs/how-i-accidentally-created-the-fastest-csv-parser-ever-made.
 
-## PERFORMANCE
-
-- **469,968 MB/s** throughput on 2M row CSV files (AVX-512)
-- **10-100x faster** than popular CSV parsers
-- Zero-copy memory-mapped I/O with kernel optimizations
-- SIMD accelerated with AVX-512/AVX2 auto-detection
-- Dynamic lookup tables for configurable parsing
-
 ## CLI BENCHMARKS WITH DOCKER
 
 ```bash
@@ -41,41 +36,47 @@ $ docker run --rm      \
 ## BENCHMARKS
 
 Benchmarks comparison with existing popular tools,
-cf pipeline you can check : (https://github.com/Sanix-Darker/cisv/actions/runs/17697547058/job/50298916576) a step "Publish to npm"
+cf pipeline you can check : (https://github.com/Sanix-Darker/cisv/actions/runs/18422464917/job/52498590205) at step "Publish to npm".
 
 ### SYNCHRONOUS RESULTS
 
 | Library            | Speed (MB/s) | Avg Time (ms) | Operations/sec |
 |--------------------|--------------|---------------|----------------|
-| cisv (sync)        | 45.58        | 0.01          | 98543          |
-| csv-parse (sync)   | 18.11        | 0.03          | 39155          |
-| papaparse (sync)   | 28.03        | 0.02          | 60596          |
+| cisv (sync)        | 71.10        | 0.01          | 153723         |
+| csv-parse (sync)   | 18.76        | 0.02          | 40563          |
+| papaparse (sync)   | 27.97        | 0.02          | 60467          |
+| udsv (sync)        | 69.81        | 0.01          | 150930         |
+| d3-dsv (sync)      | 98.11        | 0.00          | 212117         |
 
 ### SYNCHRONOUS RESULTS (WITH DATA ACCESS)
 
 | Library            | Speed (MB/s) | Avg Time (ms) | Operations/sec |
 |--------------------|--------------|---------------|----------------|
-| cisv (sync)        | 46.80        | 0.01          | 101185         |
-| csv-parse (sync)   | 18.92        | 0.02          | 40900          |
-| papaparse (sync)   | 28.38        | 0.02          | 61363          |
-
+| cisv (sync)        | 104.58       | 0.00          | 226108         |
+| csv-parse (sync)   | 16.87        | 0.03          | 36482          |
+| papaparse (sync)   | 28.13        | 0.02          | 60807          |
+| udsv (sync)        | 69.29        | 0.01          | 149812         |
+| d3-dsv (sync)      | 96.32        | 0.00          | 208248         |
 
 ### ASYNCHRONOUS RESULTS
 
 | Library                  | Speed (MB/s) | Avg Time (ms) | Operations/sec |
 |--------------------------|--------------|---------------|----------------|
-| cisv (async/stream)      | 70.07        | 0.01          | 151485         |
-| papaparse (async/stream) | 21.58        | 0.02          | 46646          |
-| neat-csv (async/promise) | 9.77         | 0.05          | 21126          |
-
+| cisv (async/stream)      | 98.36        | 0.00          | 212662         |
+| papaparse (async/stream) | 21.56        | 0.02          | 46609          |
+| fast-csv (async/stream)  | 10.09        | 0.05          | 21817          |
+| neat-csv (async/promise) | 9.20         | 0.05          | 19898          |
+| udsv (async/stream)      | 51.74        | 0.01          | 111858         |
 
 ### ASYNCHRONOUS RESULTS (WITH DATA ACCESS)
 
 | Library                  | Speed (MB/s) | Avg Time (ms) | Operations/sec |
 |--------------------------|--------------|---------------|----------------|
-| cisv (async/stream)      | 25.23        | 0.02          | 54545          |
-| papaparse (async/stream) | 22.49        | 0.02          | 48622          |
-| neat-csv (async/promise) | 9.91         | 0.05          | 21428          |
+| cisv (async/stream)      | 27.50        | 0.02          | 59460          |
+| papaparse (async/stream) | 21.98        | 0.02          | 47513          |
+| fast-csv (async/stream)  | 10.05        | 0.05          | 21719          |
+| neat-csv (async/promise) | 9.58         | 0.05          | 20711          |
+| udsv (async/stream)      | 53.26        | 0.01          | 115146         |
 
 ## INSTALLATION
 
@@ -120,16 +121,16 @@ const tsv_rows = tsv_parser.parseSync('./data.tsv');
 ### CLI
 ```bash
 # Basic parsing
-cisv data.csv
+cisv_bin data.csv
 
 # Parse TSV file
-cisv -d $'\t' data.tsv
+cisv_bin -d $'\t' data.tsv
 
 # Parse with custom quote and trim
-cisv -q "'" -t data.csv
+cisv_bin -q "'" -t data.csv
 
 # Skip comment lines
-cisv -m '#' config.csv
+cisv_bin -m '#' config.csv
 ```
 
 ## CONFIGURATION OPTIONS
@@ -352,7 +353,7 @@ const tsvCount = cisvParser.countRowsWithConfig('data.tsv', {
 ### PARSING OPTIONS
 
 ```bash
-cisv [OPTIONS] [FILE]
+cisv_bin [OPTIONS] [FILE]
 
 General Options:
   -h, --help              Show help message
@@ -384,34 +385,34 @@ Processing Options:
 
 ```bash
 # Parse TSV file
-cisv -d $'\t' data.tsv
+cisv_bin -d $'\t' data.tsv
 
 # Parse CSV with semicolon delimiter and single quotes
-cisv -d ';' -q "'" european.csv
+cisv_bin -d ';' -q "'" european.csv
 
 # Skip comment lines starting with #
-cisv -m '#' config.csv
+cisv_bin -m '#' config.csv
 
 # Trim whitespace and skip empty lines
-cisv -t --skip-empty messy.csv
+cisv_bin -t --skip-empty messy.csv
 
 # Parse lines 100-1000 only
-cisv --from-line 100 --to-line 1000 large.csv
+cisv_bin --from-line 100 --to-line 1000 large.csv
 
 # Select specific columns
-cisv -s 0,2,5,7 data.csv
+cisv_bin -s 0,2,5,7 data.csv
 
 # Count rows with specific configuration
-cisv -c -d $'\t' --skip-empty data.tsv
+cisv_bin -c -d $'\t' --skip-empty data.tsv
 
 # Benchmark with custom delimiter
-cisv -b -d ';' european.csv
+cisv_bin -b -d ';' european.csv
 ```
 
 ### WRITING
 
 ```bash
-cisv write [OPTIONS]
+cisv_bin write [OPTIONS]
 
 Options:
   -g, --generate N       Generate N rows of test data
@@ -423,44 +424,9 @@ Options:
   -b, --benchmark        Benchmark mode
 ```
 
-## BENCHMARKS
-
-### PARSER PERFORMANCE (273 MB, 5M ROWS)
-
-| Parser        | Speed (MB/s) | Time (ms) | Relative       |
-|---------------|--------------|-----------|----------------|
-| **cisv**      | 7,184        | 38        | 1.0x (fastest) |
-| rust-csv      | 391          | 698       | 18x slower     |
-| xsv           | 650          | 420       | 11x slower     |
-| csvkit        | 28           | 9,875     | 260x slower    |
-
-### NODE.JS LIBRARY BENCHMARKS
-
-| Library            | Speed (MB/s) | Operations/sec | Configuration Support |
-|--------------------|--------------|----------------|----------------------|
-| cisv              | 61.24        | 136,343        | Full                 |
-| csv-parse         | 15.48        | 34,471         | Partial              |
-| papaparse         | 25.67        | 57,147         | Partial              |
-
-(you can check more benchmarks details from release pipelines)
-
-### RUNNING BENCHMARKS
-
-```bash
-# CLI benchmarks
-make clean && make cli && make benchmark-cli
-
-# Node.js benchmarks
-npm run benchmark
-
-# Benchmark with custom configuration
-cisv -b -d ';' -q "'" --trim european.csv
-```
-
 ## TECHNICAL ARCHITECTURE
 
 - **SIMD Processing**: AVX-512 (64-byte vectors) or AVX2 (32-byte vectors) for parallel processing
-- **Dynamic Lookup Tables**: Generated per-configuration for optimal state transitions
 - **Memory Mapping**: Direct kernel-to-userspace zero-copy with `mmap()`
 - **Optimized Buffering**: 1MB ring buffer sized for L3 cache efficiency
 - **Compiler Optimizations**: LTO and architecture-specific tuning with `-march=native`

package/benchmark/benchmark.js

@@ -6,6 +6,9 @@ const { parse: csvParseSync } = require('csv-parse/sync');
 const { parse: csvParseStream } = require('csv-parse');
 const Papa = require('papaparse');
 const fastCsv = require('fast-csv');
+const { inferSchema, initParser } = require('udsv');
+const d3 = require('d3-dsv');
+// const { iter } = require('but-csv');
 const fs = require('fs');
 const { Suite } = require('benchmark');
 const stream = require('stream');
@@ -90,6 +93,17 @@ async function runAllBenchmarks() {
           .add('papaparse (sync)', () => {
             Papa.parse(fileString, { fastMode: true });
           })
+          .add('udsv (sync)', () => {
+            const schema = inferSchema(fileString);
+            const parser = initParser(schema);
+            parser.stringArrs(fileString);
+          })
+          .add('d3-dsv (sync)', () => {
+            d3.csvParse(fileString);
+          })
+          // .add('but-csv (sync)', () => {
+          //   Array.from(iter(fileString));
+          // })
           .on('cycle', (event) => logCycle(event, 'sync'))
           .on('error', reject)
           .on('complete', function() {
@@ -122,6 +136,20 @@ async function runAllBenchmarks() {
             const result = Papa.parse(fileString, { fastMode: true });
             const specificRow = result.data[TARGET_ROW_INDEX];
           })
+          .add('udsv (sync)', () => {
+            const schema = inferSchema(fileString);
+            const parser = initParser(schema);
+            const rows = parser.stringArrs(fileString);
+            const specificRow = rows[TARGET_ROW_INDEX];
+          })
+          .add('d3-dsv (sync)', () => {
+            const rows = d3.csvParse(fileString);
+            const specificRow = rows[TARGET_ROW_INDEX];
+          })
+          //.add('but-csv (sync)', () => {
+          //  const rows = Array.from(iter(fileString));
+          //  const specificRow = rows[TARGET_ROW_INDEX];
+          //})
           .on('cycle', (event) => logCycle(event, 'sync_data'))
           .on('error', reject)
           .on('complete', function() {
@@ -168,6 +196,18 @@ async function runAllBenchmarks() {
               });
             }
           })
+          .add('fast-csv (async/stream)', {
+            defer: true,
+            fn: (deferred) => {
+              const rows = [];
+              const readable = stream.Readable.from(fileBuffer);
+              readable
+                .pipe(fastCsv.parse({ headers: true }))
+                .on('data', (row) => rows.push(row))
+                .on('end', () => deferred.resolve())
+                .on('error', (err) => deferred.reject(err));
+            }
+          })
           .add('neat-csv (async/promise)', {
             defer: true,
             fn: (deferred) => {
@@ -178,6 +218,32 @@ async function runAllBenchmarks() {
                 .catch((err) => deferred.reject(err));
             }
           })
+          .add('udsv (async/stream)', {
+            defer: true,
+            fn: (deferred) => {
+              const readable = stream.Readable.from(fileString);
+              let parser = null;
+
+              readable
+                .on('data', (chunk) => {
+                  const strChunk = chunk.toString();
+                  if (parser == null) {
+                    const schema = inferSchema(strChunk);
+                    parser = initParser(schema);
+                  }
+                  parser.chunk(strChunk);
+                })
+                .on('end', () => {
+                  if (parser != null) {
+                    parser.end();
+                  }
+                  deferred.resolve();
+                })
+                .on('error', (err) => deferred.reject(err));
+            }
+          })
+          // Note: d3-dsv and but-csv don't have native async streaming support
+          // so they are only included in sync benchmarks
           .on('cycle', (event) => logCycle(event, 'async'))
           .on('error', reject)
           .on('complete', function() {
@@ -227,6 +293,21 @@ async function runAllBenchmarks() {
               });
             }
           })
+          .add('fast-csv (async/stream)', {
+            defer: true,
+            fn: (deferred) => {
+              const rows = [];
+              const readable = stream.Readable.from(fileBuffer);
+              readable
+                .pipe(fastCsv.parse({ headers: true }))
+                .on('data', (row) => rows.push(row))
+                .on('end', () => {
+                  const specificRow = rows[TARGET_ROW_INDEX];
+                  deferred.resolve();
+                })
+                .on('error', (err) => deferred.reject(err));
+            }
+          })
           .add('neat-csv (async/promise)', {
             defer: true,
             fn: (deferred) => {
@@ -238,6 +319,32 @@ async function runAllBenchmarks() {
                 .catch((err) => deferred.reject(err));
             }
           })
+          .add('udsv (async/stream)', {
+            defer: true,
+            fn: (deferred) => {
+              const readable = stream.Readable.from(fileString);
+              let parser = null;
+              let result = null;
+
+              readable
+                .on('data', (chunk) => {
+                  const strChunk = chunk.toString();
+                  if (!parser) {
+                    const schema = inferSchema(strChunk);
+                    parser = initParser(schema);
+                  }
+                  parser.chunk(strChunk, parser.stringArrs);
+                })
+                .on('end', () => {
+                  if (parser) {
+                    result = parser.end();
+                    const specificRow = result[TARGET_ROW_INDEX];
+                  }
+                  deferred.resolve();
+                })
+                .on('error', (err) => deferred.reject(err));
+            }
+          })
           .on('cycle', (event) => logCycle(event, 'async_data'))
           .on('error', reject)
           .on('complete', function() {

package/cisv/cisv_addon.cc

@@ -476,7 +476,8 @@ public:
         if (!is_destroyed_) {
             cisv_parser_end(parser_);
             // Clear the environment reference after ending
-            rc_->env = nullptr;
+            // FIXME: the transformer may need this
+            // rc_->env = nullptr;
         }
     }