exwiw 0.3.2 → 0.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83bb3c7245d9174e5d16e85e6de2a530b58ca445b570d692c5198682fc43b9ef
-  data.tar.gz: cee17f919dab949c82942eae146a1d6182909ab6ef595e8cfc7d4c3f744d1ede
+  metadata.gz: 4b10da211ee91b4daa986b71b18fce7ac9a782da81ef92a1146f552368b84d66
+  data.tar.gz: 3893a581e2dac519021d6c86756333b980b3c587efcc5d13337e0fe98d9aaa42
 SHA512:
-  metadata.gz: d655b0e5d55759932d7ab6646cb9ed9d0b699e6c96e6061863091eded7914c736b74c558e8a96d132ea94ef668376ae372a9eacf23f978d52540bf31c38c7c18
-  data.tar.gz: 5e068572f70d2b1869e5dffceba9f681d0b153c0947da3fd7b35d746e7f33bbc6c2d5fa25d23c9dfa0f190e14d3304ec6f2940aa19168749aa05b303c572ea10
+  metadata.gz: 395b24342f9a752d5cda207a959ba905a9fc57c8b693faa838bf2978b7b1b08654e0c5a9901b8359d9af96afc70b36f5b199cfec04165ef9e6ad9b25df0f3ea6
+  data.tar.gz: fb5514dd6d9c724e1d136cf54abe31616f8cec9944522dd7385fbbb04ddf82f9c290c2935d9c7a55949c86b9c433df02fc43f63aa3cff6d93e3f995a07b38f76

data/CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## [Unreleased]
 
+## [0.3.3] - 2026-05-31
+
 ## [0.3.2] - 2026-05-31
 
 ### Changed

data/README.md

