typed_print 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 85e9b5563417e0d0cb32b45b946ec26f3697a220802c6e012595faecc3d74275
-  data.tar.gz: b40e48244c2020e69b5f25c3049468f7431df3b7eb6a60d6a35080ace995cc63
+  metadata.gz: d9efbcc2dccb48448275cea750dea3f3e8682d669916f9968fa27ce9ea84860a
+  data.tar.gz: 5b00aac3cd4941932a298285ed7931ea7a62cef5eb2667d045c7201b3860bf27
 SHA512:
-  metadata.gz: f4d9957cd9d3647ee46761fca7ecfc70093958719730d56f39dd10442392dc29d70a6779bed68ff60a45eb1890780d28c4162defec8b2107e90a758b6d224350
-  data.tar.gz: c18f2fa2dcebc25b150a914afa7795ce07434aa3b43dd3ad3d0abad64c3ce9e3574ed08a3667e214b33bff7cd1977d0eacdd98f4674de2e4265ddef2e4c2efc0
+  metadata.gz: 1a8b3bbc69003ba7711849e746e71eb2cfce4c017842e8e6104c500b71830a415a03234716d6837ef9d77e4ae336231a41f78399f95f15e26a961847e48cd46a
+  data.tar.gz: c3f40b2ef369fcf2106dba9cf85792981ecd901a503b6904ef584f5f04f0783b910de90836506df91a97616618884f2134d648a102cd8fe817534c28953cf9cf

data/CHANGELOG.md

@@ -1,13 +1,39 @@
+# 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
+- Optional color support via `pastel` gem (runtime optional, dev dependency)
+- `color: true` for automatic type-based coloring (headers cyan, numbers green, booleans green/red, nil gray)
+- `colors: { col: :color }` for manual per-column color mapping
+- Color support for both `:plain` and `:markdown` formats
+
+## [0.2.0] - 2026-04-22
+
+### Added
+- Markdown table output with `format: :markdown` option
+- New `TypedPrint.table` method returns string without printing
+- Support for both plain and markdown formats
+
+### Changed
+- Internal refactoring to support multiple output formats
+
 ## [0.1.0] - 2026-04-21
 
 ### Added
 - Initial release
 - Basic table formatting for Ruby hashes
 - Column alignment options (left, right, center)
-- Column filtering with `:only` option
-- Custom headers with `:headers` option
+- Column filtering with `only:` option
+- Custom headers with `headers:` option
 - Smart type formatting (booleans, nil, strings)
 - Preserves original column order
-- `TypedPrint.print` method for printing to stdout
-- `TypedPrint.table` method for returning formatted string
 - Zero dependencies

data/README.md

