taql 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 421c44be6a4f2b1d3e932bd05739e9610c75e4881a6528def4195c3f5e92373a
-  data.tar.gz: 313728eefa6a8d1ac1ffba66ffedd4c9d3dca64837a9442f7e7af05d1f3a8ef4
+  metadata.gz: a347baf32a9b92dccb94907b40b42d35d00a5f8929f5938842e774d0dfe810a6
+  data.tar.gz: 261b1878bc277f27c9d803a675f7ccc085c71eea9639bcdcdd8e6d44b28d5c82
 SHA512:
-  metadata.gz: 8e727a99f3b2a96de285341d35f84e86b0c19ff3d51393dd2446625542e10ceb2d7b217cf194404425b5581cb2c8981011c4c27318d9b6cf9307d3cd706c62f4
-  data.tar.gz: 623ccfa2db3c57ebd3030a5936a1db9ae1bee76718e2afe7ef9cf5391e4032b62499cc176a4c8599531434da07fa6f620d5792fcfc6eb037e98998274595ffa0
+  metadata.gz: f0aa1e50f2e9adfcc0013fe53d2a16d44f1b67cb3204c14f86cdff0c30a6e5b213eb5710c1573aa8be0cc1080f057b77e050882b762d23fb1f86b6f5f8e14cdb
+  data.tar.gz: 817431a4c417af5c022fc893e0e40b5c8501f0e1470f64e5049b0a916cf20c448d574b48e62562c5e4f2b15bf150724c8ad5aa0f72cc404c6cfd928bcc64c87b

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.5.0] - 2026-03-11
+
+- Auto-switch to vertical list layout when table exceeds terminal width
+- Add List class for vertical output formatting
+- Right-align headers in vertical list output
+
 ## [0.4.0] - 2026-03-11
 
 - Fix CLI to use passed argv instead of global ARGV

data/CLAUDE.md

@@ -22,12 +22,13 @@ bin/setup                 # Install dependencies
 
 - `lib/taql.rb` — Main module; `.execute(query, options, connection:)` entry point
 - `lib/taql/table.rb` — Table formatting (ASCII borders + Markdown mode); handles column width calculation
+- `lib/taql/list.rb` — Vertical list formatting; used when table exceeds terminal width
 - `lib/taql/cli.rb` — CLI parser (`--markdown/-m` flag); loads Rails env, calls `Taql.execute`
 - `lib/taql/railtie.rb` — Rails integration; sets `@default_connection` from ActiveRecord pool
 - `exe/taql` — CLI executable entry point
 
-**Flow:** CLI loads Rails environment → parses args → `Taql.execute` uses ActiveRecord connection (from Railtie or explicit) → wraps result in `Table` → prints formatted output.
+**Flow:** CLI loads Rails environment → parses args → `Taql.execute` uses ActiveRecord connection (from Railtie or explicit) → auto-selects `Table` or `List` based on terminal width → prints formatted output.
 
 ## Testing
 
-Tests use Minitest with mocked database connections. Test files mirror lib structure: `test_taql.rb`, `test_table.rb`, `test_cli.rb`. CI runs on Ruby 3.4 via GitHub Actions.
+Tests use Minitest with mocked database connections. Test files mirror lib structure: `test_taql.rb`, `test_table.rb`, `test_list.rb`, `test_cli.rb`. CI runs on Ruby 3.4 via GitHub Actions.

data/README.md

@@ -27,6 +27,13 @@ $ gem install taql
 +----+----------------------+-----------+----------------------+
 ```
 
+Use `--version` (or `-v`) to check the installed version:
+
+```sh
+$ taql --version
+taql 0.4.0
+```
+
 Use the `--markdown` (or `-m`) flag to generate Markdown output:
 
 ```sh
@@ -52,7 +59,7 @@ Any valid SQL SELECT statement can be executed:
 Within a console:
 
 ```ruby
->> Taql.execute("select id, email from users order by created at limit 3").pluck("email")
+>> Taql.execute("select id, email from users order by created_at limit 3").pluck("email")
    (1.2ms)  select id, email from users limit 3
 +----+---------------------+
 | ID | EMAIL               |
@@ -79,6 +86,21 @@ The return value is a native PG::Result object, which supports mapping or extrac
 => #<PG::Result:0x000000012ebf6a38 status=PGRES_TUPLES_OK ntuples=3 nfields=1 cmd_tuples=3>
 ```
 
