rails_db_inspector 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5a2301258a71ef2726b47b18829dab86405d253cd0b093c262d00d986e8cef26
-  data.tar.gz: d343bba0f9d5235aeb9ad7c2747ffb21f284114142387bf0e3394cb5374220d0
+  metadata.gz: 563499f106cd48b6fb921b627408e92cf17388416ab8980485e18e4060c2c1e6
+  data.tar.gz: 357910264b9a52d1e9c944e5ff53c8be679ec20ebc7bb4cebf5109866396d48b
 SHA512:
-  metadata.gz: 0cd3029c26cce165f89f5834878968688240380c37461f8b0b988fc5ebe5566bfb9cdd2ab1fe3f38f3856fb90580b72627d7f2ceb4607e5fbd31d2f8118cac44
-  data.tar.gz: a04e479dd6955d4d4d309f79f2911c321c06c753e53272bc2e64c99d0ad93707ed7f57b9918f68071b7d2898492551663c365f3fdb2eae3758f9bf7b5e1c2b76
+  metadata.gz: accc48fc04b30608198e8b02238a6bdc49de9b75936b60521a5002edfeef2c3bd98b9beb8e6afc63b2f9e9815838bde4dc4055f0addf27c814855c9178d30298
+  data.tar.gz: 25e5c3919cbbdf126c4f4ff6186b7abe10fb97fb8ade2a28c589de7249a2d7edc1370848ab9c29316906a69e7ade51827b03c6b0a20a595f43b0ddf8f362aa07

data/README.md

@@ -2,7 +2,7 @@
 
 A mountable Rails engine that gives you a built-in dashboard for **SQL query monitoring**, **N+1 detection**, **EXPLAIN / EXPLAIN ANALYZE plans**, and **interactive schema visualization** — no external services required.
 
