rails-uuid-pk 0.11.0 → 0.13.0

data/lib/rails_uuid_pk/sqlite3_adapter_extension.rb

@@ -4,8 +4,9 @@ module RailsUuidPk
   # SQLite adapter extension for UUID type support.
   #
   # This module extends ActiveRecord's SQLite3 adapter to provide native UUID
-  # type support. Since SQLite doesn't have a native UUID type, it maps UUIDs
-  # to VARCHAR(36) columns and registers the custom UUID type handlers.
+  # type support. It includes the shared UUID adapter extension functionality
+  # and provides SQLite-specific connection configuration, including transaction-aware
+  # connection setup.
   #
   # @example Automatic type mapping
   #   # SQLite tables with VARCHAR(36) columns are automatically treated as UUIDs
@@ -13,67 +14,22 @@ module RailsUuidPk
   #     t.column :id, :uuid  # Maps to VARCHAR(36) in SQLite
   #   end
   #
+  # @see RailsUuidPk::UuidAdapterExtension
   # @see RailsUuidPk::Type::Uuid
   # @see https://www.sqlite.org/datatype3.html
   module Sqlite3AdapterExtension
-    # Defines native database types for SQLite UUID support.
-    #
-    # @return [Hash] Database type definitions including UUID mapping
-    def native_database_types
-      super.merge(
-        uuid: { name: "varchar", limit: 36 }
-      )
-    end
-
-    # Checks if a type is valid for this adapter.
-    #
-    # Overrides ActiveRecord's valid_type? to recognize the custom UUID type.
-    #
-    # @param type [Symbol] The type to check
-    # @return [Boolean] true if the type is valid
-    def valid_type?(type)
-      return true if type == :uuid
-      super
-    end
-
-    # Registers UUID type handlers in the adapter's type map.
-    #
-    # @param m [ActiveRecord::ConnectionAdapters::AbstractAdapter::TypeMap] The type map to register with
-    # @return [void]
-    def register_uuid_types(m = type_map)
-      RailsUuidPk.log(:debug, "Registering UUID types on #{m.class}")
-      m.register_type(/varchar\(36\)/i) { RailsUuidPk::Type::Uuid.new }
-      m.register_type("uuid") { RailsUuidPk::Type::Uuid.new }
-    end
-
-    # Initializes the type map with UUID type registrations.
-    #
-    # @param m [ActiveRecord::ConnectionAdapters::AbstractAdapter::TypeMap] The type map to initialize
-    # @return [void]
-    def initialize_type_map(m = type_map)
-      super
-      register_uuid_types(m)
-    end
+    include UuidAdapterExtension
 
     # Configures the database connection with UUID type support.
     #
+    # SQLite-specific implementation that avoids calling super inside transactions,
+    # as PRAGMA statements cannot be executed inside transactions in SQLite.
+    #
     # @return [void]
     def configure_connection
       # Only call super if not inside a transaction, as PRAGMA statements
       # cannot be executed inside transactions in SQLite
       super unless open_transactions > 0
-      register_uuid_types
-    end
-
-    # Overrides type dumping to properly handle UUID columns.
-    #
-    # @param column [ActiveRecord::ConnectionAdapters::Column] The column to dump
-    # @return [Array] The type and options for the schema dump
-    def type_to_dump(column)
-      if column.type == :uuid
-        return [ :uuid, {} ]
-      end
-      super
     end
   end
 end

data/lib/rails_uuid_pk/trilogy_adapter_extension.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module RailsUuidPk
+  # Trilogy adapter extension for UUID type support.
+  #
+  # This module extends ActiveRecord's Trilogy adapter to provide native UUID
+  # type support. It includes the shared UUID adapter extension functionality
+  # and provides Trilogy-specific connection configuration.
+  #
+  # Trilogy is GitHub's high-performance MySQL adapter that offers significant
+  # performance improvements over the standard mysql2 adapter, particularly for
+  # high-traffic Rails applications.
+  #
+  # @example UUID primary key and foreign key references
+  #   # Primary key uses UUID type
+  #   create_table :users, id: :uuid do |t|
+  #     t.string :name
+  #   end
+  #
+  #   # Foreign key automatically detects and uses UUID type
+  #   create_table :posts do |t|
+  #     t.references :user  # Automatically uses :uuid type
+  #     t.string :title
+  #   end
+  #
+  # @see RailsUuidPk::UuidAdapterExtension
+  # @see RailsUuidPk::Type::Uuid
+  # @see https://github.com/trilogy-libraries/trilogy
+  module TrilogyAdapterExtension
+    include RailsUuidPk::UuidAdapterExtension
+
+    # Configures the database connection with UUID type support.
+    #
+    # @return [void]
+    def configure_connection
+      super
+    end
+  end
+end

