TypedPrint

Beautiful, aligned table output for Ruby hashes and objects with zero dependencies.

Features

• 🚀 Zero 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

Installation

Add this line to your application's Gemfile:

gem 'typed_print'

Or install it yourself:

gem install typed_print

Usage

Basic Usage

require 'typed_print'

data = [
  { name: "Alice", score: 100, active: true },
  { name: "Bob", score: 42, active: false }
]

TypedPrint.print(data)

Output:

 Name  Score Active 
------+------+-------
Alice   100 true   
Bob      42 false  

Column Alignment

Right-align specific columns:

TypedPrint.print(data, align: { score: :right })

Output:

 Name  Score Active 
------+------+-------
Alice   100 true   
Bob      42 false  

Filter Columns

Show only specific columns:

TypedPrint.print(data, only: [:name, :score])

Output:

 Name  Score 
------+------
Alice   100 
Bob      42 

Custom Headers

Rename columns for display:

TypedPrint.print(data, headers: { name: "Username", score: "Points", active: "Status" })

Output:

 Username Points Status 
---------+------+-------
Alice       100 true   
Bob          42 false  

Return String Instead of Printing

Use table method to get the formatted string:

table_string = TypedPrint.table(data)
puts table_string.upcase

Working with Different Data Types

mixed_data = [
  { name: "Product A", price: 29.99, in_stock: true, notes: nil },
  { name: "Product B", price: 49.99, in_stock: false, notes: "Limited edition" }
]

TypedPrint.print(mixed_data)

Output:

   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

TypedPrint.table(data, options) returns the formatted table as a string.

Same options as print.

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests.

To install this gem onto your local machine, run bundle exec rake install.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/yourusername/typed_print.

License

The gem is available as open source under the terms of the MIT License.