typed_print 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0b589c4ef3b3bb0bbc3629c7e6a2a74de7b74a7124bceb46aadc66a7fe957de0
+  data.tar.gz: 557218da71a928e0ed694c03e07bce59c343226642dcdc1f9231290051d02aaf
+SHA512:
+  metadata.gz: 28efd87ec5f95353c09ae1c9954ee52f843d3031b0228597cbe9a62e13e88eea41bdb87dbd010ca541e0579af6c40cce4fa1bc8e8a90724480ec57e2b3770bb9
+  data.tar.gz: f9e4a8604633020344fd0b41926eb5b99e9af31075dd7bca0cdcc3ef79871ff0c57643b9a0f24214280ef7a8c84a4ed5ec36a6bae30d36914f0c576b223d5d68

data/CHANGELOG.md

@@ -0,0 +1,13 @@
+## [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
+- 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/CODE_OF_CONDUCT.md

@@ -0,0 +1,10 @@
+# Code of Conduct
+
+"typed_print" follows [The Ruby Community Conduct Guideline](https://www.ruby-lang.org/en/conduct) in all "collaborative space", which is defined as community communications channels (such as mailing lists, submitted patches, commit comments, etc.):
+
+* Participants will be tolerant of opposing views.
+* Participants must ensure that their language and actions are free of personal attacks and disparaging personal remarks.
+* When interpreting the words and actions of others, participants should always assume good intentions.
+* Behaviour which can be reasonably considered harassment will not be tolerated.
+
+If you have any concerns about behaviour within this project, please contact us at ["enderyurt@gmail.com"](mailto:"enderyurt@gmail.com").

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Ender Ahmet Yurt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,159 @@
+# TypedPrint
+
+Beautiful, aligned table output for Ruby hashes and objects with zero dependencies.
+
+[![Gem Version](https://badge.fury.io/rb/typed_print.svg)](https://badge.fury.io/rb/typed_print)
+[![Ruby](https://github.com/enderahmetyurt/typed_print/actions/workflows/main.yml/badge.svg)](https://github.com/enderahmetyurt/typed_print/actions/workflows/main.yml)
+[![Ruby Version](https://img.shields.io/badge/ruby->=%202.6-blue.svg)](https://www.ruby-lang.org/)
+[![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)
+
+## 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:
+
+```ruby
+gem 'typed_print'
+```
+
+Or install it yourself:
+
+```bash
+gem install typed_print
+```
+
+## Usage
+
+### Basic Usage
+
+```ruby
+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:
+
+```ruby
+TypedPrint.print(data, align: { score: :right })
+```
+
+Output:
+```
+ Name  Score Active 
+------+------+-------
+Alice   100 true   
+Bob      42 false  
+```
+
+### Filter Columns
+
+Show only specific columns:
+
+```ruby
+TypedPrint.print(data, only: [:name, :score])
+```
+
+Output:
+```
+ 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 
+---------+------+-------
+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
+
+```ruby
+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](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[test rubocop]

data/lib/typed_print/table.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module TypedPrint
+  class Table
+    def initialize(data, alignments = {}, only_columns = nil, custom_headers = {})
+      @data = data
+      @alignments = alignments
+      @only_columns = only_columns&.map(&:to_sym)
+      @custom_headers = custom_headers.transform_keys(&:to_sym)
+
+      @headers = determine_headers
+    end
+
+    def render
+      return "" if @data.empty?
+
+      # Build rows
+      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
+          # Capitalize each word in the header
+          h.to_s.split('_').map(&:capitalize).join(' ')
+        end
+      end
+
+      # Calculate column widths
+      column_widths = header_strings.map(&:length)
+      rows.each do |row|
+        row.each_with_index do |cell, i|
+          column_widths[i] = [column_widths[i], cell.length].max
+        end
+      end
+
+      # Build output
+      output = []
+      output << format_row(header_strings, column_widths, :center)
+      output << separator(column_widths)
+      rows.each do |row|
+        output << format_row(row, column_widths)
+      end
+
+      output.join("\n")
+    end
+
+    private
+
+    def format_value(value)
+      case value
+      when true then "true"
+      when false then "false"
+      when nil then ""
+      else value.to_s
+      end
+    end
+
+    def determine_headers
+      all_keys = @data.flat_map(&:keys).uniq
+
+      if @only_columns
+        # Only include specified columns, in the order specified
+        @only_columns.select { |key| all_keys.include?(key) }
+      else
+        # Preserve the order from the first hash, but ensure all keys are included
+        first_item_keys = @data.first.keys
+        # Then add any additional keys from other items that weren't in the first
+        first_item_keys + (all_keys - first_item_keys)
+      end
+    end
+
+    def format_row(cells, widths, alignment_override = nil)
+      cells.each_with_index.map do |cell, i|
+        width = widths[i]
+
+        # Determine alignment - need to use the header key, not the cell value
+        header_key = @headers[i]
+
+        align = if alignment_override
+          alignment_override
+        elsif @alignments[header_key]
+          @alignments[header_key]
+        else
+          :left
+        end
+
+        case align
+        when :right
+          cell.rjust(width)
+        when :center
+          cell.center(width)
+        else # :left
+          cell.ljust(width)
+        end
+      end.join(" ")
+    end
+
+    def separator(widths)
+      widths.map { |w| "-" * w }.join("-+-")
+    end
+  end
+end

data/lib/typed_print/version.rb

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

data/lib/typed_print.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "typed_print/version"
+require "typed_print/table"
+
+require "typed_print/version"
+require "typed_print/table"
+
+module TypedPrint
+  def self.print(data, align: {}, only: nil, headers: {})
+    puts table(data, align: align, only: only, headers: headers)
+    nil
+  end
+
+  def self.table(data, align: {}, only: nil, headers: {})
+    table_obj = TypedPrint::Table.new(data, align, only, headers)
+    table_obj.render
+  end
+end

data/sig/typed_print.rbs

@@ -0,0 +1,4 @@
+module TypedPrint
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification
+name: typed_print
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ender Ahmet Yurt
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: TypedPrint provides zero-dependency, beautifully formatted table output
+  for Ruby data structures with automatic column sizing, alignment options, custom
+  headers, and column filtering.
+email:
+- enderyurt@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/typed_print.rb
+- lib/typed_print/table.rb
+- lib/typed_print/version.rb
+- sig/typed_print.rbs
+homepage: https://github.com/enderahmetyurt/typed_print
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/enderahmetyurt/typed_print
+  source_code_uri: https://github.com/enderahmetyurt/typed_print
+  changelog_uri: https://github.com/enderahmetyurt/typed_print/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Beautiful, aligned table output for Ruby hashes and objects
+test_files: []