paquito 0.11.3 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5ede4c0254b56d0c34d1d664903ffcd51db1ce717723a82858973c76d41231bb
-  data.tar.gz: 97d7ac64e05043df851dd6ef49cec163991c91afc6b25e98e1b4649a5a808eb8
+  metadata.gz: 39298f47e19e7301c919b1a36c7a6a54b22da82752f6490dd50cfaf178979c61
+  data.tar.gz: f2bb86111a2f54fd5bface1f43fb54ec15c25b2c03ade4a667823188b1464341
 SHA512:
-  metadata.gz: 650bc85b15bbf5c2516941222d3de02e6c7b622a0998e9ccd2db2adf439964d5edc877227b750fad06903c0d00f58a61004e3e6271b37bf6d67f8a1aeb45dcfc
-  data.tar.gz: b2b03a2c958c622e68b8f1cf3745d89b4cefc9ac4070875d85174ed3c5943c27a31df049f44b677d9fd6c33e958c8ddc9b834f4d8870ed8a547fe7b30b1df8ba
+  metadata.gz: 5391e5db6c0c4094a060d2dd61b561830cfc7696e3f926d5b209acc95df97101428cdcf2159b2ffe3c5c9ea1943fbdf43c0ef15f84f2b19edcb0fc12501a127a
+  data.tar.gz: 4004e18dc637b1febc9b4607562dca2d0317b6867f3cb9826c1354151bb1f012377fec5c0a2cde9a170c1fa6c9c3f9cfe948bbb9b740dd9912726d8a607278db

data/.github/workflows/release.yml

