tp_record_optimistic 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0dd5d0fcffaddb10783744f3eaf79d415d6858dc
-  data.tar.gz: f2aad750e85c444a214405fe0acb050d9eb3131e
+  metadata.gz: 8e3a91e2f76f9fc5def099fb8a6112397ec969d0
+  data.tar.gz: 65c9294bc994f082bbc58e1e53eed20f39193486
 SHA512:
-  metadata.gz: c78aa6ba5d05359ef3a8bddb85653d959f8e3257961d5d360ad11337a64e3bb21ce25e0da2c9720d7db9d97ab5df7397da697fa7b22c2ac89d23179a7a9efb7c
-  data.tar.gz: 86ffef16fcd8e43e7dc4fc95e267e8bc3d6ce58d469801413a351b54a4a064cb42c789d370cd0957d4bce80d38bfb2c3609fad82099c8fed93c1ce8cade132e6
+  metadata.gz: 023f3eb1706c52918c8e5dd257d216c7f280756cf1002ba4d7d29b3da633f81a5bc6d6aa234e2b3b176f296b624b6d08f345d94c260d3b064d3643a66d048e52
+  data.tar.gz: 8b78f5bc293a870caeb1b9c166e3f528c7358799376e113789d76698c6a74a4536e583e4e7fca14ba82c3d9bf0132f60583c4512e1f118ebb90e7060c324d184

data/README.rdoc

@@ -1,20 +1,33 @@
-= TPOptimistic
+= TP optimistic lock
 
-This gem improve the ActiveRecord to trate ActiveRecord::RecordNotUnique with optimistic behavior
+This gem extends ActiveRecord to handle ActiveRecord::RecordNotUnique with an optimistic behavior.
+If a uniqueness violation is triggered by the database, it will be returned through the `errors` method.
+
+The purpose is to be more performative and assertive than `validates_uniqueness_of`, a Rails pessimistic instruction for handling uniqueness.
+
+`validates_uniqueness_of` performs a select query for each new insert to check unicity.
+`validates_uniqueness_of` doesn't work very well in an environment with high concurrency. The select and insert are atomic operations, so some attempts of insert the same record twice happens witha  high frequency.
+
+
+example:
+```
+  class Foo < ActiveRecord::Base
+    acts_as_unique #
+  end
 
-exemplo:
 
   def sample
     Bar.create(uuid: '5ea880de-e4ce-4770-8d10-c89bac181e40', other: 'bla bla')
     bar = Bar.create(uuid: '5ea880de-e4ce-4770-8d10-c89bac181e40', other: 'bla bla')
     
-    #UNIQUE constraint failed
+    #error returned: UNIQUE constraint failed
     bar.errors
   end
 
 
   def other_sample
     Bar.create!(uuid: '5ea880de-e4ce-4770-8d10-c89bac181e40', other: 'bla bla')
-    #ActiveRecord::RecordInvalid UNIQUE constraint failed
+    
+    #error raised: ActiveRecord::RecordInvalid UNIQUE constraint failed
     Bar.create!(uuid: '5ea880de-e4ce-4770-8d10-c89bac181e40', other: 'bla bla')
   end

data/lib/tp_record_optimistic/version.rb

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 module TPRecordOptimistic
-  VERSION = '0.2.1'
+  VERSION = '0.2.2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tp_record_optimistic
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - Fabricio Oliveira
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-05-18 00:00:00.000000000 Z
+date: 2023-12-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -180,7 +180,7 @@ dependencies:
         version: '2.7'
 description: 
 email:
-- fabricio.oliveira@m4u.com.br
+- fabricioque@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -194,7 +194,7 @@ files:
 - lib/tp_record_optimistic.rb
 - lib/tp_record_optimistic/engine.rb
 - lib/tp_record_optimistic/version.rb
-homepage: https://github.com/fabricio-oliveira/tp_optimistic-uuid
+homepage: https://github.com/fabricio-oliveira/tp_optimistic_lock
 licenses:
 - MIT
 metadata: {}
@@ -217,5 +217,5 @@ rubyforge_project:
 rubygems_version: 2.5.2
 signing_key: 
 specification_version: 4
-summary: gem thas implement optimistic uuid
+summary: gem that implement optimistic lock using unicity restriction from database
 test_files: []