exwiw 0.2.3 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: db5d466378dd55180ac229c2276c4e5e228a067a69b648ed7979d142f5b12ce7
-  data.tar.gz: 2be8b1ffe33cdaa1d9443ec7a3f36f7108f506addfbadb3fa06ac8ba312a89a8
+  metadata.gz: 95749db3a2093fe305a67c6caacf1b6861f791d99f70283a7fa63ce765b9f846
+  data.tar.gz: '087a7260b7d5cd3809fc72c8a783f408e87091e1e6bc816eab4a965e489b4404'
 SHA512:
-  metadata.gz: 17ae95279fe11b231c50a2c0d2e2ead9adcf2db6eb3fb79f7ee54f1af816c26dae23ace12d6fa901655817b26101777af04d70fd76751c6e45bc576d99ef7503
-  data.tar.gz: 99415623bdf900053d466d58c8a45fb1be380167a9d66cf9d265c8122c9fd6e3c96c8e48cb5e9e971e2783db595b63b1d525a850a3871e294a751263747b12b1
+  metadata.gz: cafb2801b708bf26124f12f6a13799f35d6b5f17ec2977fc49464ae56bb6482434bf9d1a155b176968d4f7b545f172a1fc56c3114958206da0605c426194aebf
+  data.tar.gz: c9c05f6da15c12ee45963d0552122310cda5a3261f210d2dbb069986751b9d245bad9661ef9ca5d8ed7fbec04afbe00e637bc9b852d0d15b0eea4429db4c6ec2

data/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [0.2.4] - 2026-05-28
+
+### Added
+
+- Dump/explain queries issued against the source DB now carry an identifying comment (e.g. `/* exwiw table=shops */`) so exwiw-originated queries can be spotted in `processlist` / slow query log / `db.currentOp()` and killed by table when they run long. Added to the SELECT/EXPLAIN of the `mysql2`, `postgresql`, and `sqlite3` adapters and to MongoDB `find` (via `.comment(...)`); the `explain` subcommand's printed SQL matches the emitted form. The comment is applied only at the query-issuing boundary, so generated `insert-*` / `delete-*` files (and `to_bulk_delete` subqueries) stay comment-free, and the version is intentionally omitted to keep snapshots/diffs stable. ([#35](https://github.com/heyinc/exwiw/pull/35))
+
 ## [0.2.3] - 2026-05-27
 
 ### Fixed

data/lib/exwiw/adapter/mongodb_adapter.rb

@@ -73,7 +73,11 @@ module Exwiw
       def execute(query)
         @logger.debug("  Executing Mongo find on '#{query.collection}': filter=#{query.filter.inspect} projection=#{query.projection.inspect}")
 
-        docs = db[query.collection].find(query.filter).projection(query.projection).to_a
+        docs = db[query.collection]
+          .find(query.filter)
+          .projection(query.projection)
+          .comment(query_comment_text("collection=#{query.collection}"))
+          .to_a
 
         @state[query.collection] = docs.map { |doc| doc[query.primary_key] }
 

data/lib/exwiw/adapter/mysql2_adapter.rb

@@ -8,14 +8,14 @@ module Exwiw
       end
 
       def execute(query_ast)
-        sql = compile_ast(query_ast)
+        sql = commented_sql(query_ast)
 
         @logger.debug("  Executing SQL: \n#{sql}")
         connection.query(sql, cast: false, as: :array).to_a
       end
 
       def explain(query_ast)
-        sql = compile_ast(query_ast)
+        sql = commented_sql(query_ast)
 
         @logger.debug("  Executing EXPLAIN: \n#{sql}")
         rows = connection.query("EXPLAIN #{sql}", cast: false).to_a

data/lib/exwiw/adapter/postgresql_adapter.rb

@@ -8,14 +8,14 @@ module Exwiw
       end
 
       def execute(query_ast)
-        sql = compile_ast(query_ast)
+        sql = commented_sql(query_ast)
 
         @logger.debug("  Executing SQL: \n#{sql}")
         connection.exec(sql).values
       end
 
       def explain(query_ast)
-        sql = compile_ast(query_ast)
+        sql = commented_sql(query_ast)
 
         @logger.debug("  Executing EXPLAIN: \n#{sql}")
         connection.exec("EXPLAIN #{sql}").values.map(&:first).join("\n")

data/lib/exwiw/adapter/sqlite3_adapter.rb

@@ -8,14 +8,14 @@ module Exwiw
       end
 
       def execute(query_ast)
-        sql = compile_ast(query_ast)
+        sql = commented_sql(query_ast)
 
         @logger.debug("  Executing SQL: \n#{sql}")
         connection.execute(sql)
       end
 
       def explain(query_ast)
-        sql = compile_ast(query_ast)
+        sql = commented_sql(query_ast)
 
         @logger.debug("  Executing EXPLAIN QUERY PLAN: \n#{sql}")
         rows = connection.execute("EXPLAIN QUERY PLAN #{sql}")

data/lib/exwiw/adapter.rb

@@ -81,6 +81,34 @@ module Exwiw
       def explain(_query_ast)
         raise NotImplementedError, "#{self.class.name} does not implement #explain"
       end
+
+      # Identifier text prepended to every query exwiw sends to the (often
+      # production) source DB, so the statement is recognizable in the
+      # processlist / slow-query log / db.currentOp() and can be killed if it
+      # runs long. e.g. "exwiw table=shops". `label` is "table=..." /
+      # "collection=...". The version is intentionally omitted to keep the
+      # comment stable across releases (snapshots / diffs). Strips `*/` to
+      # avoid breaking out of the comment.
+      def query_comment_text(label = nil)
+        parts = ["exwiw"]
+        parts << label if label
+        parts.join(' ').gsub('*/', '')
+      end
+
+      # SQL block-comment form, prefixed to SELECT / EXPLAIN.
+      def sql_query_comment(query_ast)
+        label =
+          if query_ast.respond_to?(:from_table_name) && query_ast.from_table_name
+            "table=#{query_ast.from_table_name}"
+          end
+        "/* #{query_comment_text(label)} */"
+      end
+
+      # Comment-prefixed SELECT. Relies on the SQL adapter's #compile_ast
+      # (dispatched to the subclass at runtime).
+      def commented_sql(query_ast)
+        "#{sql_query_comment(query_ast)} #{compile_ast(query_ast)}"
+      end
     end
 
     # @params [Exwiw::QueryAst] query_ast

data/lib/exwiw/explain_runner.rb

@@ -40,7 +40,7 @@ module Exwiw
         @logger.debug("Explaining '#{table_name}'... (#{idx + 1}/#{total_size})")
 
         query_ast = adapter.build_query(table, @dump_target, table_by_name)
-        sql = adapter.compile_ast(query_ast)
+        sql = adapter.commented_sql(query_ast)
         explain_text = adapter.explain(query_ast)
 
         @io.puts "-- [#{idx + 1}/#{total_size}] #{table_name}"

data/lib/exwiw/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Exwiw
-  VERSION = "0.2.3"
+  VERSION = "0.2.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: exwiw
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.4
 platform: ruby
 authors:
 - Shia