universalid 0.1.5 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 86ff30c07adad3183e75fcc333e5fbfe4ff060dae6ad7457fa2d0007f1a24dfa
-  data.tar.gz: 61d5b6fff2f88c78daa6c65797edd56e2770bf253bef8bd14414636b89ae4b76
+  metadata.gz: 8adc71d500029efbc4c0c388042413a4676c101da9f2390a300134a6bde37386
+  data.tar.gz: be284fbc808de8624d2ae7b622439380785af1bce3c50d5bb2f80e229472a1c2
 SHA512:
-  metadata.gz: 03b04be308330e1ff136354af14cdf961ce33bc689a972f246bc4fe131e81b3aa1d482463827c95291f073a22e3377ab16470bee87e6c6c7ab744b52decea695
-  data.tar.gz: 17533452664536cc5ba5a89437fd877ed7eeaee69ac81354013139d87fd8bde7386b0e087159e455492fc7a402d88ff423ff63e73eb21c51dc84d2389007c2d5
+  metadata.gz: 2b40d14b7e93f5559fb5b24f9f47be634a03e083f7d335e951ac9ade937ceca6fc5e382c7e208dcf04d4cd7ab7bb8f0c6ff16748900bca67b60d534afea25651
+  data.tar.gz: 5a15af009bb6a4ea4a148c0787d46b94e795a3debed2af7e9d986a0c0b00b48177fd178653c075a6f28874cb8fc91a3d6446b7a3b891294c396ad0a2538449e4

data/README.md

@@ -2,7 +2,7 @@
 
 <p>
   <a href="http://blog.codinghorror.com/the-best-code-is-no-code-at-all/">
-    <img alt="Lines of Code" src="https://img.shields.io/badge/loc-795-47d299.svg" />
+    <img alt="Lines of Code" src="https://img.shields.io/badge/loc-811-47d299.svg" />
   </a>
   <a href="https://codeclimate.com/github/hopsoft/universalid/maintainability">
     <img src="https://api.codeclimate.com/v1/badges/567624cbe733fafc2330/maintainability" />