@@ -42,22 +42,18 @@ gem install exwiw
 - sqlite
 - mongodb (experimental, see [MongoDB notes](#mongodb-notes))
 
-Adapter names are driver-agnostic — they name the database, not the Ruby driver
-or Rails ActiveRecord adapter. For backward compatibility and to absorb the Rails
-adapter spelling, the following aliases are also accepted (case-insensitive):
-
-| `--adapter` value | Aliases accepted |
-| --- | --- |
-| `mysql` | `mysql2` |
-| `sqlite` | `sqlite3` |
-
-So `--adapter=mysql2` and `--adapter=mysql` both select the same MySQL adapter.
-
 For MySQL, exwiw connects through whichever of the `mysql2` or `trilogy` gem is
 available (preferring `mysql2`), so an app on either driver works without any
 extra setup. There is no separate `trilogy` adapter name — pass `--adapter=mysql`
 either way.
 
+Set `EXWIW_MYSQL_DRIVER=trilogy` (or `mysql2`) to force a specific driver. This
+is useful when the `mysql2` gem is linked against a `libmysqlclient` that can no
+longer load the server's auth plugin — e.g. a MySQL 9.x client drops the
+`mysql_native_password` plugin and raises `Authentication plugin
+'mysql_native_password' cannot be loaded` on connect. The pure-Ruby `trilogy`
+driver implements that auth handshake itself and sidesteps the issue.
+
 ## Usage
 
 exwiw has two subcommands:
@@ -108,7 +104,7 @@ This command will generate sql files in the `dump` directory.
 idx means the order of the dump. bigger idx might depend on smaller idx,
 so you should import the dump in order.
 
-`insert-000-schema.sql` is generated by shelling out to the database client tools (`mysqldump` for `mysql`, `pg_dump` for `postgresql`, and the sqlite3 driver for `sqlite`), so the corresponding client must be available on PATH when running exwiw. The output is post-processed to make it idempotent: `CREATE TABLE IF NOT EXISTS`, `CREATE INDEX IF NOT EXISTS` (where the engine supports it), and PostgreSQL's `ALTER TABLE ... ADD CONSTRAINT` statements are wrapped in `DO $$ ... EXCEPTION WHEN duplicate_object`.
+`insert-000-schema.sql` is generated by shelling out to the database client tools (`mysqldump` for `mysql`, `pg_dump` for `postgresql`, and the sqlite3 driver for `sqlite`), so the corresponding client must be available on PATH when running exwiw. For `mysql`, set `EXWIW_MYSQLDUMP` to point at a specific `mysqldump` binary when the one on PATH is incompatible with the server (e.g. a MySQL 9.x `mysqldump` cannot load `mysql_native_password` against a server still using that auth plugin — `EXWIW_MYSQLDUMP=/path/to/mysql@8.0/bin/mysqldump`). The output is post-processed to make it idempotent: `CREATE TABLE IF NOT EXISTS`, `CREATE INDEX IF NOT EXISTS` (where the engine supports it), and PostgreSQL's `ALTER TABLE ... ADD CONSTRAINT` statements are wrapped in `DO $$ ... EXCEPTION WHEN duplicate_object`.
 
 you need to delete the records before importing the dump,
 `delete-{idx}-{table_name}.sql` will help you to do that.

data/lib/exwiw/adapter/mysql_adapter.rb

@@ -34,8 +34,16 @@ module Exwiw
           return
         end
 
+        # The mysqldump binary is invoked directly (not via the mysql2/trilogy
+        # driver), so point EXWIW_MYSQLDUMP at a specific binary when the one on
+        # PATH is incompatible with the server — e.g. a MySQL 9.x client whose
+        # mysqldump cannot load `mysql_native_password` ("plugin ... cannot be
+        # loaded", exit 2) against a server still using that auth plugin.
+        mysqldump_bin = ENV['EXWIW_MYSQLDUMP']
+        mysqldump_bin = 'mysqldump' if mysqldump_bin.nil? || mysqldump_bin.empty?
+
         cmd = [
-          'mysqldump',
+          mysqldump_bin,
           "--host=#{@connection_config.host}",
           "--port=#{@connection_config.port}",
           "--user=#{@connection_config.user}",
@@ -58,11 +66,18 @@ module Exwiw
         ]
         env = { 'MYSQL_PWD' => @connection_config.password.to_s }
 
-        @logger.debug("  Running mysqldump for #{table_names.size} table(s)...")
-        stdout, stderr, status = Open3.capture3(env, *cmd)
+        @logger.debug("  Running #{mysqldump_bin} for #{table_names.size} table(s)...")
+        stdout, stderr, status =
+          begin
+            Open3.capture3(env, *cmd)
+          rescue Errno::ENOENT
+            raise "Failed to run `#{mysqldump_bin}`. Ensure the mysql client is installed and on PATH, " \
+                  "or set EXWIW_MYSQLDUMP to a mysqldump binary."
+          end
         unless status.success?
           if stderr.include?('command not found') || stderr.empty?
-            raise "Failed to run `mysqldump`. Ensure the mysql client is installed and on PATH. stderr: #{stderr}"
+            raise "Failed to run `#{mysqldump_bin}`. Ensure the mysql client is installed and on PATH, " \
+                  "or set EXWIW_MYSQLDUMP to a mysqldump binary. stderr: #{stderr}"
           end
           raise "mysqldump failed (exit #{status.exitstatus}): #{stderr}"
         end

data/lib/exwiw/adapter/mysql_client.rb

@@ -18,9 +18,27 @@ module Exwiw
       # Immutable value object: a query's column names and its rows.
       Result = Data.define(:fields, :rows)
 
+      DRIVERS = [:mysql2, :trilogy].freeze
+
       # Pick the available driver, preferring mysql2 (exwiw's historical default).
       # require returns false when already loaded, so this is safe to call repeatedly.
+      #
+      # Set EXWIW_MYSQL_DRIVER=trilogy to force the pure-Ruby trilogy driver. This
+      # is useful when the mysql2 gem is linked against a libmysqlclient that can
+      # no longer load the server's auth plugin (e.g. MySQL 9.x client dropped the
+      # `mysql_native_password` plugin .so, raising "Authentication plugin
+      # 'mysql_native_password' cannot be loaded" on connect).
       def self.detect_driver
+        forced = ENV['EXWIW_MYSQL_DRIVER']
+        if forced && !forced.empty?
+          sym = forced.to_sym
+          unless DRIVERS.include?(sym)
+            raise ArgumentError,
+                  "EXWIW_MYSQL_DRIVER must be one of #{DRIVERS.join(', ')}, got #{forced.inspect}."
+          end
+          return sym
+        end
+
         require 'mysql2'
         :mysql2
       rescue LoadError

data/lib/exwiw/determine_table_processing_order.rb

@@ -24,6 +24,10 @@ module Exwiw
           not_resolved_names.empty?
         end
 
+        if tables_with_no_dependencies.empty?
+          raise ArgumentError, build_cycle_error_message(table_by_name, ordered_table_names)
+        end
+
         tables_with_no_dependencies.each do |table|
           ordered_table_names << table.name
           table_by_name.delete(table.name)
@@ -38,5 +42,25 @@ module Exwiw
         acc << relation.table_name
       end
     end
+
+    # When no table can be resolved but some remain, the belongs_to graph
+    # contains a cycle (e.g. A belongs_to B and B belongs_to A). A topological
+    # order cannot exist, so report the offending tables instead of looping
+    # forever.
+    private_class_method def cycle_diagnostics(table_by_name, ordered_table_names)
+      table_by_name.values.map do |table|
+        unresolved = (compute_table_dependencies(table) - ordered_table_names - [table.name]).uniq
+        "  #{table.name} -> #{unresolved.join(', ')}"
+      end
+    end
+
+    private_class_method def build_cycle_error_message(table_by_name, ordered_table_names)
+      "Circular belongs_to dependency detected among tables: " \
+        "#{table_by_name.keys.sort.join(', ')}. " \
+        "A processing order cannot be determined. " \
+        "Remove one of the belongs_to entries forming the cycle.\n" \
+        "Unresolved dependencies:\n" \
+        "#{cycle_diagnostics(table_by_name, ordered_table_names).join("\n")}"
+    end
   end
 end

data/lib/exwiw/version.rb

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

metadata

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