activejob-uniqueness 0.1.4 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e3116a8a0c1f30bef14857117a4a43d125ea904816a0800ff2ed8b59136c1b3a
-  data.tar.gz: fc71b051b317e5edf19bb69e4896f3df92b054e6ae99776d3b9da69a6d3315e3
+  metadata.gz: a407572b8a6542f0303eecdedf53a58af589bef195ca15400880d417e510feb7
+  data.tar.gz: 65bd030916284341db0f3a0bde6c72a223664c05ed1b92a7637a8a7c436851d5
 SHA512:
-  metadata.gz: 4b712824c587e5062b52f21601c1e0f8fd04b89735ef15cc10ac9b701b04356c662cc4c5ced21c36c1c9bf91ae139361e7f27e855960ae6a464cf1cc49022df6
-  data.tar.gz: 16174ffa4a4e9c627c4e3be9172123c02f307e84c9c9409edd2290a9574ef6dfa8ab69fcab2410e1b25df39a3585d33a2b9cbab6068e33cb792854194ea24245
+  metadata.gz: 0e7adcf507b7e9f53ec3ed53a841ea460a24bd3851e6e46697c5bb2776f3a6c3aea0f54fbcd8669e57c36e6d6470a5edbacd9495ca315505690e6583d40ad2b5
+  data.tar.gz: 57074e6a7161fcaf5706598dd1d13fcaf878f70d3345344e1cc5b3d120928079a734608df3f4f5355545cf937864f31bc4b031d04d54ab191aa19601e93fd2ea

data/CHANGELOG.md