@@ -0,0 +1,29 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - v[0-9]+.[0-9]+.[0-9]+
+
+jobs:
+  release:
+    if: github.repository == 'Shopify/paquito'
+
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+      id-token: write
+
+    environment: release
+
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+
+      - uses: rubygems/release-gem@v1

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+# 1.0.0
+
+Both changes in this release require applications to be fully updated to the latest patch version of the gem before
+bumping to this version.
+
+* Store md5 digest of columns + sql types along with records (#51)
+  *IMPORTANT*: if you are storing Active Record objects in the cache, ensure you have updated and deployed 0.11.3 before
+  upgrading, and ensure you are handling either all `ActiveRecordCoder::Error` errors, or that you explicitly add
+  `ActiveRecordCoder::ColumnsDigestMismatch` to your error handling.
+* Bump `Paquito.format_version` to `1` by default.
+  *IMPORTANT*: if you are upgrading from a previous version, you MUST first fully deploy the gem up to at least version 0.10.0
+  and release before enabling it. If you don't, you may notice some `UnpackError` during the code rollout, which may be fine
+  if you only use Paquito for ephemeral cache data. See release notes for v0.10.0.
+
 # 0.11.3
 
 * Deserialize records with extra unused array elements in payload (#52)

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    paquito (0.11.3)
+    paquito (1.0.1)
       msgpack (>= 1.5.2)
 
 GEM
@@ -34,7 +34,7 @@ GEM
     drb (2.2.1)
     i18n (1.14.5)
       concurrent-ruby (~> 1.0)
-    json (2.7.1)
+    json (2.11.3)
     language_server-protocol (3.17.0.3)
     logger (1.6.0)
     mini_portile2 (2.8.8)
@@ -46,7 +46,7 @@ GEM
       racc
     racc (1.7.3)
     rainbow (3.1.1)
-    rake (13.0.6)
+    rake (13.2.1)
     regexp_parser (2.9.0)
     rexml (3.3.9)
     rubocop (1.62.1)

data/lib/paquito/active_record_coder.rb

@@ -88,9 +88,12 @@ module Paquito
       end
 
       def serialize_record(record)
-        arguments = [record.class.name, attributes_for_database(record)]
-        arguments << true if record.new_record?
-        arguments
+        [
+          record.class.name,
+          attributes_for_database(record),
+          record.new_record?,
+          columns_digest(record.class),
+        ]
       end
 
       def attributes_for_database(record)
@@ -99,18 +102,32 @@ module Paquito
         attributes
       end
 
-      def deserialize_record(class_name, attributes_from_database, new_record = false, *)
+      def deserialize_record(class_name, attributes_from_database, new_record = false, hash = nil, *)
         begin
           klass = Object.const_get(class_name)
         rescue NameError
           raise ClassMissingError, "undefined class: #{class_name}"
         end
 
+        if hash && (hash != (expected_digest = columns_digest(klass)))
+          raise ColumnsDigestMismatch,
+            "\"#{hash}\" does not match the expected digest of \"#{expected_digest}\""
+        end
+
         # Ideally we'd like to call `klass.instantiate`, however it doesn't allow to pass
         # wether the record was persisted or not.
         attributes = klass.attributes_builder.build_from_database(attributes_from_database, EMPTY_HASH)
         klass.allocate.init_with_attributes(attributes, new_record)
       end
+
+      def columns_digest(klass)
+        str = +""
+        klass.columns_hash.each do |name, column|
+          str << "," unless str.empty?
+          str << name << ":" << column.sql_type
+        end
+        ::Digest::MD5.digest(str).unpack1("s")
+      end
     end
 
     class Error < ::Paquito::Error
@@ -122,6 +139,9 @@ module Paquito
     class AssociationMissingError < Error
     end
 
+    class ColumnsDigestMismatch < Error
+    end
+
     class InstanceTracker
       def initialize
         @instances = []

data/lib/paquito/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Paquito
-  VERSION = "0.11.3"
+  VERSION = "1.0.1"
 end

data/lib/paquito.rb

@@ -29,7 +29,7 @@ module Paquito
   autoload :FlatCacheEntryCoder, "paquito/flat_cache_entry_coder"
   autoload :ActiveRecordCoder, "paquito/active_record_coder"
 
-  DEFAULT_FORMAT_VERSION = 0
+  DEFAULT_FORMAT_VERSION = 1
   @format_version = DEFAULT_FORMAT_VERSION
 
   class << self

data/paquito.gemspec

@@ -19,6 +19,14 @@ Gem::Specification.new do |spec|
   spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = "https://github.com/Shopify/paquito"
 
+  spec.post_install_message = <<~POST_INSTALL_MSG
+    Warning: Paquito 1.0 includes potentially breaking changes to ActiveRecordCoder.
+    Before upgrading to 1.0 from an earlier version, ensure you have first upgraded
+    to 0.11.3 and deployed your application before upgrading to 1.0. Also ensure you
+    rescue either all `ActiveRecordCoder::Error` errors, or that you explicitly
+    rescue the new `ActiveRecord::ColumnsDigestError`.
+  POST_INSTALL_MSG
+
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
   spec.files = Dir.chdir(File.expand_path(__dir__)) do

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: paquito
 version: !ruby/object:Gem::Version
-  version: 0.11.3
+  version: 1.0.1
 platform: ruby
 authors:
 - Jean Boussier
 bindir: exe
 cert_chain: []
-date: 2025-02-06 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: msgpack
@@ -34,6 +34,7 @@ files:
 - ".devcontainer/devcontainer.json"
 - ".github/workflows/ci.yml"
 - ".github/workflows/cla.yml"
+- ".github/workflows/release.yml"
 - ".gitignore"
 - ".rubocop.yml"
 - ".ruby-version"
@@ -82,6 +83,12 @@ metadata:
   allowed_push_host: https://rubygems.org
   homepage_uri: https://github.com/Shopify/paquito
   source_code_uri: https://github.com/Shopify/paquito
+post_install_message: |
+  Warning: Paquito 1.0 includes potentially breaking changes to ActiveRecordCoder.
+  Before upgrading to 1.0 from an earlier version, ensure you have first upgraded
+  to 0.11.3 and deployed your application before upgrading to 1.0. Also ensure you
+  rescue either all `ActiveRecordCoder::Error` errors, or that you explicitly
+  rescue the new `ActiveRecord::ColumnsDigestError`.
 rdoc_options: []
 require_paths:
 - lib
@@ -96,7 +103,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.3
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Framework for defining efficient and extendable serializers
 test_files: []