data/lib/rails_uuid_pk/uuid_adapter_extension.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module RailsUuidPk
+  # Shared UUID adapter extension for database adapters.
+  #
+  # This module provides common UUID type support functionality that can be
+  # included by specific database adapter extensions (MySQL, SQLite, etc.).
+  # Since most databases don't have native UUID types, it maps UUIDs to
+  # VARCHAR(36) columns and registers the custom UUID type handlers.
+  #
+  # @example Automatic type mapping
+  #   # Database tables with VARCHAR(36) columns are automatically treated as UUIDs
+  #   create_table :users do |t|
+  #     t.column :id, :uuid  # Maps to VARCHAR(36) in supported databases
+  #   end
+  #
+  # @see RailsUuidPk::Type::Uuid
+  module UuidAdapterExtension
+    # Defines native database types for UUID support.
+    #
+    # @return [Hash] Database type definitions including UUID mapping
+    def native_database_types
+      super.merge(
+        uuid: { name: "varchar", limit: 36 }
+      )
+    end
+
+    # Checks if a type is valid for this adapter.
+    #
+    # Overrides ActiveRecord's valid_type? to recognize the custom UUID type.
+    #
+    # @param type [Symbol] The type to check
+    # @return [Boolean] true if the type is valid
+    def valid_type?(type)
+      return true if type == :uuid
+      super
+    end
+
+    # Registers UUID type handlers in the adapter's type map.
+    #
+    # @param m [ActiveRecord::ConnectionAdapters::AbstractAdapter::TypeMap] The type map to register with
+    # @return [void]
+    def register_uuid_types(m = type_map)
+      RailsUuidPk.log(:debug, "Registering UUID types on #{m.class}")
+      m.register_type(/varchar\(36\)/i) { RailsUuidPk::Type::Uuid.new }
+      m.register_type("uuid") { RailsUuidPk::Type::Uuid.new }
+    end
+
+    # Initializes the type map with UUID type registrations.
+    #
+    # @param m [ActiveRecord::ConnectionAdapters::AbstractAdapter::TypeMap] The type map to initialize
+    # @return [void]
+    def initialize_type_map(m = type_map)
+      super
+      register_uuid_types(m)
+    end
+
+    # Configures the database connection with UUID type support.
+    #
+    # This method should be overridden by including adapters to handle
+    # database-specific connection configuration requirements.
+    #
+    # @return [void]
+    def configure_connection
+      super
+      register_uuid_types
+    end
+
+    # Overrides type dumping to properly handle UUID columns.
+    #
+    # @param column [ActiveRecord::ConnectionAdapters::Column] The column to dump
+    # @return [Array] The type and options for the schema dump
+    def type_to_dump(column)
+      if column.type == :uuid
+        return [ :uuid, {} ]
+      end
+      super
+    end
+  end
+end

data/lib/rails_uuid_pk/version.rb

@@ -7,6 +7,6 @@ module RailsUuidPk
   #
   # @return [String] The current version
   # @example
-  #   RailsUuidPk::VERSION # => "0.11.0"
-  VERSION = "0.11.0"
+  #   RailsUuidPk::VERSION # => "0.13.0"
+  VERSION = "0.13.0"
 end

data/lib/rails_uuid_pk.rb

@@ -3,10 +3,15 @@
 require "rails_uuid_pk/version"
 require "rails_uuid_pk/concern"
 require "rails_uuid_pk/type"
+require "rails_uuid_pk/uuid_adapter_extension"
 require "rails_uuid_pk/sqlite3_adapter_extension"
 require "rails_uuid_pk/mysql2_adapter_extension"
+require "rails_uuid_pk/trilogy_adapter_extension"
 require "rails_uuid_pk/railtie"
 
+# Load generators
+require "generators/rails_uuid_pk/add_opt_outs_generator" if defined?(Rails::Generators)
+
 # Rails UUID Primary Key
 #
 # A Rails gem that automatically uses UUIDv7 for all primary keys in Rails applications.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-uuid-pk
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Joon Lee
@@ -37,6 +37,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.5.7
+- !ruby/object:Gem::Dependency
+  name: trilogy
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.10'
 - !ruby/object:Gem::Dependency
   name: pg
   requirement: !ruby/object:Gem::Requirement
@@ -136,24 +150,32 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0.5'
 description: Automatically use UUID v7 for all primary keys in Rails applications.
-  Works with PostgreSQL, MySQL, and SQLite, zero configuration required.
+  Works with PostgreSQL, MySQL (mysql2 & trilogy), and SQLite, zero configuration
+  required.
 email:
 - seouri@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ARCHITECTURE.md
 - CHANGELOG.md
+- DEVELOPMENT.md
 - MIT-LICENSE
+- PERFORMANCE.md
 - README.md
 - Rakefile
+- SECURITY.md
+- lib/generators/rails_uuid_pk/add_opt_outs_generator.rb
 - lib/rails_uuid_pk.rb
 - lib/rails_uuid_pk/concern.rb
 - lib/rails_uuid_pk/migration_helpers.rb
 - lib/rails_uuid_pk/mysql2_adapter_extension.rb
 - lib/rails_uuid_pk/railtie.rb
 - lib/rails_uuid_pk/sqlite3_adapter_extension.rb
+- lib/rails_uuid_pk/trilogy_adapter_extension.rb
 - lib/rails_uuid_pk/type.rb
+- lib/rails_uuid_pk/uuid_adapter_extension.rb
 - lib/rails_uuid_pk/version.rb
 - lib/tasks/rails_uuid_pk_tasks.rake
 homepage: https://github.com/seouri/rails-uuid-pk
@@ -163,7 +185,8 @@ metadata:
   homepage_uri: https://github.com/seouri/rails-uuid-pk
   source_code_uri: https://github.com/seouri/rails-uuid-pk
   changelog_uri: https://github.com/seouri/rails-uuid-pk/blob/main/CHANGELOG.md
-  documentation_uri: https://www.rubydoc.info/gems/rails-uuid-pk/0.11.0
+  documentation_uri: https://www.rubydoc.info/gems/rails-uuid-pk/0.13.0
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib