migration_queries 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 356aa56fbb9c867de2ff9a1ec41c1d4305031f65ba10e8ea50ea523b70896046
-  data.tar.gz: ec60f761a3f8a81aa4247ff3b4305843cde952951780e5a2c99cbc15b2b8c46a
+  metadata.gz: 4ff997e1ebe254c3fd23a538365fa0cafbcfc010c3e5199054202ed6bd1b2851
+  data.tar.gz: 70bef9fc0517130bc9158cc1f48c32b38c098ab9f93248de3957da1ea52ae87a
 SHA512:
-  metadata.gz: d2572cb64efab92fcda737c55dda35c7cc1ce8b0786f23435538335d45dc5631663a89f1fba5f2a49b6d20b647ecfff6190309d04750f775bbd6a0d4ec2adb05
-  data.tar.gz: da96b269d7049e01c2289a8cbaae3ca7789eb78961bbb0fd6d3d233577d038ebb862545c7cf6b7dfd9d8b58fa1a07e4c78bf2cc51ad2dca3676a28fe663297de
+  metadata.gz: 55526a659e9ea130374069cc062a9895ffe8734845f91490514a64ad24ae11b3b574c7ccdc2011364585a2d63ec4037596a3d31c33e5e6724036714695b59f6a
+  data.tar.gz: f80f52f70194dd955c697d931ac42cc6c08b85cdd67e2ffb717ec5c1dc1b307e1d5b40f383117774c769a2630aec96777ac6cb75076fdf0db16dec7a8ee244ab

data/README.md

@@ -1,28 +1,46 @@
 # MigrationQueries
 
-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/migration_queries`. To experiment with that code, run `bin/console` for an interactive prompt.
+The `migration_queries` gem improves tracking of migration queries in Ruby on Rails applications. It provides a simple way to log and analyze the SQL queries generated by ActiveRecord migrations, helping developers optimize their database interactions.
 
 ## 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:
+Add this gem to development dependencies in your `Gemfile`:
 
-```bash
-bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+```ruby
+group :development do
+  gem 'migration_queries'
+end
 ```
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+Then, run `bundle install` to install the gem.
+
+And then execute:
 
 ```bash
-gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+bundle exec rake migration_queries:install
 ```
 
 ## Usage
 
-TODO: Write usage instructions here
+The gem is going to automatically track migration queries executed by ActiveRecord. You can view the logged queries in your Rails console or in the log files.
+
+Example migration file after running migration and logging queries:
+
+```ruby
+class AddExampleTable < ActiveRecord::Migration[6.0]
+  def change
+    create_table :example do |t|
+      t.string :name
+      t.timestamps
+    end
+  end
+end
+=begin Migration Queries
+CREATE TABLE "example" ("id" bigserial primary key, "name" character varying, "created_at" timestamp(6) NOT NULL, "updated_at" timestamp(6) NOT NULL)
+
+# Migration Queries written on 2025-07-04 12:36:54 +0200
+=end
+```
 
 ## Development
 

data/lib/migration_queries/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MigrationQueries
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: migration_queries
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Szymon Lipka