rails-pg-extras 5.6.14 → 5.6.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 527209c0372ab51aa819a88d39fca67a8608c4c19c1f05e7229faa2b8fbce050
-  data.tar.gz: 2dd5e86b330f95e680e495d3d02bab62dfd809462e90a125e9d5f592b20cc700
+  metadata.gz: e1b176294ac8dfee0602dac9a7719b685cbe2b4303bf96421853a87a1f7fdd1b
+  data.tar.gz: 2a9208ba3675bda0ff32fa6da55cf68f8bcfa70b1ecdf51d3456d505acaf56a9
 SHA512:
-  metadata.gz: 02ab457a4fa05efd333e585e8413d5ea6817463a063fd4d9f546f05882ca7698d9e55f9640ee7390002afeb9bf1e637e61e24abe79487f2a788b7d2587bdb26c
-  data.tar.gz: 8d9ecd37ac60697ddbae46fd2e955cc26b35d56ce8252913247f552bed552b235d2eebe6adca1759e09628dfe644e656cf384ca78146b40a4b1c44cb13c21088
+  metadata.gz: 6fde9b532cc4afeb2581405cb11f51d965de7d5a68f7dd89feddf2646a9d1c2281b354a8f7a67d74378758f8f1cacf6658dabac8dc8d9b30f2b387231fb23dc9
+  data.tar.gz: 341f88edb6018e20d42994f9520961a0f5fc0c0a82118d4ceff76b626ef86188d7f9253b92b964048036555ab819b56eead63943cfa3f1e364871c051f4c9d5b

data/.github/workflows/ci.yml

@@ -15,13 +15,6 @@ jobs:
         ruby-version: ['3.4', '3.3', '3.2', '3.1', '3.0', '2.7']
     steps:
       - uses: actions/checkout@v4
-      - name: Run PostgreSQL 12
-        run: |
-          docker run --env POSTGRES_USER=postgres \
-            --env POSTGRES_DB=rails-pg-extras-test \
-            --env POSTGRES_PASSWORD=secret \
-            -d -p 5432:5432 postgres:12.20-alpine \
-            postgres -c shared_preload_libraries=pg_stat_statements
       - name: Run PostgreSQL 13
         run: |
           docker run --env POSTGRES_USER=postgres \
@@ -57,6 +50,13 @@ jobs:
             --env POSTGRES_PASSWORD=secret \
             -d -p 5437:5432 postgres:17.0-alpine \
             postgres -c shared_preload_libraries=pg_stat_statements
+      - name: Run PostgreSQL 18
+        run: |
+          docker run --env POSTGRES_USER=postgres \
+            --env POSTGRES_DB=rails-pg-extras-test \
+            --env POSTGRES_PASSWORD=secret \
+            -d -p 5438:5432 postgres:18.1-alpine \
+            postgres -c shared_preload_libraries=pg_stat_statements
           sleep 5
       - name: Set up Ruby ${{ matrix.ruby-version }}
         uses: ruby/setup-ruby@v1
@@ -71,11 +71,6 @@ jobs:
           bundle config set --local path 'vendor/bundle'
           bundle install
           sleep 10
-      - name: Run tests for PG 12
-        env:
-          PG_VERSION: 12
-        run: |
-          bundle exec rspec spec/
       - name: Run tests for PG 13
         env:
           PG_VERSION: 13
@@ -101,4 +96,9 @@ jobs:
           PG_VERSION: 17
         run: |
           bundle exec rspec spec/
+      - name: Run tests for PG 18
+        env:
+          PG_VERSION: 18
+        run: |
+          bundle exec rspec spec/
 

data/README.md

