sqlite_crypto 2.0.2 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 80e11f5e0be719e1757f5c97c3702cc6a9f590cc098a28b530edd10b19a30c9f
-  data.tar.gz: 4d93d3d9e8c4f1dcb266a9c5a20e0534e1f24e85373e2e4316630ab508ef3577
+  metadata.gz: ed3f34d6f260bfcbe3487f7b13489eff823b0e5d0bfc3f0459a166218b76b141
+  data.tar.gz: 97ba38c69e755ffe3efee31d377e5e8cf056e833c41bdea26eea5f2bff5af120
 SHA512:
-  metadata.gz: f675ad1e8b7b0b389a322bc2b023c488f268f2b212ac6520c550c32b0d15095a72bc163d6c3dc57716a4f04e49aa4e9689743ed3c0b11bcbbd8ac05aa5b37f3b
-  data.tar.gz: cc05e8bc9a4e36a20ddd15a28b95222a7ccc61329b31012acc69789c6760e3feca81a34fdfee07dab4488adc0f056c648b256c5fa7de9158e0142a55c6fcd6cb
+  metadata.gz: 36e76170a44cb93f67fc21ac758b9a5513a5d372d904564198072b9bc8f578e223f5a176ad8733c525c2db40456d1944f1ecaf68cbd5ea7bf9bb3549ae1e8bfd
+  data.tar.gz: 556b244e3c93b4b4d66f450a99d125edf20ede805b4e89831fbd21110054bab971dbf00d9a1b91a94a6891c5cb3ff1b7a01c25e60b1cc2012bb7c0254a43ae10

data/CHANGELOG.md

@@ -5,6 +5,32 @@ 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/v2.0.0.html).
 
