taql 0.2.6 → 0.3.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 51560820483201d09e0deeeb279062896454dd4e74796461e6513800ef39a1a5
-  data.tar.gz: a6bb0f39c93942d1fd4be527ecb9c59fffced9a5aa8ab490a4a340009d418388
+  metadata.gz: 66db91199e02a0312a18f93208174c5ef48002e60415d0b36680c6eaa3a02d61
+  data.tar.gz: 31358e92a67034c323975e931ab54102d6ee3cb40f5bb191fa06f5e7687f8414
 SHA512:
-  metadata.gz: f9fa6aa118887bf1302c65b12623e4becdb30aa3a1c0a7d4239f768591b8bc937a1d8ad0604f8c2b0b856bd9452fc45aae7bd970320228288a56c7b81a9e5f9b
-  data.tar.gz: 87aff05a7d6b00528811490d27699ce15c3ad4770a582a716e0c9904958f4bbd376228a6e507c40aae48edc05f2c25c106cb548633ae924785a321244218c04c
+  metadata.gz: 7c68d0a8f118fac312d48864fa64e56dc5d56b0ffc26dfb7b56196a8bc18387517c5d1f9fb69c8835bf84514962b49a7756b01a3e7f55f777e673a61b342953c
+  data.tar.gz: 43f2896a0c7d00455ff599425e5b22d08e0f837950fa8af44e239dfdf37a05db7e83776726ff21417642252617aabfeb852fdaf4e752af8b98c135155991565c

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.3.7] - 2025-09-01
+
+- Add Railtie
+
+## [0.2.7] - 2025-06-27
+
+- Provide default options
+
 ## [0.2.6] - 2025-05-17
 
 - Fix version

data/README.md

@@ -1,20 +1,20 @@
 # Taql
 
-TODO: Delete this and the text below, and describe your gem
-
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/taql`. To experiment with that code, run `bin/console` for an interactive prompt.
+Taql is a lightweight Ruby gem that provides a convenient interface for executing SQL queries with beautifully formatted results. Whether you need a command-line SQL client for quick database exploration or a programmatic way to run queries within your Ruby application, Taql has you covered.
 
 ## Installation
 
-TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
-
 Install the gem and add to the application's Gemfile by executing:
 
-    $ bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+```sh
+$ bundle add taql
+```
 
 If bundler is not being used to manage dependencies, install the gem by executing:
 
-    $ gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+```sh
+$ gem install taql
+```
 
 ## Usage
 
@@ -76,14 +76,18 @@ The return value is a native PG::Result object, which supports mapping or extrac
 | 20240815131806 |
 | 20240815131747 |
 +----------------+
-=> \#<PG::Result:0x000000012ebf6a38 status=PGRES_TUPLES_OK ntuples=3 nfields=1 cmd_tuples=3>
+=> #<PG::Result:0x000000012ebf6a38 status=PGRES_TUPLES_OK ntuples=3 nfields=1 cmd_tuples=3>
 ```
 
 ## 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.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+## Releasing
+
+To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
 

data/lib/taql/railtie.rb

@@ -0,0 +1,13 @@
+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, -> { ActiveRecord::Base.connection_pool.connection })
+      end
+    end
+  end
+end

data/lib/taql/version.rb

@@ -1,3 +1,3 @@
 module Taql
-  VERSION = "0.2.6"
+  VERSION = "0.3.7"
 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.6
+  version: 0.3.7
 platform: ruby
 authors:
 - Ariel Rzezak
@@ -27,6 +27,7 @@ files:
 - 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 +52,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 3.7.1
 specification_version: 4
 summary: Tableize Rails SQL queries
 test_files: []