+When results exceed terminal width, output automatically switches to a vertical list format:
+
+```
+----------------------------------------
+              ID | 1
+           ADMIN | false
+           EMAIL | alice@example.com
+      CREATED_AT | 2021-10-01 00:00:00 UTC
+----------------------------------------
+```
+
+## TODO
+
+- [ ] `--list` / `--table` CLI flags to override auto-detection
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
@@ -91,7 +113,7 @@ To release a new version, update the version number in `version.rb`, and then ru
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/taql. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/taql/blob/main/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/arzezak/taql. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/arzezak/taql/blob/main/CODE_OF_CONDUCT.md).
 
 ## License
 
@@ -99,4 +121,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the Taql project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/taql/blob/main/CODE_OF_CONDUCT.md).
+Everyone interacting in the Taql project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/arzezak/taql/blob/main/CODE_OF_CONDUCT.md).

data/lib/taql/list.rb

@@ -0,0 +1,49 @@
+module Taql
+  class List
+    DASH = "-".freeze
+    PIPE = " | ".freeze
+
+    def initialize(entries, terminal_width: nil)
+      @entries = entries.map { |entry| entry.transform_values(&:to_s) }
+      @terminal_width = terminal_width
+    end
+
+    def print
+      output if entries.any?
+    end
+
+    private
+
+    attr_reader :entries
+
+    def headers
+      @headers ||= entries.flat_map(&:keys).uniq
+    end
+
+    def max_header_width
+      @max_header_width ||= headers.map(&:length).max
+    end
+
+    def divider_width
+      @terminal_width&.finite? ? @terminal_width : 32
+    end
+
+    def output
+      records = entries.map { |entry| [separator, *rows(entry)].join("\n") }
+
+      [*records, separator].join("\n")
+    end
+
+    def separator
+      DASH * divider_width
+    end
+
+    def rows(entry)
+      headers.map do |header|
+        "#{header.upcase.rjust(max_header_width)}#{PIPE}#{entry[header]}"
+      end
+    end
+
+    alias_method :to_s, :print
+  end
+end

data/lib/taql/railtie.rb

@@ -6,7 +6,7 @@ module Taql
 
     initializer "taql.initialize" do
       ActiveSupport.on_load(:active_record) do
-        Taql.instance_variable_set(:@default_connection, method(:connection))
+        Taql.default_connection = method(:connection)
       end
     end
 

data/lib/taql/table.rb

@@ -12,6 +12,10 @@ module Taql
       @markdown = markdown
     end
 
+    def table_width
+      column_widths.sum + (3 * columns.count) + 1
+    end
+
     def body
       entries.map(&:values)
     end

data/lib/taql/version.rb

@@ -1,3 +1,3 @@
 module Taql
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

data/lib/taql.rb

@@ -1,20 +1,37 @@
+require "io/console"
 require_relative "taql/cli"
+require_relative "taql/list"
 require_relative "taql/table"
 require_relative "taql/version"
 require_relative "taql/railtie" if defined?(Rails)
 
 module Taql
   class << self
+    attr_writer :default_connection
+
     def execute(query, options = {}, connection: nil)
       (connection || default_connection).execute(query).tap do |result|
         if (results = result.entries).any?
-          $stdout.puts Table.new(results, markdown: options[:markdown])
+          $stdout.puts formatter(results, markdown: options[:markdown])
         end
       end
     end
 
     private
 
+    def formatter(results, markdown: false)
+      table = Table.new(results, markdown: markdown)
+      if !markdown && table.table_width > terminal_width
+        List.new(results, terminal_width: terminal_width)
+      else
+        table
+      end
+    end
+
+    def terminal_width
+      IO.console&.winsize&.last || Float::INFINITY
+    end
+
     def default_connection
       @default_connection&.call || raise("Taql not properly initialized with Rails")
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: taql
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Ariel Rzezak
@@ -29,6 +29,7 @@ files:
 - exe/taql
 - lib/taql.rb
 - lib/taql/cli.rb
+- lib/taql/list.rb
 - lib/taql/railtie.rb
 - lib/taql/table.rb
 - lib/taql/version.rb