zlight_csv 0.3.0-aarch64-linux → 0.4.0-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a63ade56dd7ed6782062609de587eb75f6088c1aa092330eb1229d905783ceb1
-  data.tar.gz: 81d77f797497e49c5905c55969e76e4795e65dcda52f64630dfb9238a88218fb
+  metadata.gz: 0b7b428705db23dd7f65a27fb21a28f3702b2b0565099e9e3dae3353328a61b8
+  data.tar.gz: 94664f11ef0d307e911693979d768ed9c97d79d09de88bacf8ee7a3731a5b36d
 SHA512:
-  metadata.gz: 3a5d676c63bad28cdbc252015ede80b91e8359fbec6a401ce9ce4d1aa7db77871f424734ac31c8d3850443b9690b28627e69daebba1eb117023576695b976946
-  data.tar.gz: 01a60e4097a483b2d77acc872fa11f6635aea5528180f35f4e88bf229b365e1a49c8a78263b98782f2ef1f75b95cccddb2922c5a703b4c32e66240a37e4b6981
+  metadata.gz: 0a8ba87db633d2ea2bf74f0eec4c10db58d0c495b3b7a59678533e2fe01e0e7a598b42bde6d0d9769887ed8089f4dbb3190a2b95f4eb0f019edd9fc90de8282a
+  data.tar.gz: 022f03acaff20db6046cde59171e080f5e88fa7bd9e139cb2311ad4d131f1071104cfb6376a4056d1089442da058c11408cf2b958817003a79e246c03085f612

data/README.md

@@ -102,7 +102,7 @@ ZLight.parse (full):       73ms
 ZLight.stream (lazy):     0.3ms  ← 5,600x faster!
 ```
 
-### Options
+### Options (Reading)
 
 | Option | Default | Description |
 |--------|---------|-------------|
@@ -112,6 +112,38 @@ ZLight.stream (lazy):     0.3ms  ← 5,600x faster!
 | `quote_char` | `"` | Quote character |
 | `flexible` | `true` | Allow rows with varying column counts |
 
+### Writing CSV
+
+Generate CSV strings or write directly to files:
+
+```ruby
+# Generate CSV from array of hashes
+csv = ZLight.generate([
+  { name: "Alice", age: 30 },
+  { name: "Bob", age: 25 }
+])
+# => "name,age\nAlice,30\nBob,25\n"
+
+# Generate from array of arrays (no headers)
+csv = ZLight.generate([["Alice", 30], ["Bob", 25]])
+# => "Alice,30\nBob,25\n"
+
+# Write directly to a file
+ZLight.write("users.csv", data)
+
+# With options
+ZLight.generate(data, col_sep: "\t", force_quotes: true)
+```
+
+### Options (Writing)
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `headers` | `true` | Write header row (for hash input) |
+| `col_sep` | `","` | Column separator |
+| `quote_char` | `"` | Quote character |
+| `force_quotes` | `false` | Quote all fields, not just those requiring it |
+
 ## Compatibility
 
 Works as a drop-in replacement for common `CSV.parse` patterns:
@@ -132,7 +164,7 @@ ZLight.parse(data, converters: :numeric)
 ## Roadmap
 
 - [x] Streaming/lazy parsing for large files
-- [ ] CSV writing support
+- [x] CSV writing support
 - [ ] Custom converter procs
 
 ## Contributing

data/VERSION

@@ -1 +1 @@
-0.3.0
+0.4.0

data/lib/zlight_csv.rb

@@ -91,6 +91,39 @@ module ZLight
   # @note The parse method is defined in the Rust native extension.
   #   See ext/zlight_csv/src/lib.rs for implementation.
 
+  # Generates a CSV string from an array of rows.
+  #
+  # This method is implemented as a native Rust extension for maximum performance.
+  #
+  # @param rows [Array<Hash>, Array<Array>] The data to convert to CSV
+  # @param headers [Boolean] Write header row for hash input (default: true)
+  # @param col_sep [String] Column separator character (default: ",")
+  # @param quote_char [String] Quote character for escaping (default: '"')
+  # @param force_quotes [Boolean] Force quoting all fields (default: false)
+  #
+  # @return [String] The generated CSV string
+  #
+  # @raise [ArgumentError] If options are invalid or rows format is mixed
+  #
+  # @example Generate CSV from array of hashes
+  #   ZLight.generate([{name: "Alice", age: 30}, {name: "Bob", age: 25}])
+  #   # => "name,age\nAlice,30\nBob,25\n"
+  #
+  # @example Generate CSV from array of arrays (no headers)
+  #   ZLight.generate([["Alice", 30], ["Bob", 25]])
+  #   # => "Alice,30\nBob,25\n"
+  #
+  # @example Generate without headers
+  #   ZLight.generate([{name: "Alice"}], headers: false)
+  #   # => "Alice\n"
+  #
+  # @example Generate TSV
+  #   ZLight.generate([{a: 1, b: 2}], col_sep: "\t")
+  #   # => "a\tb\n1\t2\n"
+  #
+  # @note The generate method is defined in the Rust native extension.
+  #   See ext/zlight_csv/src/writer.rs for implementation.
+
   # StreamReader is defined in the Rust extension.
   # It provides lazy/streaming CSV parsing for large files.
   #
@@ -133,6 +166,38 @@ module ZLight
       parse(File.read(path, encoding: 'UTF-8'), **options)
     end
 
+    # Writes CSV data to a file.
+    #
+    # Convenience method that generates CSV and writes to disk.
+    # The file is written with UTF-8 encoding.
+    #
+    # @param path [String] Path to the output CSV file
+    # @param rows [Array<Hash>, Array<Array>] The data to write
+    # @param headers [Boolean] Write header row for hash input (default: true)
+    # @param col_sep [String] Column separator character (default: ",")
+    # @param quote_char [String] Quote character for escaping (default: '"')
+    # @param force_quotes [Boolean] Force quoting all fields (default: false)
+    #
+    # @return [Integer] Number of bytes written
+    #
+    # @raise [Errno::ENOENT] If the directory does not exist
+    # @raise [Errno::EACCES] If the file is not writable
+    # @raise [ArgumentError] If options are invalid
+    #
+    # @example Write hashes to CSV
+    #   ZLight.write("users.csv", [{name: "Alice", age: 30}])
+    #
+    # @example Write arrays to CSV
+    #   ZLight.write("data.csv", [["a", "b"], [1, 2]])
+    #
+    # @example Write TSV
+    #   ZLight.write("data.tsv", rows, col_sep: "\t")
+    #
+    # @see .generate
+    def write(path, rows, **options)
+      File.write(path, generate(rows, **options), encoding: 'UTF-8')
+    end
+
     # Iterates over each row in the CSV string.
     #
     # When called with a block, yields each row and returns nil.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zlight_csv
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: aarch64-linux
 authors:
 - Zaidan Chaudhary
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-05-21 00:00:00.000000000 Z
+date: 2026-06-06 00:00:00.000000000 Z
 dependencies: []
 description: |
   ZLight brings the speed of Rust to Ruby's CSV parsing. Built as a native