@@ -3,7 +3,18 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
-## [Unreleased](https://github.com/veeqo/activejob-uniqueness/compare/v0.1.4...HEAD)
+## [Unreleased](https://github.com/veeqo/activejob-uniqueness/compare/v0.2.0...HEAD)
+
+## [0.2.0](https://github.com/veeqo/activejob-uniqueness/compare/v0.1.4...v0.2.0) - 2021-05-09
+
+### Added
+- [#22](https://github.com/veeqo/activejob-uniqueness/pull/22) Test with ruby 3.0.1
+
+### Changed
+- [#20](https://github.com/veeqo/activejob-uniqueness/pull/20) **Breaking** Sidekiq patch is not applied automatically anymore
+- [#21](https://github.com/veeqo/activejob-uniqueness/pull/21) Migrate from Travis to Github Actions
+- [#24](https://github.com/veeqo/activejob-uniqueness/pull/24) The default value for `retry_count` of redlock is now 0
+- Require ruby 2.5+
 
 ## [0.1.4](https://github.com/veeqo/activejob-uniqueness/compare/v0.1.3...v0.1.4) - 2020-09-22
 

data/README.md

@@ -1,5 +1,5 @@
 # Job uniqueness for ActiveJob
-[![Build Status](https://travis-ci.com/veeqo/activejob-uniqueness.svg?branch=master)](https://travis-ci.com/veeqo/activejob-uniqueness) [![Gem Version](https://badge.fury.io/rb/activejob-uniqueness.svg)](https://badge.fury.io/rb/activejob-uniqueness)
+[![Build Status](https://github.com/veeqo/activejob-uniqueness/actions/workflows/main.yml/badge.svg?branch=main)](https://github.com/veeqo/activejob-uniqueness/actions/workflows/main.yml) [![Gem Version](https://badge.fury.io/rb/activejob-uniqueness.svg)](https://badge.fury.io/rb/activejob-uniqueness)
 
 The gem allows to protect job uniqueness with next strategies:
 
@@ -8,10 +8,16 @@ The gem allows to protect job uniqueness with next strategies:
 | `until_executing` | when **pushed** to the queue | when **processing starts** |
 | `until_executed` | when **pushed** to the queue | when the job is **processed successfully** |
 | `until_expired` | when **pushed** to the queue | when the lock is **expired** |
-| `until_and_while_executing` | when **pushed** to the queue | when **processing starts**<br>a runtime lock is acquired to **prevent simultaneous jobs** |
+| `until_and_while_executing` | when **pushed** to the queue | when **processing starts**<br>a runtime lock is acquired to **prevent simultaneous jobs**<br>*has extra options: `runtime_lock_ttl`, `on_runtime_conflict`* |
 | `while_executing` | when **processing starts** | when the job is **processed**<br>with any result including an error |
 
-Inspired by [SidekiqUniqueJobs](https://github.com/mhenrixon/sidekiq-unique-jobs), uses [Redlock](https://github.com/leandromoreira/redlock-rb) under the hood, sponsored by [Veeqo](https://www.veeqo.com/).
+Inspired by [SidekiqUniqueJobs](https://github.com/mhenrixon/sidekiq-unique-jobs), uses [Redlock](https://github.com/leandromoreira/redlock-rb) under the hood.
+
+<p align="center">
+  <a href="https://www.veeqo.com/" title="Sponsored by Veeqo">
+    <img src="https://static.veeqo.com/assets/sponsored_by_veeqo.png" width="360" />
+  </a>
+</p>
 
 ## Installation
 
@@ -21,6 +27,11 @@ Add the `activejob-uniqueness` gem to your Gemfile.
 gem 'activejob-uniqueness'
 ```
 
+If you want jobs unlocking for Sidekiq Web UI, require the patch explicitly. [**Queues cleanup becomes slower!**](#sidekiq-api-support)
+```ruby
+gem 'activejob-uniqueness', require: 'active_job/uniqueness/sidekiq_patch'
+```
+
 And run `bundle install` command.
 
 ## Configuration
@@ -34,27 +45,83 @@ rails generate active_job:uniqueness:install
 
 ## Usage
 
-Define uniqueness strategy for your job via `unique` class method:
+
+### Make the job to be unique
 
 ```ruby
 class MyJob < ActiveJob::Base
+  # new jobs with the same args will raise error until existing one is executed
   unique :until_executed
 
-  # Custom expiration:
-  # unique :until_executed, lock_ttl: 3.hours
+  def perform(args)
+    # work
+  end
+end
+```
+
+### Tune uniqueness settings per job
+
+```ruby
+class MyJob < ActiveJob::Base
+  # new jobs with the same args will be logged within 3 hours or until existing one is being executing
+  unique :until_executing, lock_ttl: 3.hours, on_conflict: :log
+
+  def perform(args)
+    # work
+  end
+end
+```
+
+You can set defaults globally with [the configuration](#configuration)
 
-  # Do not raise error on non unique jobs enqueuing:
-  # unique :until_executed, on_conflict: :log
+### Control lock conflicts
 
-  # Handle conflict by custom Proc:
-  # unique :until_executed, on_conflict: ->(job) { job.logger.info 'Oops' }
+```ruby
+class MyJob < ActiveJob::Base
+  # Proc gets the job instance including its arguments
+  unique :until_executing, on_conflict: ->(job) { job.logger.info "Oops: #{job.arguments}" }
 
-  # The :until_and_while_executing strategy supports extra attributes for a runtime lock:
-  # unique :until_and_while_executing runtime_lock_ttl: 10.minutes, on_runtime_conflict: :log
+  def perform(args)
+    # work
+  end
 end
 ```
 
-ActiveJob::Uniqueness allows to manually unlock jobs:
+### Control lock key arguments
+
+```ruby
+class MyJob < ActiveJob::Base
+  unique :until_executed
+
+  def perform(foo, bar, baz)
+    # work
+  end
+
+  def lock_key_arguments
+    arguments.first(2) # baz is ignored
+  end
+end
+```
+
+### Control the lock key
+
+```ruby
+class MyJob < ActiveJob::Base
+  unique :until_executed
+
+  def perform(foo, bar, baz)
+    # work
+  end
+
+  def lock_key
+    'qux' # completely custom lock key
+  end
+end
+```
+
+### Unlock jobs manually
+
+The selected strategy automatically unlocks jobs, but in some cases (e.g. the queue is purged) it is handy to unlock jobs manually.
 
 ```ruby
 # Remove the lock for particular arguments:
@@ -91,7 +158,7 @@ ActiveJob::Uniqueness instruments `ActiveSupport::Notifications` with next event
 
 And then writes to `ActiveJob::Base.logger`.
 
-### ActiveJob prior to version `6.1` will always log `Enqueued MyJob (Job ID) ...` even if the callback chain was halted. [Details](https://github.com/rails/rails/pull/37830)
+**ActiveJob prior to version `6.1` will always log `Enqueued MyJob (Job ID) ...` even if the callback chain is halted. [Details](https://github.com/rails/rails/pull/37830)**
 
 ## Testing
 
@@ -107,15 +174,14 @@ bundle
 rake
 ```
 
-Use [wwtd](https://github.com/grosser/wwtd) to run test matrix:
-```sh
-gem install wwtd
-wwtd
-```
+## Sidekiq API support
 
-## Sidekiq adapter support
+ActiveJob::Uniqueness supports Sidekiq API to unset job locks on queues cleanup (e.g. via Sidekiq Web UI). Starting Sidekiq 5.1 job death also triggers locks cleanup.
+Take into account that **[big queues clanup becomes much slower](https://github.com/veeqo/activejob-uniqueness/issues/16)** because each job is being unlocked individually. In order to activate Sidekiq API patch require it explicitly in your Gemfile:
 
-ActiveJob::Uniqueness patches Sidekiq API to unset locks on jobs cleanup. Starting Sidekiq 5.1 job death also triggers locks cleanup.
+```ruby
+gem 'activejob-uniqueness', require: 'active_job/uniqueness/sidekiq_patch'
+```
 
 ## Contributing
 
@@ -124,3 +190,9 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/veeqo/
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## About [Veeqo](https://www.veeqo.com)
+
+At Veeqo, our team of Engineers is on a mission to create a world-class Inventory and Shipping platform, built to the highest standards in best coding practices. We are a growing team, looking for other passionate developers to [join us](https://veeqo-ltd.breezy.hr/) on our journey. If you're looking for a career working for one of the most exciting tech companies in ecommerce, we want to hear from you.
+
+[Veeqo developers blog](https://devs.veeqo.com)

data/lib/active_job/uniqueness.rb

@@ -1,22 +1,13 @@
 # frozen_string_literal: true
 
-require 'active_support'
-require 'active_support/core_ext'
+require 'active_job'
 require 'redlock'
-require 'openssl'
+
 require 'active_job/uniqueness/version'
 require 'active_job/uniqueness/errors'
 require 'active_job/uniqueness/log_subscriber'
 require 'active_job/uniqueness/active_job_patch'
 
-begin
-  require 'sidekiq/api'
-rescue LoadError
-  # ¯\_(ツ)_/¯
-else
-  require 'active_job/uniqueness/sidekiq_patch'
-end
-
 module ActiveJob
   module Uniqueness
     extend ActiveSupport::Autoload

data/lib/active_job/uniqueness/configuration.rb

@@ -11,14 +11,18 @@ module ActiveJob
     class Configuration
       include ActiveSupport::Configurable
 
-      config_accessor(:lock_ttl) { 1.day }
+      config_accessor(:lock_ttl) { 86_400 } # 1.day
       config_accessor(:lock_prefix) { 'activejob_uniqueness' }
       config_accessor(:on_conflict) { :raise }
-      config_accessor(:digest_method) { OpenSSL::Digest::MD5 }
       config_accessor(:redlock_servers) { [ENV.fetch('REDIS_URL', 'redis://localhost:6379')] }
-      config_accessor(:redlock_options) { {} }
+      config_accessor(:redlock_options) { { retry_count: 0 } }
       config_accessor(:lock_strategies) { {} }
 
+      config_accessor(:digest_method) do
+        require 'openssl'
+        OpenSSL::Digest::MD5
+      end
+
       def on_conflict=(action)
         validate_on_conflict_action!(action)
 

data/lib/active_job/uniqueness/sidekiq_patch.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require 'activejob/uniqueness'
+require 'sidekiq/api'
+
 module ActiveJob
   module Uniqueness
     def self.unlock_sidekiq_job!(job_data)

data/lib/active_job/uniqueness/version.rb

@@ -2,6 +2,6 @@
 
 module ActiveJob
   module Uniqueness
-    VERSION = '0.1.4'
+    VERSION = '0.2.0'
   end
 end

data/lib/generators/active_job/uniqueness/templates/config/initializers/active_job_uniqueness.rb

@@ -31,7 +31,7 @@ ActiveJob::Uniqueness.configure do |config|
   # Custom options for Redlock.
   # Read more at https://github.com/leandromoreira/redlock-rb#redlock-configuration
   #
-  # config.redlock_options = {}
+  # config.redlock_options = { retry_count: 0 }
 
   # Custom strategies.
   # config.lock_strategies = { my_strategy: MyStrategy }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: activejob-uniqueness
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.2.0
 platform: ruby
 authors:
 - Rustam Sharshenov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-09-21 00:00:00.000000000 Z
+date: 2021-05-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activejob
@@ -142,7 +142,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/veeqo/activejob-uniqueness
   source_code_uri: https://github.com/veeqo/activejob-uniqueness
-  changelog_uri: https://github.com/veeqo/activejob-uniqueness/blob/master/CHANGELOG.md
+  changelog_uri: https://github.com/veeqo/activejob-uniqueness/blob/main/CHANGELOG.md
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -151,14 +151,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.2.15
 signing_key: 
 specification_version: 4
 summary: Ensure uniqueness of your ActiveJob jobs