@@ -38,7 +38,7 @@
 Universal ID leverages both [MessagePack](https://msgpack.org/) and [Brotli](https://github.com/google/brotli) _(a combo built for speed and best-in-class data compression)_.
 When combined, these libraries are up to 30% faster and within 2-5% compression rates compared to Protobuf. <a title="Source" href="https://g.co/bard/share/e5bdb17aee91">↗</a>
 
-Universal ID opens the flood gates with a deluge of powerful yet easily implemented [**solutions** ↗](docs/use_cases.md) across a variety of problem domains.
+Universal ID introduces a paradigm shift that enables straightforward simple [**solutions** ↗](docs/use_cases.md) for a variety of complex problem domains.
 
 > [!TIP]
 > All the code examples below can be tested on your local machine. Just clone the repo _(↑or use Gitpod above↑)_ and run `bin/console` to begin exploring.
@@ -48,6 +48,7 @@ Universal ID opens the flood gates with a deluge of powerful yet easily implemen
 
 ## Table of Contents
 
+  - [URI::UID](#uriuid)
   - [Supported Data Types](#supported-data-types)
     - [Primitive Types](#primitive-types)
     - [Composite Types](#composite-types)
@@ -64,6 +65,46 @@ Universal ID opens the flood gates with a deluge of powerful yet easily implemen
 
 <!-- Tocer[finish]: Auto-generated, don't remove. -->
 
+## URI::UID
+
+Universal ID introduces a new URI defintion that can recursively serialize any Ruby object into an URL-safe string
+which can be safely transported via HTTP.
+
+> [!NOTE]
+> The payload is optimized to be as small as possible... _especially notable with large objects._
+
+The best part: **The API is simple.**
+
+```ruby
+data = :ANY_OBJECT_YOU_CAN_IMAGINE
+
+uid = URI::UID.build(data)
+#<URI::UID payload=Cw6AxxoAQU5ZX09CSkVDVF9ZT1VfQ0FOX0lNQ..., fingerprint=CwWAkccHf6ZTeW1ib2wD>
+
+uid.payload
+"Cw6AxxoAQU5ZX09CSkVDVF9ZT1VfQ0FOX0lNQUdJTkUD"
+
+uid.fingerprint
+"CwWAkccHf6ZTeW1ib2wD"
+
+uri = uid.to_s
+"uid://universalid/Cw6AxxoAQU5ZX09CSkVDVF9ZT1VfQ0FOX0lNQUdJTkUD#CwWAkccHf6ZTeW1ib2wD"
+
+parsed = URI::UID.parse(uri)
+#<URI::UID payload=Cw6AxxoAQU5ZX09CSkVDVF9ZT1VfQ0FOX0lNQ..., fingerprint=CwWAkccHf6ZTeW1ib2wD>
+
+parsed.decode
+:ANY_OBJECT_YOU_CAN_IMAGINE
+
+# it's also possible to parse the payload by itself
+
+parsed = URI::UID.from_payload(uid.payload)
+#<URI::UID payload=Cw6AxxoAQU5ZX09CSkVDVF9ZT1VfQ0FOX0lNQ..., fingerprint=CwWAkccHf6ZTeW1ib2wD>
+
+parsed.decode
+:ANY_OBJECT_YOU_CAN_IMAGINE
+```
+
 ## Supported Data Types
 
 ### Primitive Types
@@ -165,6 +206,8 @@ The following extension datatypes ship with Universal ID:
 
 - `ActiveRecord::Base`
 - `ActiveRecord::Relation`
+- `ActiveSupport::Cache::Entry`
+- `ActiveSupport::Cache::Store`
 - `ActiveSupport::TimeWithZone`
 - `GlobalID`
 - `SignedGlobalID`

data/lib/universalid/extensions/active_record/base_unpacker.rb

@@ -45,6 +45,7 @@ if defined? ActiveRecord
 
           new_models = models.select(&:new_record?)
           models -= new_models
+          association_collection = record.public_send(name)
 
           # restore persisted models
           # NOTE: ActiveRecord is smart enough to not re-create or re-add
@@ -52,7 +53,10 @@ if defined? ActiveRecord
           record.public_send :"#{name}=", models if models.any?
 
           # restore new unsaved models
-          record.public_send(name).target.concat new_models if new_models.any?
+          association_collection.target.concat new_models if new_models.any?
+
+          # mark association relation as loaded
+          association_collection.proxy_association.instance_variable_set :@loaded, true
         end
       end
     end

data/lib/universalid/extensions/active_support/cache/entry_message_pack_type.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+if defined? ActiveSupport::Cache::Entry
+
+  UniversalID::MessagePackFactory.register(
+    type: ActiveSupport::Cache::Entry,
+    packer: ->(obj, packer) do
+      packer.write obj.value
+      packer.write obj.version
+      packer.write obj.expires_at
+    end,
+    unpacker: ->(unpacker) do
+      value = unpacker.read
+      version = unpacker.read
+      expires_at = unpacker.read
+      ActiveSupport::Cache::Entry.new value, version: version, expires_at: expires_at
+    end
+  )
+
+end

data/lib/universalid/extensions/active_support/cache/store_message_pack_type.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+if defined? ActiveSupport::Cache::Store
+
+  UniversalID::MessagePackFactory.register(
+    type: ActiveSupport::Cache::Store,
+    packer: ->(obj, packer) do
+      packer.write obj.class.name
+      packer.write obj.options
+      packer.write obj.instance_variable_get(:@data)
+    end,
+    unpacker: ->(unpacker) do
+      class_name = unpacker.read
+      options = unpacker.read
+      data = unpacker.read
+      Object.const_get(class_name).new(options).tap do |store|
+        store.instance_variable_set :@data, data
+      end
+    end
+  )
+
+end

data/lib/universalid/extensions/active_support/time_with_zone_message_pack_type.rb

@@ -5,13 +5,13 @@ if defined? ActiveSupport::TimeWithZone
   UniversalID::MessagePackFactory.register(
     type: ActiveSupport::TimeWithZone,
     packer: ->(obj, packer) do
-      packer.write obj.iso8601(9)
-      packer.write obj.zone
+      packer.write obj.to_time.utc
+      packer.write obj.time_zone.tzinfo.identifier
     end,
     unpacker: ->(unpacker) do
-      time = Time.parse(unpacker.read)
-      zone = unpacker.read
-      ActiveSupport::TimeWithZone.new time, ActiveSupport::TimeZone[zone]
+      utc = unpacker.read
+      tz = unpacker.read
+      utc.in_time_zone ActiveSupport::TimeZone[tz]
     end
   )
 

data/lib/universalid/extensions/global_id/global_id_model.rb

@@ -14,14 +14,12 @@ if defined? GlobalID::Identification
     def initialize(universal_id)
       @uid = case universal_id
       when URI::UID then universal_id
-      when String
-        case universal_id
-        when /\A#{URI::UID::SCHEME}/o then URI::UID.parse(universal_id)
-        else URI::UID.parse(URI::UID.build_string(universal_id, self))
-        end
+      when String then URI::UID.match?(universal_id) ?
+        URI::UID.parse(universal_id) :
+        URI::UID.from_payload(universal_id)
       end
 
-      @id = @uid&.payload
+      @id = uid&.payload
     end
   end
 

data/lib/universalid/message_pack_types/{ruby/composites → composites}/struct.rb

@@ -11,7 +11,8 @@ UniversalID::MessagePackFactory.register(
   unpacker: ->(unpacker) do
     class_name = unpacker.read
     hash = unpacker.read
-    klass = Object.const_get(class_name) if Object.const_defined?(class_name)
+    klass = Object.const_get(class_name) if class_name && Object.const_defined?(class_name)
+    klass ||= Struct.new(*hash.keys)
 
     if klass
       # shenanigans to support ::Ruby 3.0.X and 3.1.X

data/lib/universalid/message_pack_types.rb

@@ -3,21 +3,21 @@
 # NOTE: MessagePack scans registered type in linear order and first match wins
 
 # scalars
-require_relative "message_pack_types/ruby/scalars/bigdecimal"
-require_relative "message_pack_types/ruby/scalars/complex"
-require_relative "message_pack_types/ruby/scalars/rational"
-require_relative "message_pack_types/ruby/scalars/date_time"
-require_relative "message_pack_types/ruby/scalars/date"
-require_relative "message_pack_types/ruby/scalars/range"
-require_relative "message_pack_types/ruby/scalars/regexp"
+require_relative "message_pack_types/scalars/bigdecimal"
+require_relative "message_pack_types/scalars/complex"
+require_relative "message_pack_types/scalars/rational"
+require_relative "message_pack_types/scalars/date_time"
+require_relative "message_pack_types/scalars/date"
+require_relative "message_pack_types/scalars/range"
+require_relative "message_pack_types/scalars/regexp"
 
 # composites
-require_relative "message_pack_types/ruby/composites/module"
-require_relative "message_pack_types/ruby/composites/open_struct"
-require_relative "message_pack_types/ruby/composites/struct"
-require_relative "message_pack_types/ruby/composites/set"
+require_relative "message_pack_types/composites/module"
+require_relative "message_pack_types/composites/open_struct"
+require_relative "message_pack_types/composites/struct"
+require_relative "message_pack_types/composites/set"
 
 # extensions
-Dir["#{__dir__}/extensions/**/*.rb"].each { |f| require f }
+Dir["#{__dir__}/extensions/**/*.rb"].sort.each { |f| require f }
 
 UniversalID::MessagePackFactory.create_msgpack_pool

data/lib/universalid/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module UniversalID
-  VERSION = "0.1.5"
+  VERSION = "0.1.7"
 end

data/lib/uri/uid.rb

@@ -9,6 +9,7 @@ unless defined?(::URI::UID) || ::URI.scheme_list.include?("UID")
       VERSION = UniversalID::VERSION
       SCHEME = "uid"
       HOST = "universalid"
+      PATTERN = /\A#{SCHEME}:\/\/#{HOST}\/[-_0-9A-Z]+#[-_0-9A-Z]+\z/io
 
       class << self
         def encoder
@@ -29,6 +30,11 @@ unless defined?(::URI::UID) || ::URI.scheme_list.include?("UID")
           new(*::URI.split(value))
         end
 
+        def match?(uri)
+          return true if uri.is_a?(self)
+          uri.to_s.match? PATTERN
+        end
+
         def build_string(payload, object = nil)
           "#{SCHEME}://#{HOST}/#{payload}##{fingerprint(object)}"
         end
@@ -38,6 +44,17 @@ unless defined?(::URI::UID) || ::URI.scheme_list.include?("UID")
           parse "#{SCHEME}://#{HOST}#{path}##{fingerprint(object)}"
         end
 
+        def from_payload(payload, object = nil)
+          parse(build_string(payload, object)).tap do |uid|
+            # NOTE: fingerprint mismatch can happen when building from a UID payload
+            #       ensure the fingerprint is correct
+            if uid&.valid? && URI::UID.fingerprint(uid.decode) != uid.fingerprint
+              remove_instance_variable :@decoded_fingerprint if instance_variable_defined?(:@decoded_fingerprint)
+              uid.instance_variable_set :@fragment, URI::UID.build(uid.decode).fingerprint
+            end
+          end
+        end
+
         def encode(object, options = {})
           return yield(object, options) if block_given?
           encoder.encode object, options
@@ -99,7 +116,7 @@ unless defined?(::URI::UID) || ::URI.scheme_list.include?("UID")
       end
 
       def fingerprint(decode: false)
-        return decode_fingerprint if decode
+        return @decoded_fingerprint ||= decode_fingerprint if decode
         fragment
       end
 
@@ -114,11 +131,14 @@ unless defined?(::URI::UID) || ::URI.scheme_list.include?("UID")
         !valid?
       end
 
-      def decode
+      def decode(force: false)
         return nil unless valid?
-        return yield(decode_payload, *decode_fingerprint) if block_given?
 
-        decode_payload
+        remove_instance_variable :@decoded if force && instance_variable_defined?(:@decoded)
+        return @decoded if defined?(@decoded)
+
+        @decoded ||= yield(decode_payload, *decode_fingerprint) if block_given?
+        @decoded ||= decode_payload
       end
 
       def deconstruct_keys(_keys)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: universalid
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.7
 platform: ruby
 authors:
 - Nate Hopkins (hopsoft)
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-11 00:00:00.000000000 Z
+date: 2024-02-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -332,6 +332,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.32'
+- !ruby/object:Gem::Dependency
+  name: timecop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: |
   Universal ID opens the flood gates with a deluge of profoundly powerful
   yet easily implemented new use-cases for your apps and scripts.
@@ -351,6 +365,8 @@ files:
 - lib/universalid/extensions/active_record/base_packer.rb
 - lib/universalid/extensions/active_record/base_unpacker.rb
 - lib/universalid/extensions/active_record/relation_message_pack_type.rb
+- lib/universalid/extensions/active_support/cache/entry_message_pack_type.rb
+- lib/universalid/extensions/active_support/cache/store_message_pack_type.rb
 - lib/universalid/extensions/active_support/time_with_zone_message_pack_type.rb
 - lib/universalid/extensions/global_id/global_id_model.rb
 - lib/universalid/extensions/global_id/global_id_uid_extension.rb
@@ -358,17 +374,17 @@ files:
 - lib/universalid/extensions/signed_global_id/message_pack_type.rb
 - lib/universalid/message_pack_factory.rb
 - lib/universalid/message_pack_types.rb
-- lib/universalid/message_pack_types/ruby/composites/module.rb
-- lib/universalid/message_pack_types/ruby/composites/open_struct.rb
-- lib/universalid/message_pack_types/ruby/composites/set.rb
-- lib/universalid/message_pack_types/ruby/composites/struct.rb
-- lib/universalid/message_pack_types/ruby/scalars/bigdecimal.rb
-- lib/universalid/message_pack_types/ruby/scalars/complex.rb
-- lib/universalid/message_pack_types/ruby/scalars/date.rb
-- lib/universalid/message_pack_types/ruby/scalars/date_time.rb
-- lib/universalid/message_pack_types/ruby/scalars/range.rb
-- lib/universalid/message_pack_types/ruby/scalars/rational.rb
-- lib/universalid/message_pack_types/ruby/scalars/regexp.rb
+- lib/universalid/message_pack_types/composites/module.rb
+- lib/universalid/message_pack_types/composites/open_struct.rb
+- lib/universalid/message_pack_types/composites/set.rb
+- lib/universalid/message_pack_types/composites/struct.rb
+- lib/universalid/message_pack_types/scalars/bigdecimal.rb
+- lib/universalid/message_pack_types/scalars/complex.rb
+- lib/universalid/message_pack_types/scalars/date.rb
+- lib/universalid/message_pack_types/scalars/date_time.rb
+- lib/universalid/message_pack_types/scalars/range.rb
+- lib/universalid/message_pack_types/scalars/rational.rb
+- lib/universalid/message_pack_types/scalars/regexp.rb
 - lib/universalid/message_pack_types/uri/uid/type.rb
 - lib/universalid/packer.rb
 - lib/universalid/prepack_database_options.rb
@@ -404,7 +420,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.21
+rubygems_version: 3.2.32
 signing_key:
 specification_version: 4
 summary: Fast, recursive, optimized, URL-Safe serialization for any Ruby object