hairtrigger 1.3.0 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1798fb4e1b61d82806b26b2dcf147e220b9ff5c4044a60ccb589407390695f4d
-  data.tar.gz: 2ccbd8b57c5c8c7edd82c512c3526d4be004363cecdf0cd710e5315db64fb39b
+  metadata.gz: 00e0ef28f55f9f28dddc16dadc2acfadbefa3007eacc294591fc8a2047f547ed
+  data.tar.gz: 7c1aef527b1343d68651bddc00a4cd1b9012b78a4c9a81c0fd333be8f2adb72d
 SHA512:
-  metadata.gz: 14903c29e02310555603f4298a3e930e16467bbc5495db09089eeef0d5291e998978078fc1dbd79f390bef21bea31f4e76dae7438069362aebcdaf047b22ed43
-  data.tar.gz: 2b96e24dbad2c2d9b71534229a267bca2c5de95d9954b43e69fdbcb9f4a22ec064d52e7ca9ce3dc941d2376f26877e086631a3aa895f5fdd7b94fac31e33e64e
+  metadata.gz: e81ed119bd7f7a3c20fc5f9a7ed365ed5a67551b11063efbd3aeecf9f4116b88b662d6ecf309e7e8fa1b7efedd76519c2f5770851797639750078e034793e152
+  data.tar.gz: e1416ac1fca775b6a600c2a658a1aa51088893293a818d56d8bd0df13821ff4bf54d104177db54bf532a85c054cbbde55a1afe2575b1ab48ef66139b06981afa

data/README.md

