rails-pg-extras 5.2.1 → 5.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4bd83f21b85de2b816dc334b72ad1bd0dfcb0f13ea6946fec42ebb93f47ba876
-  data.tar.gz: 4e9e5b00cc7e07cf3baa1bc3e224fe8ab50510afa909b47e753873fb1e7a11e7
+  metadata.gz: 4bcee4d55bf01b44d36cb44ddd18e2cb4e1332f279e1d64e24459ba699822b35
+  data.tar.gz: 1f11135781de014d57e8f9b2d78a9bebc686e7c4266fdb072d30d0551e1f4ca7
 SHA512:
-  metadata.gz: 1a30823d47f9e0cab719b7ee6e750da28c751f4dc20d21756f7f3a633c07dd6390397e09502300cfcf9185184a9e00af83de40f2fd9b12a6319a6ade31ccb26f
-  data.tar.gz: f01d58920638949122f26a74857cdab232168b274aee2d28d180eed09ea60a48ace036aa3ba772dc8ce41893d6e4a4397255167bc5ccf699a181c7205438ed93
+  metadata.gz: 915f068aa1146196e7a7e6e7fd7b53164995aef312d4bb4fce2865ed59328d50ecd398f8f1201a0ae179a8d4e14ee69fce4c9fe1e406c24d54bf1e2f5ee3d656
+  data.tar.gz: 626ffcd65d992f73ac75c8da877563d0e618add2259e6fda22a153ef9c671f067ca8bdfa63c7d517df57b77e2a2ffd464c60cadbc4c02ddb9532c6044ca22b0c

data/README.md

@@ -10,7 +10,7 @@ You can read this blog post for detailed step by step tutorial on how to [optimi
 
 Optionally you can enable a visual interface:
 
-![Web interface](https://github.com/pawurb/rails-pg-extras/raw/master/pg-extras-ui.png)
+![Web interface](https://github.com/pawurb/rails-pg-extras/raw/main/pg-extras-ui.png)
 
 Alternative versions:
 
@@ -51,7 +51,7 @@ You should see the similar line in the output:
 RailsPgExtras.add_extensions
 ```
 
-By deafult a primary ActiveRecord database connection is used for running metadata queries, rake tasks and web UI. To connect to a different database you can specify an `ENV['RAILS_PG_EXTRAS_DATABASE_URL']` value in the following format:
+By default a primary ActiveRecord database connection is used for running metadata queries, rake tasks and web UI. To connect to a different database you can specify an `ENV['RAILS_PG_EXTRAS_DATABASE_URL']` value in the following format:
 
 ```ruby
 ENV["RAILS_PG_EXTRAS_DATABASE_URL"] = "postgresql://postgres:secret@localhost:5432/database_name"
@@ -113,7 +113,7 @@ RailsPgExtras.diagnose
 $ rake pg_extras:diagnose
 ```
 
-![Diagnose report](https://github.com/pawurb/rails-pg-extras/raw/master/rails-pg-extras-diagnose.png)
+![Diagnose report](https://github.com/pawurb/rails-pg-extras/raw/main/rails-pg-extras-diagnose.png)
 
 Keep reading to learn about methods that `diagnose` uses under the hood.
 
@@ -152,18 +152,18 @@ RailsPgExtras.measure_queries { User.limit(10).map(&:team) }
  :queries=>
   {"SELECT \"users\".* FROM \"users\" LIMIT $1"=>
     {:count=>1,
-     :total_duration=>3.452000004472211,
-     :min_duration=>3.452000004472211,
-     :max_duration=>3.452000004472211,
-     :avg_duration=>3.452000004472211},
+     :total_duration=>1.9,
+     :min_duration=>1.9,
+     :max_duration=>1.9,
+     :avg_duration=>1.9},
    "SELECT \"teams\".* FROM \"teams\" WHERE \"teams\".\"id\" = $1 LIMIT $2"=>
     {:count=>10,
-     :total_duration=>14.487000000372063,
-     :min_duration=>0.778000001446344,
-     :max_duration=>1.985000002605375,
-     :avg_duration=>1.4487000000372063}},
- :total_duration=>24.812000003294088,
- :sql_duration=>17.939000004844274}
+     :total_duration=>0.94,
+     :min_duration=>0.62,
+     :max_duration=>1.37,
+     :avg_duration=>0.94}},
+ :total_duration=>13.35,
+ :sql_duration=>11.34}
 
 RailsPgExtras.measure_queries { User.limit(10).includes(:team).map(&:team) }
 
@@ -171,21 +171,36 @@ RailsPgExtras.measure_queries { User.limit(10).includes(:team).map(&:team) }
  :queries=>
   {"SELECT \"users\".* FROM \"users\" LIMIT $1"=>
     {:count=>1,
-     :total_duration=>3.7079999965499155,
-     :min_duration=>3.7079999965499155,
-     :max_duration=>3.7079999965499155,
-     :avg_duration=>3.7079999965499155},
+     :total_duration=>3.43,
+     :min_duration=>3.43,
+     :max_duration=>3.43,
+    :avg_duration=>3.43},
    "SELECT \"teams\".* FROM \"teams\" WHERE \"teams\".\"id\" IN ($1, $2, $3, $4, $5, $6, $7, $8)"=>
     {:count=>1,
-     :total_duration=>2.422000005026348,
-     :min_duration=>2.422000005026348,
-     :max_duration=>2.422000005026348,
-     :avg_duration=>2.422000005026348}},
- :total_duration=>9.905999999318738,
- :sql_duration=>6.1300000015762635}
+     :total_duration=>2.59,
+     :min_duration=>2.59,
+     :max_duration=>2.59,
+     :avg_duration=>2.59}},
+ :total_duration=>9.75,
+ :sql_duration=>6.02}
 
 ```
 
+Optionally, by including [Marginalia gem](https://github.com/basecamp/marginalia) and configuring it to display query backtraces:
+
+`config/development.rb`
+
+```ruby
+
+Marginalia::Comment.components = [:line]
+
+```
+
+you can add this info to the output:
+
+![Marginalia logs](https://github.com/pawurb/rails-pg-extras/raw/main/marginalia-logs.png)
+
+
 ### `table_info`
 
 This method displays metadata metrics for all or a selected table. You can use it to check the table's size, its cache hit metrics, and whether it is correctly indexed. Many sequential scans or no index scans are potential indicators of misconfigured indexes. This method aggregates data provided by other methods in an easy to analyze summary format.

data/lib/rails_pg_extras/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails-pg-extras
 version: !ruby/object:Gem::Version
-  version: 5.2.1
+  version: 5.2.3
 platform: ruby
 authors:
 - pawurb
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-03-01 00:00:00.000000000 Z
+date: 2023-06-05 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.2.1
+        version: 5.2.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 5.2.1
+        version: 5.2.3
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
@@ -106,6 +106,7 @@ files:
 - lib/rails_pg_extras/version.rb
 - lib/rails_pg_extras/web.rb
 - lib/rails_pg_extras/web/engine.rb
+- marginalia-logs.png
 - pg-extras-ui.png
 - rails-pg-extras-diagnose.png
 - rails-pg-extras.gemspec