rails-uuid-pk 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d9552cdab44f5a5a6a4b699e12dc31ee13917ff74f0752f32e823dffed24e2e0
-  data.tar.gz: 6ddd7862945d8b13939be92990241539d93eaf754d6c47f2733d66eb2e29597e
+  metadata.gz: 3eb01e2f1dc8ef76a90110c9d6ef882f79cfc6584395129046d404f116be94e3
+  data.tar.gz: 7aa3b43c50beb54b037428f0abf36f4df642968eb0ba368bfe57328bcea2f8cf
 SHA512:
-  metadata.gz: 72fb9c050567562c0d01793d801d7633d45b26851734cb069b2e70ee74d8bf3387e515f50cb771fdbb46f8ad9b4cb767058739bad45050134ba710a8f6290201
-  data.tar.gz: ed3b396026fe6edc6485720d6d80af4d5fd11138652fea133515fcb8d931d9d38cf981553a46689121201922ee41b6fad5829c42c06783109b930b06acf41fda
+  metadata.gz: '09b2676618355ede8b113e7693e8c1673e1f8c32888f0027ab97fd82c81713af5b2f55b995d565f4445465c8c27ce53c4a42fe4f2247017e6c2cf4a0083af9e7'
+  data.tar.gz: 967f36d838dfd8e649a8674cce0a29642f39ee0e1a45dc70c4f66a1597abf65591c71cb434d97fb21affccf337337a04f2602e9fe470d43a464f3b5c2eca2298

data/CHANGELOG.md

@@ -5,6 +5,30 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v1.0.0.html).
 
+## [0.4.0] - 2026-01-10
+
+### Added
+- **MySQL 8.0+ support**: Full MySQL compatibility with VARCHAR(36) UUID storage
+- MySQL2 adapter extension for native database type mappings
+- MySQL-specific type handling and schema dumping support
+- Comprehensive MySQL test suite with performance and edge case testing
+- CI pipeline support for MySQL 8.0 testing
+- Updated documentation to include MySQL setup and compatibility notes
+
+### Changed
+- Updated project description to reflect support for PostgreSQL, MySQL, and SQLite
+- Enhanced test runner to support all three database adapters
+- Updated development environment setup to include MySQL configuration
+- Expanded database coverage from 2 to 3 major Rails database adapters
+
+### Technical Details
+- Added `lib/rails_uuid_pk/mysql2_adapter_extension.rb` for MySQL adapter integration
+- Extended Railtie with MySQL-specific type mappings and adapter detection
+- Enhanced migration helpers compatibility with MySQL VARCHAR(36) column detection
+- Added MySQL performance testing (bulk operations, concurrent access, memory efficiency)
+- Implemented MySQL edge case testing (long table names, special characters)
+- Updated CI workflow with MySQL 8.0 service configuration
+
 ## [0.3.0] - 2026-01-09
 
 ### Added

data/README.md

@@ -1,7 +1,7 @@
 # rails-uuid-pk
 
 **Dead-simple UUIDv7 primary keys for modern Rails apps**  