@@ -338,6 +338,13 @@ ignore. Note that this behavior [may change](https://github.com/jenseng/hair_tri
 in a future release, meaning you'll first need to explicitly drop the
 existing trigger if you wish to redefine it.
 
+## Custom adapters
+
+Out of the box, HairTrigger supports the standard adapters for PostgreSQL, MySQL, and SQLite, plus several common variations (`postgis`, `mysql2rgeo`, `trilogy`, and `litedb`). If you would like to use HairTrigger with another compatible variation, you can dynamically add it to `HairTrigger.hair_trigger_configuration`, for example:
+```ruby
+HairTrigger.hair_trigger_configuration.postgresql_adapters << :postgresql_proxy
+```
+
 ## Gotchas
 
 * As is the case with `ActiveRecord::Base.update_all` or any direct SQL you do,

data/lib/hair_trigger/adapter.rb

@@ -27,11 +27,11 @@ module HairTrigger
       name_clause = options[:only] ? "IN ('" + options[:only].join("', '") + "')" : nil
       adapter_name = HairTrigger.adapter_name_for(self)
       case adapter_name
-        when *HairTrigger::SQLITE_ADAPTERS
+        when *HairTrigger.hair_trigger_config.sqlite_adapters
           select_rows("SELECT name, sql FROM sqlite_master WHERE type = 'trigger' #{name_clause ? " AND name " + name_clause : ""}").each do |(name, definition)|
             triggers[name] = quote_table_name_in_trigger(definition) + ";\n"
           end
-        when *HairTrigger::MYSQL_ADAPTERS
+        when *HairTrigger.hair_trigger_config.mysql_adapters
           select_rows("SHOW TRIGGERS").each do |(name, event, table, actions, timing, created, sql_mode, definer)|
             definer = normalize_mysql_definer(definer)
             next if options[:only] && !options[:only].include?(name)
@@ -41,7 +41,7 @@ FOR EACH ROW
 #{actions}
             SQL
           end
-        when *POSTGRESQL_ADAPTERS
+        when *HairTrigger.hair_trigger_config.postgresql_adapters
           function_conditions = "(SELECT typname FROM pg_type WHERE oid = prorettype) = 'trigger'"
           function_conditions << <<-SQL unless options[:simple_check]
             AND oid IN (

data/lib/hair_trigger/builder.rb

@@ -44,7 +44,7 @@ module HairTrigger
     end
 
     def name(name)
-      @errors << ["trigger name cannot exceed 63 for postgres", *HairTrigger::POSTGRESQL_ADAPTERS] if name.to_s.size > 63
+      @errors << ["trigger name cannot exceed 63 for postgres", *HairTrigger.hair_trigger_config.postgresql_adapters] if name.to_s.size > 63
       options[:name] = name.to_s
     end
 
@@ -54,7 +54,7 @@ module HairTrigger
     end
 
     def for_each(for_each)
-      @errors << ["sqlite and mysql don't support FOR EACH STATEMENT triggers", *HairTrigger::SQLITE_ADAPTERS, *HairTrigger::MYSQL_ADAPTERS] if for_each == :statement
+      @errors << ["sqlite and mysql don't support FOR EACH STATEMENT triggers", *HairTrigger.hair_trigger_config.sqlite_adapters, *HairTrigger.hair_trigger_config.mysql_adapters] if for_each == :statement
       raise DeclarationError, "invalid for_each" unless [:row, :statement].include?(for_each)
       options[:for_each] = for_each.to_s.upcase
     end
@@ -107,9 +107,9 @@ module HairTrigger
         raise DeclarationError, "trigger security should be :invoker, :definer, CURRENT_USER, or a valid user (e.g. 'user'@'host')"
       end
       # sqlite default is n/a, mysql default is :definer, postgres default is :invoker
-      @errors << ["sqlite doesn't support trigger security", *HairTrigger::SQLITE_ADAPTERS]
-      @errors << ["postgresql doesn't support arbitrary users for trigger security", *HairTrigger::POSTGRESQL_ADAPTERS] unless [:definer, :invoker].include?(user)
-      @errors << ["mysql doesn't support invoker trigger security", *HairTrigger::MYSQL_ADAPTERS] if user == :invoker
+      @errors << ["sqlite doesn't support trigger security", *HairTrigger.hair_trigger_config.sqlite_adapters]
+      @errors << ["postgresql doesn't support arbitrary users for trigger security", *HairTrigger.hair_trigger_config.postgresql_adapters] unless [:definer, :invoker].include?(user)
+      @errors << ["mysql doesn't support invoker trigger security", *HairTrigger.hair_trigger_config.mysql_adapters] if user == :invoker
       options[:security] = user
     end
 
@@ -122,8 +122,8 @@ module HairTrigger
       events << :insert if events.delete(:create)
       events << :delete if events.delete(:destroy)
       raise DeclarationError, "invalid events" unless events & [:insert, :update, :delete, :truncate] == events
-      @errors << ["sqlite and mysql triggers may not be shared by multiple actions", *HairTrigger::MYSQL_ADAPTERS, *HairTrigger::SQLITE_ADAPTERS] if events.size > 1
-      @errors << ["sqlite and mysql do not support truncate triggers", *HairTrigger::MYSQL_ADAPTERS, *HairTrigger::SQLITE_ADAPTERS] if events.include?(:truncate)
+      @errors << ["sqlite and mysql triggers may not be shared by multiple actions", *HairTrigger.hair_trigger_config.mysql_adapters, *HairTrigger.hair_trigger_config.sqlite_adapters] if events.size > 1
+      @errors << ["sqlite and mysql do not support truncate triggers", *HairTrigger.hair_trigger_config.mysql_adapters, *HairTrigger.hair_trigger_config.sqlite_adapters] if events.include?(:truncate)
       options[:events] = events.map{ |e| e.to_s.upcase }
     end
 
@@ -152,7 +152,7 @@ module HairTrigger
           def #{method}(*args, &block)
             @chained_calls << :#{method}
             if @triggers || @trigger_group
-              @errors << ["mysql doesn't support #{method} within a trigger group", *HairTrigger::MYSQL_ADAPTERS] unless [:name, :where, :all, :of].include?(:#{method})
+              @errors << ["mysql doesn't support #{method} within a trigger group", *HairTrigger.hair_trigger_config.mysql_adapters] unless [:name, :where, :all, :of].include?(:#{method})
             end
             set_#{method}(*args, &(block_given? ? block : nil))
           end
@@ -174,7 +174,7 @@ module HairTrigger
     chainable_methods :name, :on, :for_each, :before, :after, :where, :security, :timing, :events, :all, :nowrap, :of, :declare, :old_as, :new_as
 
     def create_grouped_trigger?
-      HairTrigger::MYSQL_ADAPTERS.include?(adapter_name)
+      HairTrigger.hair_trigger_config.mysql_adapters.include?(adapter_name)
     end
 
     def prepare!
@@ -234,11 +234,11 @@ module HairTrigger
 
         [generate_drop_trigger] +
         [case adapter_name
-          when *HairTrigger::SQLITE_ADAPTERS
+          when *HairTrigger.hair_trigger_config.sqlite_adapters
             generate_trigger_sqlite
-          when *HairTrigger::MYSQL_ADAPTERS
+          when *HairTrigger.hair_trigger_config.mysql_adapters
             generate_trigger_mysql
-          when *HairTrigger::POSTGRESQL_ADAPTERS
+          when *HairTrigger.hair_trigger_config.postgresql_adapters
             generate_trigger_postgresql
           else
             raise GenerationError, "don't know how to build #{adapter_name} triggers yet"
@@ -345,8 +345,8 @@ module HairTrigger
     def maybe_execute(&block)
       raise DeclarationError, "of may only be specified on update triggers" if options[:of] && options[:events] != ["UPDATE"]
       if block.arity > 0 # we're creating a trigger group, so set up some stuff and pass the buck
-        @errors << ["trigger group must specify timing and event(s) for mysql", *HairTrigger::MYSQL_ADAPTERS] unless options[:timing] && options[:events]
-        @errors << ["nested trigger groups are not supported for mysql", *HairTrigger::MYSQL_ADAPTERS] if @trigger_group
+        @errors << ["trigger group must specify timing and event(s) for mysql", *HairTrigger.hair_trigger_config.mysql_adapters] unless options[:timing] && options[:events]
+        @errors << ["nested trigger groups are not supported for mysql", *HairTrigger.hair_trigger_config.mysql_adapters] if @trigger_group
         @triggers = []
         block.call(self)
         raise DeclarationError, "trigger group did not define any triggers" if @triggers.empty?
@@ -375,9 +375,9 @@ module HairTrigger
       subtriggers = all_triggers(false)
       named_subtriggers = subtriggers.select{ |t| t.options[:name] }
       if named_subtriggers.present? && !options[:name]
-        @warnings << ["nested triggers have explicit names, but trigger group does not. trigger name will be inferred", *HairTrigger::MYSQL_ADAPTERS]
+        @warnings << ["nested triggers have explicit names, but trigger group does not. trigger name will be inferred", *HairTrigger.hair_trigger_config.mysql_adapters]
       elsif subtriggers.present? && !named_subtriggers.present? && options[:name]
-        @warnings << ["trigger group has an explicit name, but nested triggers do not. trigger names will be inferred", *HairTrigger::POSTGRESQL_ADAPTERS, *HairTrigger::SQLITE_ADAPTERS]
+        @warnings << ["trigger group has an explicit name, but nested triggers do not. trigger names will be inferred", *HairTrigger.hair_trigger_config.postgresql_adapters, *HairTrigger.hair_trigger_config.sqlite_adapters]
       end
     end
 
@@ -412,9 +412,9 @@ module HairTrigger
 
     def supports_of?
       case adapter_name
-      when *HairTrigger::SQLITE_ADAPTERS
+      when *HairTrigger.hair_trigger_config.sqlite_adapters
         true
-      when *HairTrigger::POSTGRESQL_ADAPTERS
+      when *HairTrigger.hair_trigger_config.postgresql_adapters
         db_version >= 90000
       else
         false
@@ -429,9 +429,9 @@ module HairTrigger
 
     def supports_referencing?
       case adapter_name
-      when *HairTrigger::SQLITE_ADAPTERS, *HairTrigger::MYSQL_ADAPTERS
+      when *HairTrigger.hair_trigger_config.sqlite_adapters, *HairTrigger.hair_trigger_config.mysql_adapters
         false
-      when *HairTrigger::POSTGRESQL_ADAPTERS
+      when *HairTrigger.hair_trigger_config.postgresql_adapters
         db_version >= 100000
       else
         false
@@ -440,9 +440,9 @@ module HairTrigger
 
     def generate_drop_trigger
       case adapter_name
-        when *HairTrigger::SQLITE_ADAPTERS, *HairTrigger::MYSQL_ADAPTERS
+        when *HairTrigger.hair_trigger_config.sqlite_adapters, *HairTrigger.hair_trigger_config.mysql_adapters
           "DROP TRIGGER IF EXISTS #{prepared_name};\n"
-        when *HairTrigger::POSTGRESQL_ADAPTERS
+        when *HairTrigger.hair_trigger_config.postgresql_adapters
           "DROP TRIGGER IF EXISTS #{prepared_name} ON #{adapter.quote_table_name(options[:table])};\nDROP FUNCTION IF EXISTS #{adapter.quote_table_name(prepared_name)}();\n"
         else
           raise GenerationError, "don't know how to drop #{adapter_name} triggers yet"
@@ -532,7 +532,7 @@ BEGIN
 
     def db_version
       @db_version ||= case adapter_name
-        when *HairTrigger::POSTGRESQL_ADAPTERS
+        when *HairTrigger.hair_trigger_config.postgresql_adapters
           adapter.send(:postgresql_version)
       end
     end

data/lib/hair_trigger/configuration.rb

@@ -0,0 +1,11 @@
+module HairTrigger
+  class Configuration
+    attr_accessor :postgresql_adapters, :mysql_adapters, :sqlite_adapters
+
+    def initialize(postgresql_adapters: [], mysql_adapters: [], sqlite_adapters: [])
+      @postgresql_adapters = postgresql_adapters
+      @mysql_adapters      = mysql_adapters
+      @sqlite_adapters     = sqlite_adapters
+    end
+  end
+end

data/lib/hair_trigger/schema_dumper.rb

@@ -74,7 +74,7 @@ module HairTrigger
     def normalize_trigger(name, definition, type)
       @adapter_name = @connection.adapter_name.downcase.to_sym
 
-      return definition unless HairTrigger::POSTGRESQL_ADAPTERS.include?(@adapter_name)
+      return definition unless HairTrigger.hair_trigger_config.postgresql_adapters.include?(@adapter_name)
       # because postgres does not preserve the original CREATE TRIGGER/
       # FUNCTION statements, its decompiled reconstruction will not match
       # ours. we work around it by creating our generated trigger/function,

data/lib/hair_trigger/version.rb

@@ -1,5 +1,5 @@
 module HairTrigger
-  VERSION = "1.3.0"
+  VERSION = "1.3.1"
 
   def VERSION.<=>(other)
     split(/\./).map(&:to_i) <=> other.split(/\./).map(&:to_i)

data/lib/hair_trigger.rb

@@ -12,12 +12,25 @@ module HairTrigger
   MYSQL_ADAPTERS = %i[mysql mysql2rgeo trilogy]
   SQLITE_ADAPTERS = %i[sqlite litedb]
 
+  autoload :Configuration, 'hair_trigger/configuration'
   autoload :Builder, 'hair_trigger/builder'
   autoload :MigrationReader, 'hair_trigger/migration_reader'
 
   class << self
     attr_writer :model_path, :schema_rb_path, :migration_path, :pg_schema
 
+    def configure
+      yield hair_trigger_config
+    end
+
+    def hair_trigger_config
+      @hair_trigger_config ||= Configuration.new(
+        postgresql_adapters: POSTGRESQL_ADAPTERS,
+        mysql_adapters:      MYSQL_ADAPTERS,
+        sqlite_adapters:     SQLITE_ADAPTERS
+      )
+    end
+
     def current_triggers
       # see what the models say there should be
       canonical_triggers = models.map(&:triggers).flatten.compact

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hairtrigger
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.3.1
 platform: ruby
 authors:
 - Jon Jensen
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-25 00:00:00.000000000 Z
+date: 2025-03-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -72,6 +72,7 @@ files:
 - lib/hair_trigger/adapter.rb
 - lib/hair_trigger/base.rb
 - lib/hair_trigger/builder.rb
+- lib/hair_trigger/configuration.rb
 - lib/hair_trigger/migration_reader.rb
 - lib/hair_trigger/migrator.rb
 - lib/hair_trigger/railtie.rb