rails-query-tracer 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3d1dd2ec824da4387699b60da35df292eef2fd918e7633336abf08a9bd3f1a81
+  data.tar.gz: 821531d2ec1e9eddc23f4b521a9baa9b2128d8bd6fe65761e071120d53be5911
+SHA512:
+  metadata.gz: b72ae1c1e7934242bf445dfa6962a7ec9be3e0591980b8e595d825aa7fd6c82788498fe8d1a90823851cb9949bd8a0e3c1ebdfdfc292af047e8aaf219f30b6b2
+  data.tar.gz: 4d70c4342fda57e8f93f66f4a46c3594226b8c70a9aacdfd4e7879ac777666a4cd75fa44922f725462b647a65377fece07a3c2d7b0df5edc8a565cce0604a118

data/lib/rails-query-tracer/analyzer.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module RailsQueryTracer
+  class Analyzer
+    def self.analyze(queries)
+      { n_plus_one: detect_n_plus_one(queries), slow: detect_slow_queries(queries) }
+    end
+
+    def self.detect_n_plus_one(queries)
+      n1 = []
+      queries.group_by { |q| q[:sql] }.each do |sql, repeated|
+        next unless repeated.size > 1
+
+        locs = repeated.filter_map { |q| q[:location] }.uniq
+        n1 << { sql: sql, count: repeated.size, locations: locs }
+      end
+      n1
+    end
+
+    def self.detect_slow_queries(queries)
+      queries.select { |q| q[:duration] && q[:duration] > RailsQueryTracer::Config.slow_queries_threshold }.map do |q|
+        { sql: q[:sql], duration: q[:duration], location: q[:location] }
+      end
+    end
+  end
+end

data/lib/rails-query-tracer/config.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module RailsQueryTracer
+  module Config
+    class << self
+      attr_accessor :slow_queries_threshold, :show_stack_trace, :log_to_file
+
+      def setup_defaults
+        @slow_queries_threshold = 20
+        @show_stack_trace = true
+        @log_to_file = nil
+      end
+    end
+
+    setup_defaults
+  end
+end

data/lib/rails-query-tracer/reporter.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module RailsQueryTracer
+  class Reporter
+    RED    = "\e[31m"
+    GREEN  = "\e[32m"
+    YELLOW = "\e[33m"
+    CYAN   = "\e[36m"
+    RESET  = "\e[0m"
+
+    def self.report(report)
+      n_plus_one_queries = report[:n_plus_one] || []
+      slow = report[:slow] || []
+
+      report_n_plus_one(n_plus_one_queries)
+      report_slow_queries(slow)
+      report_success if n_plus_one_queries.empty? && slow.empty?
+      report_complete
+    end
+
+    def self.report_n_plus_one(n_plus_one_queries)
+      return unless n_plus_one_queries.any?
+
+      puts "#{YELLOW}[RailsQueryTracer] N+1 Queries:#{RESET}"
+      n_plus_one_queries.each do |q|
+        locs = Array(q[:locations])
+        puts "  #{q[:sql]} repeated #{q[:count]} times at #{locs.join(', ')}"
+      end
+    end
+
+    def self.report_slow_queries(slow)
+      return unless slow.any?
+
+      puts "#{RED}[RailsQueryTracer] Slow Queries:#{RESET}"
+      slow.each do |q|
+        sql      = q[:sql] || "unknown SQL"
+        duration = q[:duration] ? "#{q[:duration].round(2)}ms" : "unknown duration"
+        loc      = q[:location] || "unknown"
+        puts "  #{sql} (#{duration}) at #{loc}"
+      end
+    end
+
+    def self.report_success
+      puts "#{GREEN}[RailsQueryTracer] No N+1 or slow queries detected#{RESET}"
+    end
+
+    def self.report_complete
+      puts "#{CYAN}[RailsQueryTracer] Report Complete#{RESET}"
+    end
+  end
+end

data/lib/rails-query-tracer/tracker.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require "active_support/notifications"
+
+module RailsQueryTracer
+  class Tracker
+    @queries = []
+
+    class << self
+      attr_reader :queries
+
+      def start
+        @notifications = ActiveSupport::Notifications
+        @subscriber = @notifications.subscribe("sql.active_record") do |_name, start, finish, _id, payload|
+          next if payload[:name] == "SCHEMA"
+
+          location = extract_location
+          @queries << {
+            sql: payload[:sql],
+            duration: (finish - start) * 1000,
+            location: location
+          }
+        end
+      end
+
+      def stop
+        ActiveSupport::Notifications.unsubscribe(@subscriber) if @subscriber
+        @subscriber = nil
+      end
+
+      def extract_location
+        caller.reject { |line| line.include?("/gems/") || line.include?("/ruby/") }.first
+      end
+
+      def reset!
+        @queries = []
+      end
+    end
+  end
+end

data/lib/rails-query-tracer/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module RailsQueryTracer
+  VERSION = "0.1.0"
+end

data/lib/rails-query-tracer.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require "rails-query-tracer/version"
+require "rails-query-tracer/config"
+require "rails-query-tracer/tracker"
+require "rails-query-tracer/analyzer"
+require "rails-query-tracer/reporter"
+
+module RailsQueryTracer
+  class Error < StandardError; end
+
+  def self.configure
+    yield(Config)
+  end
+end

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification
+name: rails-query-tracer
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Davide V.
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-11-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+description: RailsQueryTracer hooks into ActiveRecord, finds N+1 queries, slow queries,
+  and provides actionable insights with optional dashboard.
+email:
+- daemonzone@users.noreply.github.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/rails-query-tracer.rb
+- lib/rails-query-tracer/analyzer.rb
+- lib/rails-query-tracer/config.rb
+- lib/rails-query-tracer/reporter.rb
+- lib/rails-query-tracer/tracker.rb
+- lib/rails-query-tracer/version.rb
+homepage: https://github.com/yourusername/rails-query-tracer
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.6
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.6
+signing_key:
+specification_version: 4
+summary: Trace and detect slow queries and N+1 problems in Rails
+test_files: []