@@ -158,6 +158,22 @@ RailsPgExtras.configure do |config|
 end
 ```
 
+You can also configure a default ignore list for the heuristic missing foreign key constraints checker. This helps skip columns that you know should not be considered foreign keys.
+
+```ruby
+RailsPgExtras.configure do |config|
+  # Accepts an Array or a comma-separated String of entries like:
+  # - "posts.category_id" (ignore a specific table+column)
+  # - "category_id"       (ignore this column name for all tables)
+  # - "posts.*"           (ignore all columns on a table)
+  # - "*"                 (ignore everything)
+  config.missing_fk_constraints_ignore_list = ["posts.category_id", "category_id"]
+
+  # Or as a comma-separated string:
+  # config.missing_fk_constraints_ignore_list = "posts.category_id, category_id"
+end
+```
+
 ## Available methods
 
 ### `measure_queries`
@@ -262,6 +278,26 @@ RailsPgExtras.missing_fk_constraints(args: { table_name: "users" })
 
 `table_name` argument is optional, if omitted, method will display missing fk constraints for all the tables.
 
+You can optionally pass an `ignore_list` to skip known false positives detected by the heuristic checker. It accepts an Array or a comma-separated String. Entries can be:
+- "posts.category_id" to ignore a specific table+column
+- "category_id" to ignore a column name for all tables
+- "posts.*" to ignore all columns on a specific table
+- "*" to ignore everything
+
+Examples:
+
+```ruby
+# Per-call ignore list
+RailsPgExtras.missing_fk_constraints(args: {
+  ignore_list: ["posts.category_id", "legacy_id", "temp_tables.*"]
+})
+
+# As a comma-separated string
+RailsPgExtras.missing_fk_constraints(args: {
+  ignore_list: "posts.category_id, legacy_id, temp_tables.*"
+})
+```
+
 ### `table_schema`
 
 This method displays structure of a selected table, listing its column names, together with types, null constraints, and default values.

data/docker-compose.yml.sample

@@ -1,13 +1,4 @@
 services:
-  postgres12:
-    image: postgres:12.20-alpine
-    command: postgres -c shared_preload_libraries=pg_stat_statements
-    environment:
-      POSTGRES_USER: postgres
-      POSTGRES_DB: rails-pg-extras-test
-      POSTGRES_PASSWORD: secret
-    ports:
-      - '5432:5432'
   postgres13:
     image: postgres:13.16-alpine
     command: postgres -c shared_preload_libraries=pg_stat_statements
@@ -45,7 +36,7 @@ services:
     ports:
       - '5436:5432'
   postgres17:
-    image: postgres:17.0-alpine
+    image: postgres:17.7-alpine
     command: postgres -c shared_preload_libraries=pg_stat_statements
     environment:
       POSTGRES_USER: postgres
@@ -53,4 +44,13 @@ services:
       POSTGRES_PASSWORD: secret
     ports:
       - '5437:5432'
+  postgres18:
+    image: postgres:18.1-alpine
+    command: postgres -c shared_preload_libraries=pg_stat_statements
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_DB: rails-pg-extras-test
+      POSTGRES_PASSWORD: secret
+    ports:
+      - '5438:5432'
 

data/lib/rails-pg-extras.rb

@@ -139,7 +139,9 @@ module RailsPgExtras
   end
 
   def self.missing_fk_constraints(args: {}, in_format: :display_table)
-    result = RailsPgExtras::MissingFkConstraints.call(args[:table_name])
+    ignore_list = args[:ignore_list]
+    ignore_list ||= RailsPgExtras.configuration.missing_fk_constraints_ignore_list
+    result = RailsPgExtras::MissingFkConstraints.call(args[:table_name], ignore_list: ignore_list)
     RubyPgExtras.display_result(result, title: "Missing foreign key constraints", in_format: in_format)
   end
 
@@ -179,7 +181,19 @@ module RailsPgExtras
         raise "Unsupported connector: #{connector.class}"
       end
     elsif db_url.present?
-      connector = ActiveRecord::Base.establish_connection(db_url)
+      # Use an isolated abstract class to avoid changing the global connection
+      thread_classes = (Thread.current[:rails_pg_extras_ar_classes] ||= {})
+      ar_class = (thread_classes[:database_url] ||= begin
+        if const_defined?(:PgExtrasURLConn, false)
+          const_get(:PgExtrasURLConn, false)
+        else
+          klass = Class.new(ActiveRecord::Base)
+          klass.abstract_class = true
+          const_set(:PgExtrasURLConn, klass)
+        end
+      end)
+
+      connector = ar_class.establish_connection(db_url)
 
       if connector.respond_to?(:connection)
         connector.connection

data/lib/rails_pg_extras/configuration.rb

@@ -4,14 +4,16 @@ require "rails_pg_extras/web"
 
 module RailsPgExtras
   class Configuration
-    DEFAULT_CONFIG = { enabled_web_actions: Web::ACTIONS - [:kill_all, :kill_pid], public_dashboard: ENV["RAILS_PG_EXTRAS_PUBLIC_DASHBOARD"] == "true" }
+    DEFAULT_CONFIG = { enabled_web_actions: Web::ACTIONS - [:kill_all, :kill_pid], public_dashboard: ENV["RAILS_PG_EXTRAS_PUBLIC_DASHBOARD"] == "true", missing_fk_constraints_ignore_list: [] }
 
     attr_reader :enabled_web_actions
     attr_accessor :public_dashboard
+    attr_accessor :missing_fk_constraints_ignore_list
 
     def initialize(attrs)
       self.enabled_web_actions = attrs[:enabled_web_actions]
       self.public_dashboard = attrs[:public_dashboard]
+      self.missing_fk_constraints_ignore_list = attrs[:missing_fk_constraints_ignore_list]
     end
 
     def enabled_web_actions=(*actions)

data/lib/rails_pg_extras/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsPgExtras
-  VERSION = "5.6.14"
+  VERSION = "5.6.15"
 end

data/spec/smoke_spec.rb

@@ -66,4 +66,15 @@ describe RailsPgExtras do
       }.not_to raise_error
     end
   end
+
+  it "database_url does not affect global connection" do
+    original_connection = ActiveRecord::Base.connection
+
+    RailsPgExtras.database_url = ENV["DATABASE_URL"]
+    RailsPgExtras.calls
+    RailsPgExtras.database_url = nil
+
+    # Verify global connection unchanged
+    expect(ActiveRecord::Base.connection).to eq(original_connection)
+  end
 end

data/spec/spec_helper.rb

@@ -8,15 +8,15 @@ require_relative "../lib/rails-pg-extras"
 pg_version = ENV["PG_VERSION"]
 
 PG_PORTS = {
-  "12" => "5432",
   "13" => "5433",
   "14" => "5434",
   "15" => "5435",
   "16" => "5436",
   "17" => "5437",
+  "18" => "5438",
 }
 
-port = PG_PORTS.fetch(pg_version, "5432")
+port = PG_PORTS.fetch(pg_version, "5438")
 
 ENV["DATABASE_URL"] ||= "postgresql://postgres:secret@localhost:#{port}/rails-pg-extras-test"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails-pg-extras
 version: !ruby/object:Gem::Version
-  version: 5.6.14
+  version: 5.6.15
 platform: ruby
 authors:
 - pawurb
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-26 00:00:00.000000000 Z
+date: 2025-12-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby-pg-extras
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 5.6.14
+        version: 5.6.15
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 5.6.14
+        version: 5.6.15
 - !ruby/object:Gem::Dependency
   name: railties
   requirement: !ruby/object:Gem::Requirement