taql 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 421c44be6a4f2b1d3e932bd05739e9610c75e4881a6528def4195c3f5e92373a
-  data.tar.gz: 313728eefa6a8d1ac1ffba66ffedd4c9d3dca64837a9442f7e7af05d1f3a8ef4
+  metadata.gz: 06cf2ffe64ba72577b6e68ca71d276a1470bba0660521d0df02e9aaff5722112
+  data.tar.gz: 452c4e96ea43fa3df92ee786d1b81116162c8ca97f067306e29cdfe44e98a6ab
 SHA512:
-  metadata.gz: 8e727a99f3b2a96de285341d35f84e86b0c19ff3d51393dd2446625542e10ceb2d7b217cf194404425b5581cb2c8981011c4c27318d9b6cf9307d3cd706c62f4
-  data.tar.gz: 623ccfa2db3c57ebd3030a5936a1db9ae1bee76718e2afe7ef9cf5391e4032b62499cc176a4c8599531434da07fa6f620d5792fcfc6eb037e98998274595ffa0
+  metadata.gz: a9e418d460768051aefecb0445a4ae6233184099aed19f5295e9c709e755b0d02233136d0bdfdb514b8a397d8d0219ec4395ed0c6c65b13c85f33e556821eb61
+  data.tar.gz: 825def129c7a925b42b1656b10825928d6006ceb6be82e912cc40b34d594bf13316a0a9d0d80257ebf192f452a77b0db3520842707256635fb7d41763409f946

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.6.0] - 2026-07-18
+
+- Extract shared `Formatter` base class from `Table` and `List`
+- Unify ActiveRecord connection handling in `Taql.active_record_connection`
+- Fix CLI to avoid the Rails 7.2+ `connection` deprecation warning
+- Remove unused `Table#rows`, `#columns`, and `markdown` writer
+
+## [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/cli.rb

@@ -15,7 +15,7 @@ module Taql
     def run
       silence { require environment_path }
 
-      Taql.execute(*query, options, connection: ActiveRecord::Base.connection)
+      Taql.execute(*query, options, connection: Taql.active_record_connection)
     end
 
     private

data/lib/taql/formatter.rb

@@ -0,0 +1,23 @@
+module Taql
+  class Formatter
+    DASH = "-".freeze
+
+    def initialize(entries)
+      @entries = entries.map { |entry| entry.transform_values(&:to_s) }
+    end
+
+    def headers
+      @headers ||= entries.flat_map(&:keys).uniq
+    end
+
+    def print
+      output if entries.any?
+    end
+
+    alias_method :to_s, :print
+
+    private
+
+    attr_reader :entries
+  end
+end

data/lib/taql/list.rb

@@ -0,0 +1,38 @@
+require_relative "formatter"
+
+module Taql
+  class List < Formatter
+    PIPE = " | ".freeze
+
+    def initialize(entries, terminal_width: nil)
+      super(entries)
+      @terminal_width = terminal_width
+    end
+
+    private
+
+    def max_header_width
+      @max_header_width ||= headers.map(&:length).max
+    end
+
+    def divider_width
+      @terminal_width || 32
+    end
+
+    def output
+      records = entries.map { |entry| [separator, *rows(entry)].join("\n") }
+
+      [*records, separator].join("\n")
+    end
+
+    def separator
+      @separator ||= DASH * divider_width
+    end
+
+    def rows(entry)
+      headers.map do |header|
+        "#{header.upcase.rjust(max_header_width)}#{PIPE}#{entry[header]}"
+      end
+    end
+  end
+end

data/lib/taql/railtie.rb

@@ -6,16 +6,8 @@ module Taql
 
     initializer "taql.initialize" do
       ActiveSupport.on_load(:active_record) do
-        Taql.instance_variable_set(:@default_connection, method(:connection))
+        Taql.default_connection = Taql.method(:active_record_connection)
       end
     end
-
-    def self.connection
-      pool.respond_to?(:lease_connection) ? pool.lease_connection : pool.connection
-    end
-
-    def self.pool
-      ActiveRecord::Base.connection_pool
-    end
   end
 end

data/lib/taql/table.rb

@@ -1,49 +1,36 @@
+require_relative "formatter"
+
 module Taql
-  class Table
-    DASH = "-".freeze
+  class Table < Formatter
     PLUS = "+".freeze
     SPACE = " ".freeze
     VERTICAL_BAR = "|".freeze
 
-    attr_accessor :markdown
+    attr_reader :markdown
 
     def initialize(entries, markdown: false)
-      @entries = entries.map { |entry| entry.transform_values(&:to_s) }
+      super(entries)
       @markdown = markdown
     end
 
-    def body
-      entries.map(&:values)
-    end
-
-    def columns
-      @columns ||= headers.map do |header|
-        [header, *entries.map { |entry| entry[header] }]
-      end
-    end
-
-    def headers
-      @headers ||= entries.flat_map(&:keys).uniq
+    def table_width
+      column_widths.sum + (3 * headers.count) + 1
     end
 
-    def print
-      output if entries.any?
-    end
-
-    def rows
-      [headers, *body]
+    def body
+      entries.map(&:values)
     end
 
     private
 
-    attr_reader :entries
-
     def border
       separator unless markdown
     end
 
     def column_widths
-      @column_widths ||= columns.map { |column| column.map(&:length).max }
+      @column_widths ||= headers.map do |header|
+        [header, *entries.map { |entry| entry[header] }].map(&:length).max
+      end
     end
 
     def edge
@@ -69,13 +56,11 @@ module Taql
     end
 
     def separator
-      columns.map.with_index do |column, index|
-        Array.new(column_widths[index] + 2, DASH).join
-      end.then do |columns|
-        [edge, columns.join(edge), edge].join
+      column_widths.map do |width|
+        DASH * (width + 2)
+      end.then do |segments|
+        [edge, segments.join(edge), edge].join
       end
     end
-
-    alias_method :to_s, :print
   end
 end

data/lib/taql/version.rb

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

data/lib/taql.rb

@@ -1,20 +1,44 @@
+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
 
+    def active_record_connection
+      pool = ActiveRecord::Base.connection_pool
+      pool.respond_to?(:lease_connection) ? pool.lease_connection : pool.connection
+    end
+
     private
 
+    def formatter(results, markdown:)
+      table = Table.new(results, markdown: markdown)
+      width = terminal_width
+
+      if !markdown && width && table.table_width > width
+        List.new(results, terminal_width: width)
+      else
+        table
+      end
+    end
+
+    def terminal_width
+      IO.console&.winsize&.last
+    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.6.0
 platform: ruby
 authors:
 - Ariel Rzezak
@@ -29,6 +29,8 @@ files:
 - exe/taql
 - lib/taql.rb
 - lib/taql/cli.rb
+- lib/taql/formatter.rb
+- lib/taql/list.rb
 - lib/taql/railtie.rb
 - lib/taql/table.rb
 - lib/taql/version.rb
@@ -54,7 +56,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.14
 specification_version: 4
 summary: Tableize Rails SQL queries
 test_files: []