typed_print 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4ded9b786c7fc0596377055e783a299fe9eab5558d0d375d978f8186ab72c840
-  data.tar.gz: d6433125b154f6b2deaaf7764b2b02919d72d4e25e53edc1a2af379265289c96
+  metadata.gz: d9efbcc2dccb48448275cea750dea3f3e8682d669916f9968fa27ce9ea84860a
+  data.tar.gz: 5b00aac3cd4941932a298285ed7931ea7a62cef5eb2667d045c7201b3860bf27
 SHA512:
-  metadata.gz: 8d7b5bd554c0e68e5d8846103e2020db279a96f3ce7d075281492a42570f7d055dd58c38a15bfe8d3be8b6af67a1f30c6c3d81d476c5d080d533049ad62a8561
-  data.tar.gz: 27cdf2be6875f4a47f666c5716db1b50b1ffa3136d3ba548a8d8d6f8a123be07ae3f73d8a92c1a6031f75b3fd03011490aea81508bb5140678fbb09faba9b820
+  metadata.gz: 1a8b3bbc69003ba7711849e746e71eb2cfce4c017842e8e6104c500b71830a415a03234716d6837ef9d77e4ae336231a41f78399f95f15e26a961847e48cd46a
+  data.tar.gz: c3f40b2ef369fcf2106dba9cf85792981ecd901a503b6904ef584f5f04f0783b910de90836506df91a97616618884f2134d648a102cd8fe817534c28953cf9cf

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.4.0] - 2026-05-02
+
+### Added
+- `TypedPrint.to_csv(data, only:, headers:, delimiter: ",")` — returns CSV string
+- `TypedPrint.save(data, path, only:, headers:, delimiter: ",")` — writes CSV file with UTF-8 BOM (Excel-compatible)
+- Custom delimiter support (`,` or `;` or any character)
+- Fixed edge case: empty data no longer raises on `determine_headers`
+
 ## [0.3.0] - 2026-04-27
 
 ### Added

data/README.md

@@ -21,6 +21,7 @@ Beautiful, aligned table output for Ruby hashes and objects with zero dependenci
 - 📝 Preserves original column order
 - 📄 Markdown table output (v0.2.0+)
 - 🌈 Optional color output via `pastel` gem (v0.3.0+)
+- 📤 CSV export with Excel-compatible encoding (v0.4.0+)
 
 ## Installation
 
@@ -153,6 +154,17 @@ Product B   49.99 false    Limited edition
 
 Same options as `print`.
 
+`TypedPrint.to_csv(data, options)` returns data as a CSV string.
+
+**Options:**
+- `only: Array` - Columns to include
+- `headers: Hash` - Custom column headers
+- `delimiter: String` - Column separator (default: `","`)
+
+`TypedPrint.save(data, path, options)` writes a CSV file with UTF-8 BOM and returns `nil`.
+
+Same options as `to_csv`.
+
 ### Color Output (v0.3.0+)
 
 Color support is optional and requires the `pastel` gem. Add it to your Gemfile:
@@ -174,6 +186,32 @@ TypedPrint.print(data, colors: { name: :cyan, score: :green, active: :yellow })
 
 Both `:plain` and `:markdown` formats support color. If `pastel` is not installed, color options are silently ignored and output is plain text.
 
+### CSV Export (v0.4.0+)
+
+No extra dependencies — uses Ruby's stdlib `csv`.
+
+**Return CSV string:**
+```ruby
+csv = TypedPrint.to_csv(data)
+# => "Name,Score,Active\nAlice,100,true\nBob,42,false\n"
+```
+
+**Save to file (Excel-compatible UTF-8 BOM):**
+```ruby
+TypedPrint.save(data, "output.csv")
+```
+
+**Custom delimiter:**
+```ruby
+TypedPrint.to_csv(data, delimiter: ";")
+TypedPrint.save(data, "output.csv", delimiter: ";")
+```
+
+**Filter columns and custom headers:**
+```ruby
+TypedPrint.to_csv(data, only: [:name, :score], headers: { score: "Points" })
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests.

data/lib/typed_print/table.rb

@@ -27,6 +27,19 @@ module TypedPrint
       end
     end
 
+    def to_csv(col_sep: ",")
+      require "csv"
+      return "" if @data.empty?
+
+      header_row = @headers.map { |h| header_label(h) }
+      rows = @data.map { |row| @headers.map { |h| format_value(row[h]) } }
+
+      CSV.generate(col_sep: col_sep) do |csv|
+        csv << header_row
+        rows.each { |row| csv << row }
+      end
+    end
+
     def render_plain
       return "" if @data.empty?
 
@@ -150,6 +163,8 @@ module TypedPrint
     end
 
     def determine_headers
+      return [] if @data.empty?
+
       all_keys = @data.flat_map(&:keys).uniq
 
       if @only_columns

data/lib/typed_print/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TypedPrint
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/typed_print.rb

@@ -13,4 +13,15 @@ module TypedPrint
     table_obj = TypedPrint::Table.new(data, align, only, headers, color: color, colors: colors)
     table_obj.render(format)
   end
+
+  def self.to_csv(data, only: nil, headers: {}, delimiter: ",")
+    table_obj = TypedPrint::Table.new(data, {}, only, headers)
+    table_obj.to_csv(col_sep: delimiter)
+  end
+
+  def self.save(data, path, only: nil, headers: {}, delimiter: ",")
+    csv = to_csv(data, only: only, headers: headers, delimiter: delimiter)
+    File.write(path, "\xEF\xBB\xBF" + csv, encoding: "UTF-8")
+    nil
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: typed_print
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Ender Ahmet Yurt