-Works great with **PostgreSQL 18+** and **SQLite 3.51+** — zero extra extensions required.
+Works great with **PostgreSQL 18+**, **MySQL 8.0+**, and **SQLite 3.51+** — zero extra extensions required.
 
 [![Gem Version](https://img.shields.io/gem/v/rails-uuid-pk.svg?style=flat-square)](https://rubygems.org/gems/rails-uuid-pk)
 [![Ruby](https://img.shields.io/badge/ruby-≥3.3-red.svg?style=flat-square)](https://www.ruby-lang.org)
@@ -12,8 +12,9 @@ Works great with **PostgreSQL 18+** and **SQLite 3.51+** — zero extra extensio
 - Uses **native** `SecureRandom.uuid_v7` (Ruby 3.3+)
 - Automatically sets `:uuid` as default primary key type
 - Adds reliable `before_create` callback for UUIDv7 generation
-- Works perfectly on **both PostgreSQL 18+** and **SQLite** (and older PostgreSQL versions too)
+- Works perfectly on **PostgreSQL 18+**, **MySQL 8.0+**, and **SQLite** (and older versions too)
 - **PostgreSQL**: Uses native `UUID` column types with full database support
+- **MySQL**: Uses `VARCHAR(36)` with custom ActiveRecord type handling
 - **SQLite**: Uses `VARCHAR(36)` with custom ActiveRecord type handling
 - Zero database extensions needed
 - Minimal and maintainable — no monkey-patching hell
@@ -91,7 +92,9 @@ No manual `type: :uuid` specification needed!
 |--------------------------------------|-----------------|-----------------------------------------------------------------------|
 | UUIDv7 generation                    | Automatic       | Uses `SecureRandom.uuid_v7` (very good randomness + monotonicity)     |
 | PostgreSQL 18+ native `uuidv7()`     | Not used        | Fallback approach — more universal, no extensions needed             |
-| SQLite support                       | Full            | No native function → app-side generation works great                  |
+| PostgreSQL support                   | Full            | Native `UUID` column types with full database support                |
+| MySQL 8.0+ support                   | Full            | Uses `VARCHAR(36)` with custom ActiveRecord type handling            |
+| SQLite support                       | Full            | Uses `VARCHAR(36)` with custom ActiveRecord type handling            |
 | Index locality / performance         | Very good       | UUIDv7 is monotonic → almost as good as sequential IDs                |
 | Zero config after install            | Yes             | Migration helpers automatically handle foreign key types             |
 | Works with Rails 7.1 – 8+            | Yes             | Tested conceptually up to Rails 8.1+                                  |
@@ -119,15 +122,16 @@ This project includes a devcontainer configuration for VS Code. To get started:
 
 ### Running Tests
 
-The project includes a comprehensive test suite that runs against both SQLite and PostgreSQL.
+The project includes a comprehensive test suite that runs against SQLite, PostgreSQL, and MySQL.
 
 ```bash
-# Run all tests (SQLite + PostgreSQL)
+# Run all tests (SQLite + PostgreSQL + MySQL)
 ./bin/test
 
 # Run tests for specific database
 DB=sqlite ./bin/test      # SQLite only
 DB=postgres ./bin/test    # PostgreSQL only
+DB=mysql ./bin/test       # MySQL only
 ```
 
 ### Code Quality
@@ -152,9 +156,10 @@ gem install rails-uuid-pk-0.1.0.gem
 
 ### Database Setup
 
-For PostgreSQL testing, ensure PostgreSQL is running and accessible. The test suite uses these environment variables:
+For database testing, ensure the respective databases are running and accessible. The test suite uses these environment variables:
 - `DB_HOST` (defaults to localhost)
 - `RAILS_ENV=test_postgresql` for PostgreSQL tests
+- `RAILS_ENV=test_mysql` for MySQL tests
 
 ## Contributing
 

data/lib/rails_uuid_pk/mysql2_adapter_extension.rb

@@ -0,0 +1,9 @@
+module RailsUuidPk
+  module Mysql2AdapterExtension
+    def native_database_types
+      super.merge(
+        uuid: { name: "varchar", limit: 36 }
+      )
+    end
+  end
+end

data/lib/rails_uuid_pk/railtie.rb

@@ -17,6 +17,19 @@ module RailsUuidPk
             RailsUuidPk::Type::Uuid.new
           end
 
+          # Also map "uuid" SQL type to our custom UUID type for direct lookups
+          ActiveRecord::Base.connection.send(:type_map).register_type "uuid" do |sql_type|
+            RailsUuidPk::Type::Uuid.new
+          end
+        elsif ActiveRecord::Base.connection.adapter_name == "MySQL"
+          # Register the UUID type with ActiveRecord for MySQL
+          ActiveRecord::Type.register(:uuid, RailsUuidPk::Type::Uuid, adapter: :mysql2)
+
+          # Map varchar SQL type to our custom UUID type (since that's how UUID columns are stored in MySQL)
+          ActiveRecord::Base.connection.send(:type_map).register_type(/varchar/i) do |sql_type|
+            RailsUuidPk::Type::Uuid.new
+          end
+
           # Also map "uuid" SQL type to our custom UUID type for direct lookups
           ActiveRecord::Base.connection.send(:type_map).register_type "uuid" do |sql_type|
             RailsUuidPk::Type::Uuid.new
@@ -30,6 +43,15 @@ module RailsUuidPk
       ActiveRecord::ConnectionAdapters::SQLite3Adapter.prepend(RailsUuidPk::Sqlite3AdapterExtension)
     end
 
+    initializer "rails-uuid-pk.mysql_native_types" do
+      begin
+        require "active_record/connection_adapters/mysql2_adapter"
+        ActiveRecord::ConnectionAdapters::Mysql2Adapter.prepend(RailsUuidPk::Mysql2AdapterExtension)
+      rescue LoadError
+        # MySQL adapter not available, skip MySQL-specific initialization
+      end
+    end
+
 
 
     initializer "rails-uuid-pk.schema_format" do |app|

data/lib/rails_uuid_pk/version.rb

@@ -1,3 +1,3 @@
 module RailsUuidPk
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/rails_uuid_pk.rb

@@ -2,6 +2,7 @@ require "rails_uuid_pk/version"
 require "rails_uuid_pk/concern"
 require "rails_uuid_pk/type"
 require "rails_uuid_pk/sqlite3_adapter_extension"
+require "rails_uuid_pk/mysql2_adapter_extension"
 require "rails_uuid_pk/railtie"
 
 module RailsUuidPk

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-uuid-pk
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Joon Lee
@@ -23,6 +23,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '8.0'
+- !ruby/object:Gem::Dependency
+  name: mysql2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.7
 - !ruby/object:Gem::Dependency
   name: pg
   requirement: !ruby/object:Gem::Requirement
@@ -51,8 +65,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 2.9.0
-description: Automatically use UUIDv7 for all primary keys in Rails applications.
-  Works with PostgreSQL and SQLite, zero configuration required.
+description: Automatically use UUID v7 for all primary keys in Rails applications.
+  Works with PostgreSQL, MySQL, and SQLite, zero configuration required.
 email:
 - seouri@gmail.com
 executables: []
@@ -69,6 +83,7 @@ files:
 - 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/type.rb
@@ -97,5 +112,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.3
 specification_version: 4
-summary: Dead-simple UUIDv7 primary keys for Rails apps
+summary: Dead-simple UUID v7 primary keys for Rails apps
 test_files: []