salesforce_id 1.3.4 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2652a2a26b19cd2a46fb7eaa116e56849d4d5486
-  data.tar.gz: 94cd79bfeeb777a27a1b9630c50f852c32cd7350
+  metadata.gz: e4610637d3c2f52c74f3f6ea50a7fda75c71a796
+  data.tar.gz: 245caa5424c451f1b5c02dd1205c7c2ebe8a8212
 SHA512:
-  metadata.gz: 6a37a08eaa949ce432ac394f3b6ff3a7f0b5a3c8f7dcc495adc5f258e7d4deb601c2ba91c48b1dd8661e50328d8d4b41aabc541b9034ad65b1f7e918bb70eb5c
-  data.tar.gz: dfd9efd4de03f7d241153de0525d479944acb740ac67cbeaffdae364f62d88a82bb5d4a28158090f5968a0b8cba1e3aee750072b773254facccc5a41677b03d6
+  metadata.gz: ff90182696c2038f736d40fe9f7e179cf6b1f91f4bc904b3ba926d9956facfabd8802a8d4e065cf36144bb596ef70c6bbe92e161ad1396bcf9b240327b9d7a61
+  data.tar.gz: bc9687896ece15769ae3f59f4a65b967d974147407c5d40c696c0836e8cac12705acdee935f80f3ef85d6904c9771aa2c85631168ca0c31618197be23d825c92

data/README.md

@@ -90,7 +90,13 @@ id.to_insensitive # => "003G000001SUbc4IAD"
 SalesforceId("003G000001SUbc4") == SalesforceId.id("003G000001SUbc4") # => true
 ```
 
-Notice that `SalesforceId::Safe` can be used with Rails [serialize](http://api.rubyonrails.org/classes/ActiveRecord/Base.html#class-ActiveRecord::Base-label-Saving+arrays-2C+hashes-2C+and+other+non-mappable+objects+in+text+columns)
+### ActiveRecord integration
+
+`SalesforceId::Safe` can be used with Rails [serialize](http://api.rubyonrails.org/classes/ActiveRecord/Base.html#class-ActiveRecord::Base-label-Saving+arrays-2C+hashes-2C+and+other+non-mappable+objects+in+text+columns).
+
+To achieve full integration, `Arel` requires to inject a _visitor_ by directly
+adding a method to `Arel::Visitors::ToSql`, this is currently performed by the
+`arel.rb` file, which checks if arel gem is present and version is `~> 5.0`
 
 ### Test utilities
 

data/lib/salesforce_id/arel.rb

@@ -0,0 +1,13 @@
+require 'rubygems'
+
+if defined?(::Arel) && Gem::Dependency.new('arel', '~> 5.0').match?('arel', ::Arel::VERSION)
+
+  class ::Arel::Visitors::ToSql
+
+    def visit_SalesforceId_Safe(o, collector)
+      quoted(o.to_s, collector)
+    end
+
+  end
+
+end

data/lib/salesforce_id/safe.rb

@@ -1,5 +1,6 @@
 require 'salesforce_id'
 require 'salesforce_id/safe'
+require 'salesforce_id/arel'
 
 module SalesforceId
 

data/lib/salesforce_id/version.rb

@@ -1,3 +1,3 @@
 module SalesforceId
-  VERSION = "1.3.4"
+  VERSION = "1.4.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: salesforce_id
 version: !ruby/object:Gem::Version
-  version: 1.3.4
+  version: 1.4.0
 platform: ruby
 authors:
 - Fire-Dragon-DoL
@@ -151,6 +151,7 @@ files:
 - ext/salesforce_id/validate_id.c
 - ext/salesforce_id/validate_id.h
 - lib/salesforce_id.rb
+- lib/salesforce_id/arel.rb
 - lib/salesforce_id/random.rb
 - lib/salesforce_id/rspec.rb
 - lib/salesforce_id/rspec/be_insensitive_salesforce_id_matcher.rb