snowflaked 0.1.3-arm-linux → 0.2.0-arm-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 38fc2352d02dd80016be6d3998758807ce1a4ccb38d1d023cc6162b08cbf9d1a
-  data.tar.gz: 0ae9a58b29de3bef02ce745d4e8fe6d53f7e4320403d392316b8ea87a357f675
+  metadata.gz: f29453adb3b5beb29e002cd5471ffa8dd00c11ba2bf3ae1160045fe4234445d8
+  data.tar.gz: eab2733f6bbde075997970e72ed644580ddd208dc9a00d2f522489c98a048ab0
 SHA512:
-  metadata.gz: 9861a1d5b31bb0089bdbd7099bfa22e18d37f6079e0e7e03394686ef874575547d4bfc214c2baa02001e18afa1356667a23c9e2efb64dee06e3778aaa14f7a8f
-  data.tar.gz: b588edc1d663adf0e6a59c6ef6c5c7b0ccff64450838d95b4d17ae27372f4cd621c08e70811bb437312c56cfc789e2d5fda21fb19c8e99686e3ad04988767da3
+  metadata.gz: 2cbcc046f261d2802a8b5a4c980d5be51a12f2ae8acb232c40365d20b073645ceb5801660380b6e66ac4d7e6ad0a0fdf58e26b0e631478db8133504debcb6305
+  data.tar.gz: f2dc3cdfe2063ac7b0a5add70488c79dce1b8a33f611bbc6b8e9f9ed0aa016cf1a208ccb5b0d9a276c4c8fe67eeb9a095dab8761fbca3ee1dba4318e64d2c54b

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.
 
@@ -143,6 +143,12 @@ Snowflaked.machine_id(id)
 # => 42
 ```
 
+## Benchmarks
+
+See [BENCHMARKS.md](benchmarks/README.md) for more details.
+
+tl;dr: Snowflake IDs have a negligible performance impact compared to database-backed IDs.
+
 ## Requirements
 
 - Ruby >= 3.2

data/lib/snowflaked/model_extensions.rb

@@ -14,25 +14,27 @@ 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 @_snowflake_columns_from_comments if defined?(@_snowflake_columns_from_comments)
 
-        @_snowflake_columns_from_comments = if table_exists?
-          columns.filter_map { |col| col.name.to_sym if col.comment == Snowflaked::SchemaDefinitions::COMMENT }
-        else
-          []
-        end
+        @_snowflake_columns_from_comments = table_exists? ? columns.filter_map { |col| col.name.to_sym if col.comment == Snowflaked::SchemaDefinitions::COMMENT } : []
+      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 = self.class._snowflake_attributes_with_columns
+      return if attributes.empty?
 
-      attributes_to_generate.each do |attribute|
+      attributes.each do |attribute|
         next if self[attribute].present?
 
         self[attribute] = Snowflaked.id

data/lib/snowflaked/version.rb

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

data/lib/snowflaked.rb

@@ -29,8 +29,7 @@ module Snowflaked
     end
 
     def machine_id_value
-      id = @machine_id || default_machine_id
-      id % (MAX_MACHINE_ID + 1)
+      (@machine_id || default_machine_id) % (MAX_MACHINE_ID + 1)
     end
 
     def epoch_ms
@@ -46,8 +45,7 @@ module Snowflaked
     end
 
     def env_machine_id
-      id = ENV["SNOWFLAKED_MACHINE_ID"] || ENV.fetch("MACHINE_ID", nil)
-      id&.to_i
+      (ENV["SNOWFLAKED_MACHINE_ID"] || ENV.fetch("MACHINE_ID", nil))&.to_i
     end
 
     def hostname_pid_hash
@@ -68,8 +66,8 @@ module Snowflaked
     end
 
     def id
-      ensure_initialized!
-      Native.generate
+      config = configuration
+      Native.generate(config.machine_id_value, config.epoch_ms)
     end
 
     def parse(id)
@@ -78,16 +76,17 @@ module Snowflaked
     end
 
     def timestamp(id)
-      time_ms = Native.timestamp_ms(id)
-      Time.at(time_ms / 1000, (time_ms % 1000) * 1000, :usec)
+      ensure_initialized!
+      seconds, milliseconds = Native.timestamp_ms(id).divmod(1000)
+      Time.at(seconds, milliseconds * 1000, :usec)
     end
 
     def machine_id(id)
-      ensure_initialized!
       Native.machine_id(id)
     end
 
     def timestamp_ms(id)
+      ensure_initialized!
       Native.timestamp_ms(id)
     end
 
@@ -100,8 +99,7 @@ module Snowflaked
     def ensure_initialized!
       return if Native.initialized?
 
-      config = configuration
-      Native.init_generator(config.machine_id_value, config.epoch_ms)
+      Native.init_generator(configuration.machine_id_value, configuration.epoch_ms)
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: snowflaked
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: arm-linux
 authors:
 - Luiz Eduardo Kowalski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-01-11 00:00:00.000000000 Z
+date: 2026-02-27 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.