@@ -8,29 +8,30 @@ Beautiful, aligned table output for Ruby hashes and objects with zero dependenci
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Gem Downloads](https://img.shields.io/gem/dt/typed_print)](https://rubygems.org/gems/typed_print)
 
+![TypedPrint Demo](assets/demo.gif)
+
 ## Features
 
-- 🚀 Zero dependencies
+- 🚀 Zero runtime dependencies
 - 📊 Automatic column width calculation
 - 🎯 Smart type formatting (booleans, nil, strings)
 - 📐 Column alignment (left, right, center)
 - 🎨 Custom column headers
 - 🔍 Column filtering
 - 📝 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
 
 Add this line to your application's Gemfile:
 
-```ruby
-gem 'typed_print'
-```
+`gem 'typed_print'`
 
 Or install it yourself:
 
-```bash
-gem install typed_print
-```
+`gem install typed_print`
 
 ## Usage
 
@@ -48,72 +49,78 @@ TypedPrint.print(data)
 ```
 
 Output:
+
 ```
- Name  Score Active 
+Name  Score Active 
 ------+------+-------
 Alice   100 true   
 Bob      42 false  
 ```
 
-### Column Alignment
+### Markdown Format (NEW in v0.2.0)
+```ruby
+TypedPrint.print(data, format: :markdown)
+```
 
-Right-align specific columns:
+Output:
+```
+| Name  | Score | Active |
+|-------|-------|--------|
+| Alice | 100   | true   |
+| Bob   | 42    | false  |
+```
 
+### Column Alignment
 ```ruby
 TypedPrint.print(data, align: { score: :right })
 ```
 
 Output:
 ```
- Name  Score Active 
+Name  Score Active 
 ------+------+-------
 Alice   100 true   
-Bob      42 false  
+Bob      42 false
 ```
 
 ### Filter Columns
 
-Show only specific columns:
-
 ```ruby
 TypedPrint.print(data, only: [:name, :score])
 ```
 
 Output:
 ```
- Name  Score 
+Name  Score 
 ------+------
 Alice   100 
 Bob      42 
 ```
 
 ### Custom Headers
-
-Rename columns for display:
-
 ```ruby
 TypedPrint.print(data, headers: { name: "Username", score: "Points", active: "Status" })
 ```
 
 Output:
 ```
- Username Points Status 
+Username Points Status 
 ---------+------+-------
 Alice       100 true   
 Bob          42 false  
 ```
 
 ### Return String Instead of Printing
-
-Use `table` method to get the formatted string:
-
 ```ruby
 table_string = TypedPrint.table(data)
 puts table_string.upcase
-```
 
-### Working with Different Data Types
+# Markdown format
+markdown_string = TypedPrint.table(data, format: :markdown)
+File.write("table.md", markdown_string)
+````
 
+### Working with Different Data Types
 ```ruby
 mixed_data = [
   { name: "Product A", price: 29.99, in_stock: true, notes: nil },
@@ -125,25 +132,86 @@ TypedPrint.print(mixed_data)
 
 Output:
 ```
-   Name      Price In_stock Notes        
+Name      Price In_stock Notes        
 ----------+-------+---------+-------------
 Product A   29.99 true                  
 Product B   49.99 false    Limited edition
 ```
 
 ## API Reference
-
 `TypedPrint.print(data, options)` Prints the formatted table to stdout and returns `nil`.
 
+
 **Options:**
 - `align: Hash` - Column alignment (`:left`, `:right`, `:center`), defaults to `:left`
 - `only: Array` - Array of column symbols to display
 - `headers: Hash` - Custom headers for columns
+- `format: Symbol` - Output format (`:plain` or `:markdown`), defaults to `:plain`
+- `color: Boolean` - Auto color by type (headers cyan, numbers/true green, false red, nil gray), requires `pastel` gem
+- `colors: Hash` - Manual per-column color map (e.g. `{ name: :cyan, score: :green }`), requires `pastel` gem
 
 `TypedPrint.table(data, options)` returns the formatted table as a string.
 
 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:
+
+```ruby
+gem 'pastel'
+```
+
+**Automatic coloring by type:**
+```ruby
+TypedPrint.print(data, color: true)
+# Headers → cyan, Integer/Float/true → green, false → red, nil → gray
+```
+
+**Manual per-column colors:**
+```ruby
+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/assets/demo.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "typed_print"
+
+data = [
+  { name: "Alice",   score: 98,  active: true  },
+  { name: "Bob",     score: 74,  active: false },
+  { name: "Charlie", score: 61,  active: true  },
+  { name: "Diana",   score: 42,  active: false }
+]
+
+puts "# Basic table"
+TypedPrint.print(data)
+sleep 2
+
+puts "\n# Right-align score column"
+TypedPrint.print(data, align: { score: :right })
+sleep 2
+
+puts "\n# Filter columns"
+TypedPrint.print(data, only: [:name, :score])
+sleep 2
+
+puts "\n# Custom headers"
+TypedPrint.print(data, headers: { name: "Player", score: "Points", active: "Status" })
+sleep 2
+
+puts "\n# Markdown format"
+TypedPrint.print(data, format: :markdown)
+sleep 2
+
+puts "\n# Automatic colors"
+TypedPrint.print(data, color: true)
+sleep 2
+
+puts "\n# Manual colors"
+TypedPrint.print(data, colors: { name: :cyan, score: :green, active: :yellow })

data/assets/demo.tape

@@ -0,0 +1,14 @@
+Output assets/demo.gif
+
+Set FontSize 14
+Set Width 800
+Set Height 600
+Set Theme "Dracula"
+Set Shell "bash"
+Set TypingSpeed 40ms
+
+Sleep 1s
+Type "bundle exec ruby assets/demo.rb"
+Sleep 800ms
+Enter
+Sleep 18s

data/lib/typed_print/table.rb

@@ -1,12 +1,20 @@
 # frozen_string_literal: true
 
+begin
+  require "pastel"
+rescue LoadError
+  # Pastel not installed; color output silently disabled
+end
+
 module TypedPrint
   class Table
-    def initialize(data, alignments = {}, only_columns = nil, custom_headers = {})
+    def initialize(data, alignments = {}, only_columns = nil, custom_headers = {}, color: false, colors: nil)
       @data = data
       @alignments = alignments
       @only_columns = only_columns&.map(&:to_sym)
       @custom_headers = custom_headers.transform_keys(&:to_sym)
+      @color_auto = color
+      @colors = colors&.transform_keys(&:to_sym)
 
       @headers = determine_headers
     end
@@ -19,35 +27,46 @@ module TypedPrint
       end
     end
 
-    def render_plain
+    def to_csv(col_sep: ",")
+      require "csv"
       return "" if @data.empty?
 
-      # Build rows
+      header_row = @headers.map { |h| header_label(h) }
       rows = @data.map { |row| @headers.map { |h| format_value(row[h]) } }
 
-      # Build header strings (with custom headers or capitalized defaults)
-      header_strings = @headers.map do |h|
-        if @custom_headers[h]
-          @custom_headers[h]
-        else
-          h.to_s.split('_').map(&:capitalize).join(' ')
-        end
+      CSV.generate(col_sep: col_sep) do |csv|
+        csv << header_row
+        rows.each { |row| csv << row }
       end
+    end
 
-      # Calculate column widths
-      column_widths = header_strings.map(&:length)
-      rows.each do |row|
+    def render_plain
+      return "" if @data.empty?
+
+      rows_plain = @data.map { |row| @headers.map { |h| format_value(row[h]) } }
+      header_strings_plain = @headers.map { |h| header_label(h) }
+
+      column_widths = header_strings_plain.map(&:length)
+      rows_plain.each do |row|
         row.each_with_index do |cell, i|
           column_widths[i] = [column_widths[i], cell.length].max
         end
       end
 
-      # Build output
+      if color_mode?
+        header_color = @color_auto ? :cyan : nil
+        header_strings_display = header_strings_plain.map { |h| colorize(h, header_color) }
+        rows_display = @data.map { |row| @headers.map { |h| colorize_cell(h, row[h]) } }
+      else
+        header_strings_display = header_strings_plain
+        rows_display = rows_plain
+      end
+
       output = []
-      output << format_row(header_strings, column_widths, :center)
+      output << format_row(header_strings_display, column_widths, :center, header_strings_plain)
       output << separator(column_widths)
-      rows.each do |row|
-        output << format_row(row, column_widths)
+      rows_plain.each_with_index do |plain_row, ri|
+        output << format_row(rows_display[ri], column_widths, nil, plain_row)
       end
 
       output.join("\n")
@@ -56,35 +75,34 @@ module TypedPrint
     def render_markdown
       return "" if @data.empty?
 
-      # Build rows
-      rows = @data.map { |row| @headers.map { |h| format_value(row[h]) } }
-
-      # Build header strings
-      header_strings = @headers.map do |h|
-        if @custom_headers[h]
-          @custom_headers[h]
-        else
-          h.to_s.split('_').map(&:capitalize).join(' ')
-        end
-      end
+      rows_plain = @data.map { |row| @headers.map { |h| format_value(row[h]) } }
+      header_strings_plain = @headers.map { |h| header_label(h) }
 
-      # Calculate column widths for consistent spacing
-      column_widths = header_strings.map(&:length)
-      rows.each do |row|
+      column_widths = header_strings_plain.map(&:length)
+      rows_plain.each do |row|
         row.each_with_index do |cell, i|
           column_widths[i] = [column_widths[i], cell.length].max
         end
       end
 
-      # Build markdown table
+      if color_mode?
+        header_color = @color_auto ? :cyan : nil
+        header_strings_display = header_strings_plain.map { |h| colorize(h, header_color) }
+        rows_display = @data.map { |row| @headers.map { |h| colorize_cell(h, row[h]) } }
+      else
+        header_strings_display = header_strings_plain
+        rows_display = rows_plain
+      end
+
       output = []
-      # Header row
-      output << "| " + header_strings.each_with_index.map { |h, i| h.ljust(column_widths[i]) }.join(" | ") + " |"
-      # Separator row
+      output << "| " + header_strings_display.each_with_index.map { |h, i|
+        pad_right(h, header_strings_plain[i], column_widths[i])
+      }.join(" | ") + " |"
       output << "|" + column_widths.map { |w| "-" * (w + 2) }.join("|") + "|"
-      # Data rows
-      rows.each do |row|
-        output << "| " + row.each_with_index.map { |cell, i| cell.ljust(column_widths[i]) }.join(" | ") + " |"
+      rows_plain.each_with_index do |plain_row, ri|
+        output << "| " + rows_display[ri].each_with_index.map { |cell, i|
+          pad_right(cell, plain_row[i], column_widths[i])
+        }.join(" | ") + " |"
       end
 
       output.join("\n")
@@ -101,7 +119,52 @@ module TypedPrint
       end
     end
 
+    def header_label(h)
+      if @custom_headers[h]
+        @custom_headers[h]
+      else
+        h.to_s.split("_").map(&:capitalize).join(" ")
+      end
+    end
+
+    def color_mode?
+      @color_auto || (@colors && !@colors.empty?)
+    end
+
+    def colorize(text, color)
+      return text unless color && defined?(Pastel)
+      @pastel ||= Pastel.new
+      @pastel.send(color, text)
+    rescue
+      text
+    end
+
+    def colorize_cell(header_key, original_value)
+      plain = format_value(original_value)
+      color = cell_color(header_key, original_value)
+      colorize(plain, color)
+    end
+
+    def cell_color(header_key, value)
+      if @colors
+        @colors[header_key]
+      elsif @color_auto
+        auto_color(value)
+      end
+    end
+
+    def auto_color(value)
+      case value
+      when Integer, Float then :green
+      when true then :green
+      when false then :red
+      when nil then :bright_black
+      end
+    end
+
     def determine_headers
+      return [] if @data.empty?
+
       all_keys = @data.flat_map(&:keys).uniq
 
       if @only_columns
@@ -112,8 +175,9 @@ module TypedPrint
       end
     end
 
-    def format_row(cells, widths, alignment_override = nil)
+    def format_row(cells, widths, alignment_override = nil, plain_cells = nil)
       cells.each_with_index.map do |cell, i|
+        plain_cell = plain_cells ? plain_cells[i] : cell
         width = widths[i]
         header_key = @headers[i]
 
@@ -125,17 +189,25 @@ module TypedPrint
           :left
         end
 
+        padding = width - plain_cell.length
+
         case align
         when :right
-          cell.rjust(width)
+          " " * padding + cell
         when :center
-          cell.center(width)
+          left_pad = padding / 2
+          right_pad = padding - left_pad
+          " " * left_pad + cell + " " * right_pad
         else
-          cell.ljust(width)
+          cell + " " * padding
         end
       end.join(" ")
     end
 
+    def pad_right(colored_text, plain_text, width)
+      colored_text + " " * (width - plain_text.length)
+    end
+
     def separator(widths)
       widths.map { |w| "-" * w }.join("-+-")
     end

data/lib/typed_print/version.rb

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

data/lib/typed_print.rb

@@ -4,13 +4,24 @@ require "typed_print/version"
 require "typed_print/table"
 
 module TypedPrint
-  def self.print(data, align: {}, only: nil, headers: {}, format: :plain)
-    puts table(data, align: align, only: only, headers: headers, format: format)
+  def self.print(data, align: {}, only: nil, headers: {}, format: :plain, color: false, colors: nil)
+    puts table(data, align: align, only: only, headers: headers, format: format, color: color, colors: colors)
     nil
   end
 
-  def self.table(data, align: {}, only: nil, headers: {}, format: :plain)
-    table_obj = TypedPrint::Table.new(data, align, only, headers)
+  def self.table(data, align: {}, only: nil, headers: {}, format: :plain, color: false, colors: nil)
+    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,14 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: typed_print
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Ender Ahmet Yurt
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pastel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: TypedPrint provides zero-dependency, beautifully formatted table output
   for Ruby data structures with automatic column sizing, alignment options, custom
   headers, and column filtering.
@@ -23,6 +37,9 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- assets/demo.gif
+- assets/demo.rb
+- assets/demo.tape
 - lib/typed_print.rb
 - lib/typed_print/table.rb
 - lib/typed_print/version.rb