cool_id 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 31e57670575a5ab4ca42bdd225ada7b79aad7ff9bbd5ad9ffd72374cd121bf07
-  data.tar.gz: 02e56f84df9d458da1e7e93dc7ec8ff5bcfb33fdfd399f58fed40b36cd3995ea
+  metadata.gz: e34a657a23c3321adf021f9ab101a6cee1f792a3e8b71c11702663dd92ac6883
+  data.tar.gz: f364193fe7ec136a8a436032a5de7b16a7db6b32b4901baa72f3eaa4a39267ea
 SHA512:
-  metadata.gz: 91c18c5d5a6be61f1f6ece0ddb1b7625c3d0c4675ec690550785221244a889b808c8032b22b79e8987d46cf5e5435f3f11b332298edc57a149348bf6f6f312f4
-  data.tar.gz: 138806308d00d10e64387254bfaef9650fbfe48e89d2201d301b385f26b9713120ee86ec8b0ed750e138accfa30ae1dfd7f15d3604b1b56275d5d3e40955f825
+  metadata.gz: 54f60190090f171c8c9f3df697378ad65fb9224551b208fadaddf0b4e2da37818126cbb52127a79e32ede2156f9e59cfe81eedfd20a7bd50dcac83371056806e
+  data.tar.gz: eb277e15108b217785785803a854d6f88405d2e9fd2b8bcf84583890fbb1fb8a48b2392c2b2a9aa20567d547f92fd5ccd2bce946636acc8ccb1e7781d8985e87

data/lib/cool_id/version.rb

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

data/lib/cool_id.rb

@@ -3,35 +3,106 @@
 require_relative "cool_id/version"
 require "nanoid"
 require "active_support/concern"
-require "active_record"
 
 module CoolId
   class Error < StandardError; end
 
-  # defaults copped from
-  # https://planetscale.com/blog/why-we-chose-nanoids-for-planetscales-api
-  DEFAULT_ALPHABET = "0123456789abcdefghijklmnopqrstuvwxyz"
   DEFAULT_SEPARATOR = "_"
+  DEFAULT_ALPHABET = "0123456789abcdefghijklmnopqrstuvwxyz"
   DEFAULT_LENGTH = 12
 
-  def self.generate_id(prefix: "", separator: DEFAULT_SEPARATOR, length: DEFAULT_LENGTH, alphabet: DEFAULT_ALPHABET)
-    id = Nanoid.generate(size: length, alphabet: alphabet)
-    [prefix, id].reject(&:empty?).join(separator)
+  Id = Struct.new(:key, :prefix, :id, :model_class)
+
+  class << self
+    attr_accessor :separator, :alphabet, :length
+
+    def configure
+      yield self
+    end
+
+    def reset_configuration
+      self.separator = DEFAULT_SEPARATOR
+      self.alphabet = DEFAULT_ALPHABET
+      self.length = DEFAULT_LENGTH
+    end
+
+    def registry
+      @registry ||= Registry.new
+    end
+
+    def generate_id(config)
+      alphabet = config.alphabet || @alphabet
+      length = config.length || @length
+      id = Nanoid.generate(size: length, alphabet: alphabet)
+
+      "#{config.prefix}#{separator}#{id}"
+    end
+  end
+
+  # defaults based on https://planetscale.com/blog/why-we-chose-nanoids-for-planetscales-api
+  self.separator = DEFAULT_SEPARATOR
+  self.alphabet = DEFAULT_ALPHABET
+  self.length = DEFAULT_LENGTH
+
+  class Registry
+    def initialize
+      @registry = {}
+    end
+
+    def register(prefix, model_class)
+      @registry[prefix] = model_class
+    end
+
+    def locate(id)
+      parsed = parse(id)
+      parsed&.model_class&.find_by(id: id)
+    end
+
+    def parse(id)
+      prefix, key = id.split(CoolId.separator, 2)
+      model_class = @registry[prefix]
+      return nil unless model_class
+      Id.new(key, prefix, id, model_class)
+    end
+  end
+
+  class Config
+    attr_reader :prefix, :length, :alphabet
+
+    def initialize(prefix:, length: nil, alphabet: nil)
+      @length = length
+      @prefix = validate_prefix(prefix)
+      @alphabet = validate_alphabet(alphabet)
+    end
+
+    private
+
+    def validate_prefix(value)
+      raise ArgumentError, "Prefix cannot be nil" if value.nil?
+      raise ArgumentError, "Prefix cannot consist only of whitespace" if value.strip.empty?
+      value
+    end
+
+    def validate_alphabet(value)
+      return nil if value.nil?
+      raise ArgumentError, "Alphabet cannot include the separator '#{CoolId.separator}'" if value.include?(CoolId.separator)
+      value
+    end
   end
 
   module Model
     extend ActiveSupport::Concern
 
     class_methods do
-      attr_accessor :cool_id_prefix, :cool_id_separator, :cool_id_alphabet, :cool_id_length
+      attr_reader :cool_id_config
+
+      def cool_id(options)
+        @cool_id_config = Config.new(**options)
+        CoolId.registry.register(options[:prefix], self)
+      end
 
       def generate_cool_id
-        CoolId.generate_id(
-          prefix: cool_id_prefix,
-          separator: cool_id_separator || DEFAULT_SEPARATOR,
-          length: cool_id_length || DEFAULT_LENGTH,
-          alphabet: cool_id_alphabet || DEFAULT_ALPHABET
-        )
+        CoolId.generate_id(@cool_id_config)
       end
     end
 
@@ -45,4 +116,12 @@ module CoolId
       end
     end
   end
+
+  def self.locate(id)
+    registry.locate(id)
+  end
+
+  def self.parse(id)
+    registry.parse(id)
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cool_id
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Peter Schilling
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-08-16 00:00:00.000000000 Z
+date: 2024-08-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nanoid