-Supports **PostgreSQL** and **MySQL**.
+Supports **PostgreSQL**, **MySQL**, and **SQLite**.
 
 ![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.1-red)
 ![Rails](https://img.shields.io/badge/rails-%3E%3D%207.1-red)
@@ -18,7 +18,7 @@ Supports **PostgreSQL** and **MySQL**.
 - **Real-time SQL Query Capture** — every query your app executes is logged with SQL text, duration, bind parameters, and timestamps
 - **N+1 Query Detection** — automatically identifies repeated query patterns and highlights the worst offenders
 - **Query Grouping** — queries are grouped by controller action using Rails marginal annotations
-- **EXPLAIN Plans** — run `EXPLAIN` on any captured query to see the execution plan (PostgreSQL JSON format, MySQL tabular)
+- **EXPLAIN Plans** — run `EXPLAIN` on any captured query to see the execution plan (PostgreSQL JSON format, MySQL tabular, SQLite QUERY PLAN)
 - **EXPLAIN ANALYZE** — optionally run `EXPLAIN ANALYZE` to get real execution statistics, buffer usage, and timing (opt-in, SELECT only)
 - **Plan Analysis** — rich visual rendering of PostgreSQL plans including cost breakdown, row estimate accuracy, index usage analysis, performance hotspots, buffer statistics, and actionable recommendations
 - **Interactive Schema / ERD Visualization** — drag-and-drop entity relationship diagram with pan, zoom, search, column expansion, heat-map by row count, missing index warnings, polymorphic detection, and SVG export
@@ -185,9 +185,9 @@ The widget is automatically injected via Rack middleware and only appears in `de
 |------------|---------|-----------------|--------------|
 | PostgreSQL | ✅      | ✅               | ✅            |
 | MySQL      | ✅      | ✅               | ✅            |
-| SQLite     | ❌      | ❌               | ✅            |
+| SQLite     | ✅      | ✅               | ✅            |
 
-EXPLAIN uses `FORMAT JSON` for PostgreSQL and standard `EXPLAIN` for MySQL.
+EXPLAIN uses `FORMAT JSON` for PostgreSQL, standard `EXPLAIN` for MySQL, and `EXPLAIN QUERY PLAN` for SQLite.
 
 ---
 

data/app/views/rails_db_inspector/schema/index.html.erb

@@ -98,6 +98,15 @@
   #heat-legend { position: absolute; bottom: 48px; left: 12px; display: flex; align-items: center; gap: 4px; font-size: 10px; color: #9ca3af; z-index: 50; background: rgba(255,255,255,0.9); padding: 4px 8px; border-radius: 6px; border: 1px solid #e5e7eb; }
   #heat-legend .heat-swatch { width: 12px; height: 10px; border-radius: 2px; }
 
+  /* Loading overlay */
+  #schema-loading { position: absolute; inset: 0; background: rgba(248,250,252,0.92); display: flex; flex-direction: column; align-items: center; justify-content: center; z-index: 200; transition: opacity 0.4s ease; }
+  #schema-loading.fade-out { opacity: 0; pointer-events: none; }
+  #schema-loading .spinner { width: 36px; height: 36px; border: 3px solid #e5e7eb; border-top-color: #3b82f6; border-radius: 50%; animation: spin 0.8s linear infinite; }
+  @keyframes spin { to { transform: rotate(360deg); } }
+  #schema-loading .load-label { margin-top: 14px; font-size: 13px; font-weight: 500; color: #6b7280; }
+  #schema-loading .load-timer { margin-top: 4px; font-size: 22px; font-weight: 700; font-family: ui-monospace, monospace; color: #374151; letter-spacing: 0.02em; }
+  #schema-loading .load-sub { margin-top: 6px; font-size: 11px; color: #9ca3af; }
+
 </style>
 <% end %>
 
@@ -117,6 +126,14 @@
     <svg id="schema-svg"></svg>
     <div id="schema-canvas"></div>
 
+    <!-- Loading Overlay -->
+    <div id="schema-loading">
+      <div class="spinner"></div>
+      <div class="load-label">Laying out schema&hellip;</div>
+      <div class="load-timer" id="load-timer">0.0s</div>
+      <div class="load-sub" id="load-table-count"></div>
+    </div>
+
     <!-- Detail Panel -->
     <div id="detail-panel">
       <div class="detail-header">
@@ -491,9 +508,36 @@
     return { x1: p1.x, y1: p1.y, x2: p2.x, y2: p2.y };
   }
 
+  // Loading overlay / timer
+  var loadingOverlay = document.getElementById('schema-loading');
+  var loadTimerEl = document.getElementById('load-timer');
+  var loadTableCountEl = document.getElementById('load-table-count');
+  var loadStart = performance.now();
+  var loadingDone = false;
+
+  loadTableCountEl.textContent = tableNames.length + ' tables \u00B7 ' + relationships.length + ' relationships';
+
+  function updateLoadTimer() {
+    if (loadingDone) return;
+    var elapsed = ((performance.now() - loadStart) / 1000).toFixed(1);
+    loadTimerEl.textContent = elapsed + 's';
+    requestAnimationFrame(updateLoadTimer);
+  }
+  requestAnimationFrame(updateLoadTimer);
+
+  function hideLoading() {
+    if (loadingDone) return;
+    loadingDone = true;
+    var elapsed = ((performance.now() - loadStart) / 1000).toFixed(1);
+    loadTimerEl.textContent = elapsed + 's';
+    loadingOverlay.classList.add('fade-out');
+    setTimeout(function() { loadingOverlay.style.display = 'none'; }, 500);
+  }
+
   // Animation loop
   function tick() {
     simulate();
+    if (!loadingDone && simAlpha < 0.01) hideLoading();
     requestAnimationFrame(tick);
   }
   tick();

data/lib/rails_db_inspector/explain/sqlite.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module RailsDbInspector
+  class Explain
+    class Sqlite
+      def initialize(connection)
+        @connection = connection
+      end
+
+      def explain(sql, analyze: false)
+        # Strip any existing EXPLAIN prefix to prevent doubling
+        clean_sql = sql.sub(/\A\s*EXPLAIN\s*(QUERY\s+PLAN)?\s*/i, "")
+
+        statement =
+          if analyze
+            RailsDbInspector::Explain.select_only!(clean_sql)
+            "EXPLAIN QUERY PLAN #{clean_sql}"
+          else
+            "EXPLAIN QUERY PLAN #{clean_sql}"
+          end
+
+        result = @connection.exec_query(statement)
+
+        plan = result.rows.map do |row|
+          {
+            "id" => row[0],
+            "parent" => row[1],
+            "notused" => row[2],
+            "detail" => row[3]
+          }
+        end
+
+        { adapter: "sqlite", analyze: analyze, columns: result.columns, rows: result.rows, plan: plan }
+      end
+    end
+  end
+end

data/lib/rails_db_inspector/explain.rb

@@ -13,6 +13,8 @@ module RailsDbInspector
         RailsDbInspector::Explain::Postgres.new(connection)
       when /mysql/
         RailsDbInspector::Explain::MySql.new(connection)
+      when /sqlite/
+        RailsDbInspector::Explain::Sqlite.new(connection)
       else
         raise UnsupportedAdapter, "Unsupported adapter: #{connection.adapter_name}"
       end

data/lib/rails_db_inspector/version.rb

@@ -1,3 +1,3 @@
 module RailsDbInspector
-  VERSION = "0.3.0"
+  VERSION = "0.5.0"
 end

data/lib/rails_db_inspector.rb

@@ -8,6 +8,7 @@ require_relative "rails_db_inspector/sql_subscriber"
 require_relative "rails_db_inspector/explain"
 require_relative "rails_db_inspector/explain/postgres"
 require_relative "rails_db_inspector/explain/my_sql"
+require_relative "rails_db_inspector/explain/sqlite"
 require_relative "rails_db_inspector/schema_inspector"
 
 module RailsDbInspector

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_db_inspector
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - samuel-murphy
@@ -24,9 +24,9 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '7.1'
 description: Rails DB Inspector is a mountable Rails engine that captures SQL queries
-  in real time, detects N+1 query patterns, runs EXPLAIN/EXPLAIN ANALYZE plans, and
-  visualizes your database schema — all from a built-in dashboard. Supports PostgreSQL
-  and MySQL.
+  in real time, detects N+1 query patterns, runs EXPLAIN/EXPLAIN ANALYZE plans, suggests
+  missing and redundant indexes, and visualizes your database schema — all from a
+  built-in dashboard. Supports PostgreSQL, MySQL, and SQLite.
 email:
 - samuelmurphy15@gmail.com
 executables: []
@@ -58,6 +58,7 @@ files:
 - lib/rails_db_inspector/explain.rb
 - lib/rails_db_inspector/explain/my_sql.rb
 - lib/rails_db_inspector/explain/postgres.rb
+- lib/rails_db_inspector/explain/sqlite.rb
 - lib/rails_db_inspector/query_store.rb
 - lib/rails_db_inspector/schema_inspector.rb
 - lib/rails_db_inspector/sql_subscriber.rb
@@ -87,5 +88,5 @@ requirements: []
 rubygems_version: 4.0.3
 specification_version: 4
 summary: Mountable Rails engine for SQL query monitoring, N+1 detection, EXPLAIN analysis,
-  and schema visualization.
+  smart index suggestions, and schema visualization.
 test_files: []