+## [2.2.0] - 2026-05-08
+
+### Added
+- **Theme-aware README logo**: Added dark-mode/light-mode logo switching via `<picture>` in `README.md`
+- **Shared ID type mapping module**: Added `SqliteCrypto::IdTypes` to centralize UUID/ULID limit and type detection logic
+- Unit specs for `SqliteCrypto::IdTypes`
+
+### Changed
+- Refactored schema dumper, migration helpers, model extensions, and SQLite adapter extension to use `SqliteCrypto::IdTypes`
+- Updated `.ruby-version` from `4.0.0` to `4.0.3`
+- Refreshed README badges and compatibility notes
+
+### Fixed
+- Removed repeated migration fixture loading warning by replacing `load` with `require_relative` in migration integration spec
+
+## [2.1.0] - 2026-03-22
+
+### Added
+- **Auto primary key generation**: Models with UUID or ULID primary keys now automatically generate
+  their primary key on create — no explicit `generates_uuid`/`generates_ulid` call needed
+- `_sqlite_crypto_pk_type` class method for inspecting the detected primary key type (`:uuid`, `:ulid`, or `nil`).
+  Detection is based on column schema (string, limit 36 → `:uuid`; limit 26 → `:ulid`) and is cached per class
+
+### Acknowledgements
+- Thanks to [@joel](https://github.com/joel) for the contribution in [#20](https://github.com/bart-oz/sqlite_crypto/pull/20)
+
 ## [2.0.2] - 2026-02-11
 
 ### Fixed
@@ -145,4 +171,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Fixed
 - Rails version compatibility for migrations (supports Rails 7.1 through 8.1)
 - Schema dumper prepend timing by loading sqlite3_adapter explicitly
-- ULID foreign key detection with proper table name pluralization
+- ULID foreign key detection with proper table name pluralization

data/README.md

@@ -1,11 +1,28 @@
-# SQLite Crypto
-
-[![Version](https://img.shields.io/badge/version-2.0.2-blue.svg)](https://github.com/bart-oz/sqlite_crypto/releases)
-[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE.txt)
-[![types supported](https://img.shields.io/badge/types-ULID,_UUIDv7/v4-brightgreen.svg)](https://github.com/bart-oz/sqlite_crypto)
-[![Tests](https://img.shields.io/badge/tests-passing-brightgreen.svg)](https://github.com/bart-oz/sqlite_crypto/actions)
-[![Coverage](https://img.shields.io/badge/coverage-98.06%25-brightgreen.svg)](https://github.com/bart-oz/sqlite_crypto/actions)
-[![Status](https://img.shields.io/badge/status-active-success.svg)](https://github.com/bart-oz/sqlite_crypto)
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset=".github/workflows/logo_dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset=".github/workflows/logo_light.svg">
+    <img alt="sqlite_crypto logo" src=".github/workflows/logo_light.svg" width="220">
+  </picture>
+</p>
+
+<p align="center">
+  <a href="https://github.com/bart-oz/sqlite_crypto/releases">
+    <img src="https://img.shields.io/badge/version-2.2.0-blue.svg" alt="Version">
+  </a>
+  <a href="LICENSE.txt">
+    <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License">
+  </a>
+  <a href="https://github.com/bart-oz/sqlite_crypto">
+    <img src="https://img.shields.io/badge/types-ULID,_UUIDv7/v4-brightgreen.svg" alt="Types supported">
+  </a>
+  <a href="https://github.com/bart-oz/sqlite_crypto/actions/workflows/ci.yml">
+    <img src="https://github.com/bart-oz/sqlite_crypto/actions/workflows/ci.yml/badge.svg" alt="Tests">
+  </a>
+  <a href="https://github.com/bart-oz/sqlite_crypto">
+    <img src="https://img.shields.io/badge/status-active-success.svg" alt="Status">
+  </a>
+</p>
 
 ## Overview
 
@@ -24,11 +41,11 @@ end
 - Automatic foreign key type detection
 - Model-level ID generation
 - Clean schema.rb output
-- Zero external dependencies
+- Lightweight runtime dependencies (`rails`, `sqlite3`, `ulid`)
 
 ## Compatibility
 
-**Ruby & Rails:**
+**Ruby & Rails tested in CI:**
 
 |       | Rails 7.1 | Rails 7.2 | Rails 8.0 | Rails 8.1 |
 |-------|-----------|-----------|-----------|-----------|
@@ -38,6 +55,11 @@ end
 | Ruby 3.4 | ✓ | ✓ | ✓ | ✓ |
 | Ruby 4.0 | ✓ | ✓ | ✓ | ✓ |
 
+**Upstream lifecycle note (as of 2026-05-08):**
+- Ruby 3.1 is EOL; Ruby 3.2 is EOL.
+- Rails 7.1 is EOL.
+- Rails 7.2 is security-fixes-only; Rails 8.0 and 8.1 are actively supported.
+
 **UUID Versions:**
 
 | Version | Ruby 3.1/3.2 | Ruby 3.3+ |
@@ -127,9 +149,28 @@ create_table :posts do |t|
 end
 ```
 
-**Model-Level Generation**
+**Automatic Primary Key Generation**
+
+When a table uses `id: :uuid` or `id: :ulid`, the gem automatically generates
+primary key values on record creation. No model-level configuration is needed:
+
+```ruby
+# migration
+create_table :users, id: :uuid do |t|
+  t.string :email
+end
+
+# model — no extra code required
+class User < ApplicationRecord
+end
+
+user = User.create!(email: "test@example.com")
+user.id  # => "018d3f91-8f4a-7000-9e7b-4a5c8d2e1f3a"
+```
+
+**Non-Primary-Key Columns**
 
-Generate UUIDs or ULIDs for any column:
+Generate UUIDs or ULIDs for additional columns with `generates_uuid` / `generates_ulid`:
 
 ```ruby
 class User < ApplicationRecord
@@ -218,4 +259,4 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/bart-o
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](LICENSE.txt).
+The gem is available as open source under the terms of the [MIT License](LICENSE.txt).

data/lib/sqlite_crypto/id_types.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module SqliteCrypto
+  module IdTypes
+    UUID_LENGTH = 36
+    ULID_LENGTH = 26
+
+    TYPE_TO_LIMIT = {
+      uuid: UUID_LENGTH,
+      ulid: ULID_LENGTH
+    }.freeze
+    LIMIT_TO_TYPE = TYPE_TO_LIMIT.invert.freeze
+
+    module_function
+
+    def string_limit_for(type)
+      TYPE_TO_LIMIT[type]
+    end
+
+    def type_from_string_limit(limit)
+      LIMIT_TO_TYPE[limit]
+    end
+
+    def type_from_sql_type(sql_type)
+      case sql_type.to_s.downcase
+      when "varchar(#{UUID_LENGTH})", "uuid" then :uuid
+      when "varchar(#{ULID_LENGTH})", "ulid" then :ulid
+      end
+    end
+  end
+end

data/lib/sqlite_crypto/migration_helpers.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "active_record/connection_adapters/sqlite3_adapter"
+require "sqlite_crypto/id_types"
 
 module SqliteCrypto
   module MigrationHelpers
@@ -21,7 +22,7 @@ module SqliteCrypto
 
         if (primary_key_type = detect_primary_key_type(ref_table))
           options[:type] ||= :string
-          options[:limit] ||= (primary_key_type == :uuid) ? 36 : 26
+          options[:limit] ||= IdTypes.string_limit_for(primary_key_type)
         end
 
         super
@@ -43,10 +44,7 @@ module SqliteCrypto
         pk_column = find_primary_key_column(table_name, conn)
         return nil unless pk_column
 
-        case pk_column.sql_type.downcase
-        when "varchar(36)", "uuid" then :uuid
-        when "varchar(26)", "ulid" then :ulid
-        end
+        IdTypes.type_from_sql_type(pk_column.sql_type)
       end
 
       def find_primary_key_column(table_name, conn)

data/lib/sqlite_crypto/model_extensions.rb

@@ -1,11 +1,31 @@
 # frozen_string_literal: true
 
 require "ulid"
+require "sqlite_crypto/id_types"
 
 module SqliteCrypto
   module ModelExtensions
     extend ActiveSupport::Concern
 
+    included do
+      before_create :_sqlite_crypto_auto_generate_id
+    end
+
+    private
+
+    def _sqlite_crypto_auto_generate_id
+      pk = self.class.primary_key
+      return unless pk
+      return if self[pk].present?
+
+      case self.class._sqlite_crypto_pk_type
+      when :uuid
+        self[pk] = SqliteCrypto::Generators::Uuid.generate
+      when :ulid
+        self[pk] = ULID.generate.to_s
+      end
+    end
+
     module ClassMethods
       def generates_uuid(attribute, unique: false)
         before_create do
@@ -22,6 +42,31 @@ module SqliteCrypto
 
         validates attribute, uniqueness: true if unique
       end
+
+      # Detect if primary key is UUID or ULID based on column schema.
+      # Cached per class. Returns :uuid, :ulid, or nil.
+      def _sqlite_crypto_pk_type
+        return @_sqlite_crypto_pk_type if defined?(@_sqlite_crypto_pk_type)
+        @_sqlite_crypto_pk_type = _detect_sqlite_crypto_pk_type
+      end
+
+      private
+
+      def _detect_sqlite_crypto_pk_type
+        return nil if abstract_class?
+        return nil unless table_exists?
+
+        pk = primary_key
+        return nil unless pk
+
+        column = columns_hash[pk]
+        return nil unless column
+        return nil unless column.type == :string
+
+        IdTypes.type_from_string_limit(column.limit)
+      rescue ActiveRecord::StatementInvalid
+        nil
+      end
     end
   end
 end

data/lib/sqlite_crypto/schema_dumper.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "sqlite_crypto/id_types"
+
 module SqliteCrypto
   module SchemaDumper
     private
@@ -7,11 +9,10 @@ module SqliteCrypto
     def column_spec_for_primary_key(column)
       return super unless column.name == "id" && column.type == :string
 
-      case column.limit
-      when 36 then {id: :uuid}
-      when 26 then {id: :ulid}
-      else super
-      end
+      primary_key_type = IdTypes.type_from_string_limit(column.limit)
+      return super unless primary_key_type
+
+      {id: primary_key_type}
     end
   end
 end

data/lib/sqlite_crypto/sqlite3_adapter_extension.rb

@@ -1,11 +1,13 @@
 # frozen_string_literal: true
 
+require "sqlite_crypto/id_types"
+
 module SqliteCrypto
   module Sqlite3AdapterExtension
     def native_database_types
       super.merge(
-        uuid: {name: "varchar", limit: 36},
-        ulid: {name: "varchar", limit: 26}
+        uuid: {name: "varchar", limit: IdTypes::UUID_LENGTH},
+        ulid: {name: "varchar", limit: IdTypes::ULID_LENGTH}
       )
     end
   end

data/lib/sqlite_crypto/version.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module SqliteCrypto
-  VERSION = "2.0.2"
+  VERSION = "2.2.0"
   RUBY_MINIMUM_VERSION = "3.1.0"
   RAILS_MINIMUM_VERSION = "7.1.0"
 end

data/lib/sqlite_crypto.rb

@@ -5,6 +5,7 @@ require "sqlite_crypto/configuration"
 require "sqlite_crypto/railtie" if defined?(Rails)
 require "sqlite_crypto/schema_dumper" if defined?(ActiveRecord)
 require "sqlite_crypto/schema_definitions"
+require "sqlite_crypto/id_types"
 require "sqlite_crypto/generators/uuid"
 
 module SqliteCrypto

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sqlite_crypto
 version: !ruby/object:Gem::Version
-  version: 2.0.2
+  version: 2.2.0
 platform: ruby
 authors:
 - BartOz
@@ -69,6 +69,7 @@ files:
 - lib/sqlite_crypto.rb
 - lib/sqlite_crypto/configuration.rb
 - lib/sqlite_crypto/generators/uuid.rb
+- lib/sqlite_crypto/id_types.rb
 - lib/sqlite_crypto/migration_helpers.rb
 - lib/sqlite_crypto/model_extensions.rb
 - lib/sqlite_crypto/railtie.rb
@@ -98,7 +99,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.6
 specification_version: 4
 summary: UUID (v4/v7) and ULID primary keys for Rails + SQLite3
 test_files: []