rsnowflake 0.1.0-x86_64-linux

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 878d11a728ddcba4c4ce661e2312475a8353c6c569b9fdf38877b547d1e36c7f
+  data.tar.gz: 5ad63eca57a81e6aeb607f38a60319eed9efcac55e1c0e4990d658587097490f
+SHA512:
+  metadata.gz: 996a6eaea7d446d73913a4dfc2712010234c671490d99fd65098d2e368ee12527c0878e7fab003d3bdf1e63f631f47346d50b5177dc0d62475f7c195f184ac39
+  data.tar.gz: b8718f821bdabe7f8bac46bd309c55c952ebc919cc061af86b21b4b943d3c1fa7651d87c823a063992eeb5790cebfaf807418e0b209849ea997568e986327f85

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Luiz Eduardo Kowalski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,69 @@
+# Rsnowflake
+
+Fast Snowflake ID generator with a Rust backend. Thread-safe and highly performant.
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem "rsnowflake"
+```
+
+## Usage
+
+### Basic
+
+```ruby
+require "rsnowflake"
+
+id = Rsnowflake.id
+# => 7193489234823847936
+```
+
+### Configuration
+
+```ruby
+Rsnowflake.configure do |config|
+  config.machine_id = 42                    # Default: Process.pid % 1024
+  config.epoch = Time.utc(2024, 1, 1)       # Default: Unix epoch
+end
+```
+
+### Parsing IDs
+
+```ruby
+id = Rsnowflake.id
+
+Rsnowflake.parse(id)
+# => {timestamp_ms: 1735123456789, machine_id: 42, sequence: 0}
+
+Rsnowflake.timestamp(id)
+# => 2024-12-25 12:34:56 +0000
+
+Rsnowflake.timestamp_ms(id)
+# => 1735123456789
+
+Rsnowflake.machine_id(id)
+# => 42
+
+Rsnowflake.sequence(id)
+# => 0
+```
+
+## Requirements
+
+- Ruby >= 3.2
+- Rust toolchain (for compilation)
+
+## Development
+
+```bash
+bundle install
+bundle exec rake compile
+bundle exec ruby test/test_rsnowflake.rb
+```
+
+## License
+
+MIT

data/lib/rsnowflake/adapter_extension.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Rsnowflake
+  module AdapterExtension
+    SNOWFLAKE_TYPE = { name: "bigint" }.freeze
+
+    def native_database_types
+      super.merge(snowflake: SNOWFLAKE_TYPE)
+    end
+  end
+end

data/lib/rsnowflake/model_extensions.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Rsnowflake
+  module ModelExtensions
+    extend ActiveSupport::Concern
+
+    class_methods do
+      def snowflake_id(*attributes)
+        attributes = [:id] if attributes.empty?
+
+        class_attribute :_snowflake_attributes, instance_writer: false, default: []
+        self._snowflake_attributes = _snowflake_attributes | attributes.map(&:to_sym)
+
+        before_validation :_generate_snowflake_ids, on: :create
+      end
+    end
+
+    private
+
+    def _generate_snowflake_ids
+      self.class._snowflake_attributes.each do |attribute|
+        next if self[attribute].present?
+
+        self[attribute] = Rsnowflake.id
+      end
+    end
+  end
+end

data/lib/rsnowflake/railtie.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "rails/railtie"
+
+module Rsnowflake
+  class Railtie < Rails::Railtie
+    initializer "rsnowflake.register_type", after: "active_record.initialize_database" do
+      ActiveSupport.on_load(:active_record) do
+        require "rsnowflake/type/snowflake"
+        ActiveRecord::Type.register(:snowflake, Rsnowflake::Type::Snowflake)
+      end
+    end
+
+    initializer "rsnowflake.extend_adapters", after: "active_record.initialize_database" do
+      ActiveSupport.on_load(:active_record) do
+        require "rsnowflake/adapter_extension"
+
+        adapters = %w[
+          PostgreSQLAdapter
+          Mysql2Adapter
+          TrilogyAdapter
+          SQLite3Adapter
+        ]
+
+        adapters.each do |adapter_name|
+          next unless ActiveRecord::ConnectionAdapters.const_defined?(adapter_name)
+
+          adapter = ActiveRecord::ConnectionAdapters.const_get(adapter_name)
+          adapter.prepend(Rsnowflake::AdapterExtension)
+        end
+      end
+    end
+
+    initializer "rsnowflake.schema_definitions", after: "active_record.initialize_database" do
+      ActiveSupport.on_load(:active_record) do
+        require "rsnowflake/schema_definitions"
+
+        ActiveRecord::ConnectionAdapters::TableDefinition.include(Rsnowflake::SchemaDefinitions::TableDefinition)
+        ActiveRecord::ConnectionAdapters::Table.include(Rsnowflake::SchemaDefinitions::Table)
+      end
+    end
+
+    initializer "rsnowflake.model_extensions", after: "active_record.initialize_database" do
+      ActiveSupport.on_load(:active_record) do
+        require "rsnowflake/model_extensions"
+        ActiveRecord::Base.include(Rsnowflake::ModelExtensions)
+      end
+    end
+  end
+end

data/lib/rsnowflake/schema_definitions.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Rsnowflake
+  module SchemaDefinitions
+    module TableDefinition
+      def snowflake(name, **options)
+        column(name, :snowflake, **options)
+      end
+    end
+
+    module Table
+      def snowflake(name, **options)
+        column(name, :snowflake, **options)
+      end
+    end
+  end
+end

data/lib/rsnowflake/type/snowflake.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Rsnowflake
+  module Type
+    class Snowflake < ActiveRecord::Type::BigInteger
+      def type
+        :snowflake
+      end
+    end
+  end
+end

data/lib/rsnowflake/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Rsnowflake
+  VERSION = "0.1.0"
+end

data/lib/rsnowflake.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+require_relative "rsnowflake/version"
+require_relative "rsnowflake/rsnowflake"
+
+require_relative "rsnowflake/railtie" if defined?(Rails::Railtie)
+
+module Rsnowflake
+  MAX_MACHINE_ID = 1023
+
+  class Error < StandardError; end
+  class ConfigurationError < Error; end
+
+  class Configuration
+    attr_accessor :machine_id, :epoch
+
+    def initialize
+      @machine_id = nil
+      @epoch      = nil
+    end
+
+    def machine_id_value
+      id = @machine_id || default_machine_id
+      id % (MAX_MACHINE_ID + 1)
+    end
+
+    def epoch_ms
+      return nil unless @epoch
+
+      (@epoch.to_f * 1000).to_i
+    end
+
+    private
+
+    def default_machine_id
+      Process.pid % (MAX_MACHINE_ID + 1)
+    end
+  end
+
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration) if block_given?
+      ensure_initialized!
+      configuration
+    end
+
+    def id
+      ensure_initialized!
+      Internal.generate
+    end
+
+    def parse(id)
+      ensure_initialized!
+      Internal.parse(id)
+    end
+
+    def timestamp(id)
+      time_ms = Internal.timestamp_ms(id)
+      Time.at(time_ms / 1000, (time_ms % 1000) * 1000, :usec)
+    end
+
+    def timestamp_ms(id)
+      Internal.timestamp_ms(id)
+    end
+
+    def machine_id(id)
+      Internal.machine_id(id)
+    end
+
+    def sequence(id)
+      Internal.sequence(id)
+    end
+
+    def reset!
+      raise ConfigurationError, "Cannot reset after initialization" if Internal.initialized?
+
+      @configuration = Configuration.new
+    end
+
+    private
+
+    def ensure_initialized!
+      return if Internal.initialized?
+
+      config = configuration
+      Internal.init_generator(config.machine_id_value, config.epoch_ms)
+    end
+  end
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification
+name: rsnowflake
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: x86_64-linux
+authors:
+- Luiz Eduardo Kowalski
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-01-06 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.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- lib/rsnowflake.rb
+- lib/rsnowflake/3.2/rsnowflake.so
+- lib/rsnowflake/3.3/rsnowflake.so
+- lib/rsnowflake/3.4/rsnowflake.so
+- lib/rsnowflake/4.0/rsnowflake.so
+- lib/rsnowflake/adapter_extension.rb
+- lib/rsnowflake/model_extensions.rb
+- lib/rsnowflake/railtie.rb
+- lib/rsnowflake/rsnowflake.bundle
+- lib/rsnowflake/schema_definitions.rb
+- lib/rsnowflake/type/snowflake.rb
+- lib/rsnowflake/version.rb
+homepage: https://github.com/luizkowalski/rsnowflake
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/luizkowalski/rsnowflake
+  source_code_uri: https://github.com/luizkowalski/rsnowflake
+  changelog_uri: https://github.com/luizkowalski/rsnowflake/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/luizkowalski/rsnowflake/issues
+  rubygems_mfa_required: 'true'
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: 4.1.dev
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.23
+signing_key: 
+specification_version: 4
+summary: Fast Snowflake ID generator with Rust backend
+test_files: []