snowflaked 0.1.2-arm64-darwin → 0.1.4-arm64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ff4c8c12b1b346309c667629ac55415183cca7b14e2ead0c192b15e3876c7c19
-  data.tar.gz: 401703a18483d9f3bf35c490e45083d37203658ff3569017fdf08398061634d3
+  metadata.gz: ceac20762522ab00158a0c87b6d2d10e01812cd4d6a30eb5ba01a2e0c91f7075
+  data.tar.gz: b7d4dd18078f5cb38b2125db47098a545183f13b4d4e2c90d17e37ab40ff8e94
 SHA512:
-  metadata.gz: 341aaab30aaf14009055e7ba1cec600a23719c1bbdba801b0213cb988e082d4e0edc9e8dca631c105eb234003f8d9ed8a1e68b838aafea6ece36a80681b55015
-  data.tar.gz: 86dcd111d833775e966cd56d7f3ebda9e8e0109aca9873faa54fc6b1ae0fb18d2de689f426a361ad75fb702d2b2d6022af4cfe4681e936df2e07af3250c1b979
+  metadata.gz: 94d6ab9a85a3f1342a87e11ce6a837758d37f4f103d605be6ad938eca1ead7a5532164609ad359a259b94ce06e1919e77678c05a12bd2baada192f328b4ac8a9
+  data.tar.gz: d565dc8d14b4630fe95a437cfbe7c9a446a4daf3eee8d1edfbdc50d61c2faa8eeb6301999b9fb2a6682f73dad0e680001bcf5aaa7ea397bd741825e9c454b25b

data/README.md

@@ -5,7 +5,7 @@
 [![Downloads](https://img.shields.io/gem/dt/snowflaked.svg)](https://rubygems.org/gems/snowflaked)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE.txt)
 
-A high-performance, thread-safe Snowflake ID generator for Ruby, powered by Rust.
+A database-agnostic, high-performance, thread-safe Snowflake ID generator for Ruby, powered by Rust.
 
 Snowflake IDs are 64-bit unique identifiers that encode a timestamp, machine ID, and sequence number. They're time-sortable (IDs created later are always larger), making them ideal for distributed systems where you need unique IDs without coordination between machines. Unlike UUIDs, Snowflake IDs are smaller, sortable, and index-friendly for databases.
 
@@ -87,6 +87,13 @@ Snowflaked.configure do |config|
 end
 ```
 
+### Machine ID
+
+> [!TIP]
+> For multi-process servers like Puma, it is recommended to **not** configure `machine_id` explicitly. The gem automatically calculates a unique machine ID using `(hostname.hash ^ pid) % 1024`, which ensures each forked worker process gets a different ID and avoids duplicate Snowflake IDs.
+
+If you must set `machine_id` explicitly, use environment variables that differ per worker process.
+
 ### Machine ID Resolution
 
 If `machine_id` is not explicitly configured, it resolves in this order:
@@ -136,6 +143,12 @@ Snowflaked.machine_id(id)
 # => 42
 ```
 
+## Benchmarks
+
+See [BENCHMARKS.md](benchmarks/BENCHMARKS.md) for more details.
+
+tl;dr: Snowflake IDs have a negligible performance impact compared to database-backed IDs.
+
 ## Requirements
 
 - Ruby >= 3.2
@@ -151,6 +164,10 @@ bundle install
 bundle exec rake
 ```
 
+## Acknowledgments
+
+- [snowflaked-rs](https://github.com/MrGunflame/snowflaked-rs) - the Rust implementation of Snowflake IDs
+
 ## License
 
 MIT

data/lib/snowflaked/model_extensions.rb

@@ -5,8 +5,8 @@ module Snowflaked
     extend ActiveSupport::Concern
 
     included do
-      class_attribute :_snowflake_attributes, instance_writer: false, default: [:id] # rubocop:disable ThreadSafety/ClassAndModuleAttributes -- false positive
-      before_validation :_generate_snowflake_ids, on: :create
+      class_attribute :_snowflake_attributes, instance_writer: false, default: [:id]
+      after_initialize :_generate_snowflake_ids, if: :new_record?
     end
 
     class_methods do
@@ -14,19 +14,29 @@ module Snowflaked
         attrs = attributes.map(&:to_sym)
         attrs |= [:id] if id
         self._snowflake_attributes = attrs
+        @_snowflake_attributes_with_columns = nil
       end
 
       def _snowflake_columns_from_comments
-        return [] unless table_exists?
+        return @_snowflake_columns_from_comments if defined?(@_snowflake_columns_from_comments)
 
-        columns.filter_map { |col| col.name.to_sym if col.comment == Snowflaked::SchemaDefinitions::COMMENT }
+        @_snowflake_columns_from_comments = if table_exists?
+          columns.filter_map { |col| col.name.to_sym if col.comment == Snowflaked::SchemaDefinitions::COMMENT }
+        else
+          []
+        end
+      end
+
+      def _snowflake_attributes_with_columns
+        @_snowflake_attributes_with_columns ||= (_snowflake_attributes | _snowflake_columns_from_comments)
       end
     end
 
     private
 
     def _generate_snowflake_ids
-      attributes_to_generate = self.class._snowflake_attributes | self.class._snowflake_columns_from_comments
+      attributes_to_generate = self.class._snowflake_attributes_with_columns
+      return if attributes_to_generate.empty?
 
       attributes_to_generate.each do |attribute|
         next if self[attribute].present?

data/lib/snowflaked/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Snowflaked
-  VERSION = "0.1.2"
+  VERSION = "0.1.4"
 end

data/lib/snowflaked.rb

@@ -57,7 +57,7 @@ module Snowflaked
 
   class << self
     def configuration
-      @configuration ||= Configuration.new # rubocop:disable ThreadSafety/ClassInstanceVariable -- not changed after initialization
+      @configuration ||= Configuration.new
     end
 
     def configure

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: snowflaked
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.4
 platform: arm64-darwin
 authors:
 - Luiz Eduardo Kowalski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-01-10 00:00:00.000000000 Z
+date: 2026-01-14 00:00:00.000000000 Z
 dependencies: []
 description: A Ruby gem for generating Twitter Snowflake IDs using a high-performance
   Rust backend. Thread-safe with configurable machine ID and custom epoch support.