exid 0.2.3 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b7c057e8f11b8952ddb14c27276cb9e653ee15e5c85d85562b5298f82ab9dd06
-  data.tar.gz: fc0538aef4b5d3ad5c4ce4cc34c723b84620c1d09b07dc3dd1faf4f2caa4ab5a
+  metadata.gz: 4eb23e13b909473e539162d5f64a66484a8f011755bd682396dfb2d8ad887061
+  data.tar.gz: ff100d61bdacb3905ce6af220b0ea0db99e48ea95220a918b85d4db635179235
 SHA512:
-  metadata.gz: 6edcc8eb8ac4eb3e2930716be839e2b787237a2506549392853f830ffe8dc75c10bf816295827b783415a39962cb4916e051cd985d39a031aa1a076856777474
-  data.tar.gz: '0865032bbeb7b83eaf19cf83e1ba56a7d33d3027325d30b20aa37884760a0fb4586fbdbc236f00a933e4c388dee9fe78b4e8176cfaab3257f36f140983a53039'
+  metadata.gz: fe29be83c5e93a28b331004561f183be762ffec8f080787edb6516fa3b277a4a0716822671e1b1e396bb521f89822098b44ea095e957cdf855967876e4bbdd30
+  data.tar.gz: 753e4f90ee4a5255bc80673c652a9b0667fda8bf8c1efd6cd797590b6fce17818d586f5b2742fc83acb3c84d8f8af14104e044b4b4a343f4a146ce3202961989

data/lib/exid/record.rb

@@ -3,7 +3,9 @@ module Exid
     MUTEX = Mutex.new
 
     Entry =
-      Data.define(:prefix, :field, :klass) do
+      Data.define(:prefixes, :field, :klass) do
+        def prefix = prefixes.first
+
         def ==(other) = prefix == other.prefix
 
         def hash = prefix.hash
@@ -21,19 +23,25 @@ module Exid
 
       self.class.register_module(
         Entry.new(
-          prefix: base.exid_prefix_name,
+          prefixes: base.exid_prefix_names,
           field: base.exid_field,
           klass: base
         )
       )
     end
 
+    # The prefix can be a single String or an Array of Strings. The first
+    # prefix is the canonical one, used to generate external IDs. Any
+    # additional prefixes are treated as aliases and are only used to locate
+    # records. This allows renaming a prefix without breaking existing IDs.
+
     def initialize(prefix, field)
-      Exid.configuration.validate_prefix(prefix)
+      prefixes = Array(prefix)
+      prefixes.each { |item| Exid.configuration.validate_prefix(item) }
 
-      @module_static = build_module_static(prefix, field)
-      @module_value = build_module_value(prefix, field)
-      @module_shared = build_module_shared(prefix, field)
+      @module_static = build_module_static(prefixes, field)
+      @module_value = build_module_value(prefixes.first, field)
+      @module_shared = build_module_shared(prefixes, field)
 
       super()
     end
@@ -63,7 +71,7 @@ module Exid
     end
 
     def self.find_module(prefix)
-      registered_modules.detect { _1.prefix == prefix } or
+      registered_modules.detect { _1.prefixes.include?(prefix) } or
         raise Error, "Model for \"#{prefix}\" not found"
     end
 
@@ -97,10 +105,14 @@ module Exid
       end
     end
 
-    def build_module_shared(prefix, field)
+    def build_module_shared(prefixes, field)
       Module.new do
         define_method :exid_prefix_name do
-          prefix
+          prefixes.first
+        end
+
+        define_method :exid_prefix_names do
+          prefixes
         end
 
         define_method :exid_field do
@@ -109,10 +121,11 @@ module Exid
       end
     end
 
-    def build_module_static(prefix, field)
+    def build_module_static(prefixes, field)
       Module.new do
         define_method :exid_loader do |eid|
-          Coder.decode(eid) => ^prefix, value
+          Coder.decode(eid) => prefix, value
+          prefixes.include?(prefix) or raise NoMatchingPatternError
           find_sole_by(field => value)
         end
       end

data/lib/exid/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Exid
-  VERSION = "0.2.3"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: exid
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.3.0
 platform: ruby
 authors:
 - John Doe