taql 0.2.7 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b082583e00ba4c89bd7905a2c21226bc44145f559716a636c2f3e9d72ca6ee1b
-  data.tar.gz: 8b89177e2acdf34b5e176c9015493820e83a9cbb32a83f40a0b78e99fc669d0b
+  metadata.gz: 421c44be6a4f2b1d3e932bd05739e9610c75e4881a6528def4195c3f5e92373a
+  data.tar.gz: 313728eefa6a8d1ac1ffba66ffedd4c9d3dca64837a9442f7e7af05d1f3a8ef4
 SHA512:
-  metadata.gz: c3e64fe6ca82e0d5312f8f77db5e71b5b497b3dca55fab05fb86628e50c649f1d8e6e62b18f20f69970edb88567b2ad37db99ae22878da7601f3c734b6112c69
-  data.tar.gz: 23b6985df223ba7ef6cba06989ab74c24dd0f37c7abde78151dd83b8196db020058aa8ba911b41b505846b3ca4f882b7d8b854f5b7244a0f28174c09c2a615d7
+  metadata.gz: 8e727a99f3b2a96de285341d35f84e86b0c19ff3d51393dd2446625542e10ceb2d7b217cf194404425b5581cb2c8981011c4c27318d9b6cf9307d3cd706c62f4
+  data.tar.gz: 623ccfa2db3c57ebd3030a5936a1db9ae1bee76718e2afe7ef9cf5391e4032b62499cc176a4c8599531434da07fa6f620d5792fcfc6eb037e98998274595ffa0

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.4.0] - 2026-03-11
+
+- Fix CLI to use passed argv instead of global ARGV
+- Fix CLI to use ActiveRecord connection directly after booting Rails
+- Memoize Table headers, columns, and column_widths
+- Fix headers deduplication for heterogeneous entries
+- Raise error when CLI is invoked without a query
+- Add --version flag to CLI
+- Support Rails 7.2+ lease_connection
+
+## [0.3.7] - 2025-09-01
+
+- Add Railtie
+
 ## [0.2.7] - 2025-06-27
 
 - Provide default options

data/CLAUDE.md

@@ -0,0 +1,33 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## About
+
+Taql is a Ruby gem that formats SQL query results into pretty-printed tables (ASCII or Markdown). Provides both a CLI (`taql "SELECT ..."`) and programmatic API (`Taql.execute(query)`) for use with Rails/ActiveRecord.
+
+## Commands
+
+```bash
+bundle exec rake          # Run tests + lint (default)
+rake test                 # Run all tests (minitest)
+rake test TEST=test/test_table.rb                        # Single test file
+rake test TEST=test/test_table.rb TESTOPTS="--name=test_something"  # Single test method
+rake standard             # Lint (Standard Ruby)
+rake standard:fix         # Auto-fix lint issues
+bin/setup                 # Install dependencies
+```
+
+## Architecture
+
+- `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/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.
+
+## 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.

data/RELEASING.md

@@ -0,0 +1,7 @@
+# Releasing
+
+1. Update version in `lib/taql/version.rb`
+2. Run `bundle install` to update lockfile
+3. Update `CHANGELOG.md` with new version and changes
+4. Commit: `git commit -am "Release vX.Y.Z"`
+5. Run `bundle exec rake release` (builds gem, creates git tag, pushes to RubyGems)

data/lib/taql/cli.rb

@@ -5,14 +5,17 @@ module Taql
     attr_reader :options, :query
 
     def initialize(argv)
+      @argv = argv
       @options = {markdown: false}
       @query = parse!
+
+      raise ArgumentError, "Usage: taql [--markdown] QUERY" if @query.empty?
     end
 
     def run
       silence { require environment_path }
 
-      Taql.execute(*query, options)
+      Taql.execute(*query, options, connection: ActiveRecord::Base.connection)
     end
 
     private
@@ -24,7 +27,9 @@ module Taql
     def parse!
       OptionParser.new do |parser|
         parser.on("-m", "--markdown", TrueClass, "Output table in Markdown")
-      end.parse!(into: options)
+        parser.program_name = "taql"
+        parser.version = Taql::VERSION
+      end.parse!(@argv, into: options)
     end
 
     def silence

data/lib/taql/railtie.rb

@@ -0,0 +1,21 @@
+require "rails/railtie"
+
+module Taql
+  class Railtie < Rails::Railtie
+    railtie_name :taql
+
+    initializer "taql.initialize" do
+      ActiveSupport.on_load(:active_record) do
+        Taql.instance_variable_set(:@default_connection, method(: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

@@ -17,13 +17,13 @@ module Taql
     end
 
     def columns
-      headers.map do |header|
+      @columns ||= headers.map do |header|
         [header, *entries.map { |entry| entry[header] }]
       end
     end
 
     def headers
-      entries.map(&:keys).uniq.flatten
+      @headers ||= entries.flat_map(&:keys).uniq
     end
 
     def print
@@ -43,7 +43,7 @@ module Taql
     end
 
     def column_widths
-      columns.map { |column| column.map(&:length).max }
+      @column_widths ||= columns.map { |column| column.map(&:length).max }
     end
 
     def edge

data/lib/taql/version.rb

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

data/lib/taql.rb

@@ -1,15 +1,22 @@
 require_relative "taql/cli"
 require_relative "taql/table"
 require_relative "taql/version"
+require_relative "taql/railtie" if defined?(Rails)
 
 module Taql
-  class Error < StandardError; end
-
-  def self.execute(query, options = {}, connection: ActiveRecord::Base.connection)
-    connection.execute(query).tap do |result|
-      if (results = result.entries).any?
-        $stdout.puts Table.new(results, markdown: options[:markdown])
+  class << self
+    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])
+        end
       end
     end
+
+    private
+
+    def default_connection
+      @default_connection&.call || raise("Taql not properly initialized with Rails")
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: taql
 version: !ruby/object:Gem::Version
-  version: 0.2.7
+  version: 0.4.0
 platform: ruby
 authors:
 - Ariel Rzezak
@@ -18,15 +18,18 @@ extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
+- CLAUDE.md
 - CODE_OF_CONDUCT.md
 - LICENSE.txt
 - README.md
+- RELEASING.md
 - Rakefile
 - bin/console
 - bin/setup
 - exe/taql
 - lib/taql.rb
 - lib/taql/cli.rb
+- lib/taql/railtie.rb
 - lib/taql/table.rb
 - lib/taql/version.rb
 - taql.gemspec
@@ -51,7 +54,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Tableize Rails SQL queries
 test_files: []