sidekiq-unique-jobs 6.0.7 → 7.1.33

Sign up to get free protection for your applications and to get access to all the features.
Files changed (194) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +1880 -156
  3. data/README.md +818 -238
  4. data/bin/uniquejobs +2 -2
  5. data/lib/sidekiq-unique-jobs.rb +1 -1
  6. data/lib/sidekiq_unique_jobs/batch_delete.rb +124 -0
  7. data/lib/sidekiq_unique_jobs/changelog.rb +78 -0
  8. data/lib/sidekiq_unique_jobs/cli.rb +68 -25
  9. data/lib/sidekiq_unique_jobs/config.rb +319 -0
  10. data/lib/sidekiq_unique_jobs/connection.rb +6 -5
  11. data/lib/sidekiq_unique_jobs/constants.rb +50 -20
  12. data/lib/sidekiq_unique_jobs/core_ext.rb +80 -0
  13. data/lib/sidekiq_unique_jobs/deprecation.rb +65 -0
  14. data/lib/sidekiq_unique_jobs/digests.rb +70 -87
  15. data/lib/sidekiq_unique_jobs/exceptions.rb +88 -12
  16. data/lib/sidekiq_unique_jobs/expiring_digests.rb +14 -0
  17. data/lib/sidekiq_unique_jobs/job.rb +47 -13
  18. data/lib/sidekiq_unique_jobs/json.rb +47 -0
  19. data/lib/sidekiq_unique_jobs/key.rb +98 -0
  20. data/lib/sidekiq_unique_jobs/lock/base_lock.rb +111 -82
  21. data/lib/sidekiq_unique_jobs/lock/client_validator.rb +28 -0
  22. data/lib/sidekiq_unique_jobs/lock/server_validator.rb +27 -0
  23. data/lib/sidekiq_unique_jobs/lock/until_and_while_executing.rb +45 -5
  24. data/lib/sidekiq_unique_jobs/lock/until_executed.rb +30 -4
  25. data/lib/sidekiq_unique_jobs/lock/until_executing.rb +26 -2
  26. data/lib/sidekiq_unique_jobs/lock/until_expired.rb +27 -15
  27. data/lib/sidekiq_unique_jobs/lock/validator.rb +96 -0
  28. data/lib/sidekiq_unique_jobs/lock/while_executing.rb +26 -7
  29. data/lib/sidekiq_unique_jobs/lock/while_executing_reject.rb +3 -11
  30. data/lib/sidekiq_unique_jobs/lock.rb +342 -0
  31. data/lib/sidekiq_unique_jobs/lock_args.rb +127 -0
  32. data/lib/sidekiq_unique_jobs/lock_config.rb +126 -0
  33. data/lib/sidekiq_unique_jobs/lock_digest.rb +79 -0
  34. data/lib/sidekiq_unique_jobs/lock_info.rb +68 -0
  35. data/lib/sidekiq_unique_jobs/lock_timeout.rb +62 -0
  36. data/lib/sidekiq_unique_jobs/lock_ttl.rb +77 -0
  37. data/lib/sidekiq_unique_jobs/lock_type.rb +37 -0
  38. data/lib/sidekiq_unique_jobs/locksmith.rb +324 -95
  39. data/lib/sidekiq_unique_jobs/logging/middleware_context.rb +44 -0
  40. data/lib/sidekiq_unique_jobs/logging.rb +208 -30
  41. data/lib/sidekiq_unique_jobs/lua/delete.lua +51 -0
  42. data/lib/sidekiq_unique_jobs/lua/delete_by_digest.lua +42 -0
  43. data/lib/sidekiq_unique_jobs/lua/delete_job_by_digest.lua +38 -0
  44. data/lib/sidekiq_unique_jobs/lua/find_digest_in_queues.lua +26 -0
  45. data/lib/sidekiq_unique_jobs/lua/lock.lua +99 -0
  46. data/lib/sidekiq_unique_jobs/lua/lock_until_expired.lua +92 -0
  47. data/lib/sidekiq_unique_jobs/lua/locked.lua +35 -0
  48. data/lib/sidekiq_unique_jobs/lua/queue.lua +87 -0
  49. data/lib/sidekiq_unique_jobs/lua/reap_orphans.lua +122 -0
  50. data/lib/sidekiq_unique_jobs/lua/shared/_common.lua +40 -0
  51. data/lib/sidekiq_unique_jobs/lua/shared/_current_time.lua +8 -0
  52. data/lib/sidekiq_unique_jobs/lua/shared/_delete_from_queue.lua +22 -0
  53. data/lib/sidekiq_unique_jobs/lua/shared/_delete_from_sorted_set.lua +18 -0
  54. data/lib/sidekiq_unique_jobs/lua/shared/_find_digest_in_process_set.lua +53 -0
  55. data/lib/sidekiq_unique_jobs/lua/shared/_find_digest_in_queues.lua +43 -0
  56. data/lib/sidekiq_unique_jobs/lua/shared/_find_digest_in_sorted_set.lua +24 -0
  57. data/lib/sidekiq_unique_jobs/lua/shared/_hgetall.lua +13 -0
  58. data/lib/sidekiq_unique_jobs/lua/shared/_upgrades.lua +3 -0
  59. data/lib/sidekiq_unique_jobs/lua/unlock.lua +107 -0
  60. data/lib/sidekiq_unique_jobs/lua/update_version.lua +40 -0
  61. data/lib/sidekiq_unique_jobs/lua/upgrade.lua +68 -0
  62. data/lib/sidekiq_unique_jobs/middleware/client.rb +42 -0
  63. data/lib/sidekiq_unique_jobs/middleware/server.rb +31 -0
  64. data/lib/sidekiq_unique_jobs/middleware.rb +33 -30
  65. data/lib/sidekiq_unique_jobs/normalizer.rb +4 -4
  66. data/lib/sidekiq_unique_jobs/on_conflict/log.rb +9 -5
  67. data/lib/sidekiq_unique_jobs/on_conflict/null_strategy.rb +1 -1
  68. data/lib/sidekiq_unique_jobs/on_conflict/raise.rb +2 -2
  69. data/lib/sidekiq_unique_jobs/on_conflict/reject.rb +63 -17
  70. data/lib/sidekiq_unique_jobs/on_conflict/replace.rb +54 -14
  71. data/lib/sidekiq_unique_jobs/on_conflict/reschedule.rb +16 -5
  72. data/lib/sidekiq_unique_jobs/on_conflict/strategy.rb +26 -7
  73. data/lib/sidekiq_unique_jobs/on_conflict.rb +34 -16
  74. data/lib/sidekiq_unique_jobs/options_with_fallback.rb +39 -36
  75. data/lib/sidekiq_unique_jobs/orphans/lua_reaper.rb +29 -0
  76. data/lib/sidekiq_unique_jobs/orphans/manager.rb +241 -0
  77. data/lib/sidekiq_unique_jobs/orphans/null_reaper.rb +24 -0
  78. data/lib/sidekiq_unique_jobs/orphans/observer.rb +42 -0
  79. data/lib/sidekiq_unique_jobs/orphans/reaper.rb +114 -0
  80. data/lib/sidekiq_unique_jobs/orphans/reaper_resurrector.rb +170 -0
  81. data/lib/sidekiq_unique_jobs/orphans/ruby_reaper.rb +298 -0
  82. data/lib/sidekiq_unique_jobs/redis/entity.rb +112 -0
  83. data/lib/sidekiq_unique_jobs/redis/hash.rb +56 -0
  84. data/lib/sidekiq_unique_jobs/redis/list.rb +32 -0
  85. data/lib/sidekiq_unique_jobs/redis/set.rb +32 -0
  86. data/lib/sidekiq_unique_jobs/redis/sorted_set.rb +86 -0
  87. data/lib/sidekiq_unique_jobs/redis/string.rb +51 -0
  88. data/lib/sidekiq_unique_jobs/redis.rb +11 -0
  89. data/lib/sidekiq_unique_jobs/reflectable.rb +26 -0
  90. data/lib/sidekiq_unique_jobs/reflections.rb +79 -0
  91. data/lib/sidekiq_unique_jobs/rspec/matchers/have_valid_sidekiq_options.rb +51 -0
  92. data/lib/sidekiq_unique_jobs/rspec/matchers.rb +26 -0
  93. data/lib/sidekiq_unique_jobs/script/caller.rb +127 -0
  94. data/lib/sidekiq_unique_jobs/script.rb +15 -0
  95. data/lib/sidekiq_unique_jobs/server.rb +61 -0
  96. data/lib/sidekiq_unique_jobs/sidekiq_unique_ext.rb +115 -66
  97. data/lib/sidekiq_unique_jobs/sidekiq_unique_jobs.rb +304 -0
  98. data/lib/sidekiq_unique_jobs/sidekiq_worker_methods.rb +51 -29
  99. data/lib/sidekiq_unique_jobs/testing.rb +104 -31
  100. data/lib/sidekiq_unique_jobs/timer_task.rb +299 -0
  101. data/lib/sidekiq_unique_jobs/timing.rb +58 -0
  102. data/lib/sidekiq_unique_jobs/unlockable.rb +20 -4
  103. data/lib/sidekiq_unique_jobs/update_version.rb +25 -0
  104. data/lib/sidekiq_unique_jobs/upgrade_locks.rb +155 -0
  105. data/lib/sidekiq_unique_jobs/version.rb +3 -1
  106. data/lib/sidekiq_unique_jobs/version_check.rb +114 -0
  107. data/lib/sidekiq_unique_jobs/web/helpers.rb +140 -15
  108. data/lib/sidekiq_unique_jobs/web/views/_paging.erb +4 -4
  109. data/lib/sidekiq_unique_jobs/web/views/changelogs.erb +54 -0
  110. data/lib/sidekiq_unique_jobs/web/views/lock.erb +110 -0
  111. data/lib/sidekiq_unique_jobs/web/views/locks.erb +54 -0
  112. data/lib/sidekiq_unique_jobs/web.rb +86 -29
  113. data/lib/sidekiq_unique_jobs.rb +78 -105
  114. data/lib/tasks/changelog.rake +23 -0
  115. metadata +154 -218
  116. data/.codeclimate.yml +0 -35
  117. data/.csslintrc +0 -2
  118. data/.dockerignore +0 -4
  119. data/.editorconfig +0 -14
  120. data/.eslintignore +0 -1
  121. data/.eslintrc +0 -213
  122. data/.fasterer.yml +0 -23
  123. data/.github/ISSUE_TEMPLATE/bug_report.md +0 -31
  124. data/.github/ISSUE_TEMPLATE/feature_request.md +0 -17
  125. data/.gitignore +0 -28
  126. data/.reek.yml +0 -87
  127. data/.rspec +0 -2
  128. data/.rubocop.yml +0 -127
  129. data/.simplecov +0 -20
  130. data/.travis.yml +0 -47
  131. data/.yardopts +0 -7
  132. data/Appraisals +0 -29
  133. data/CODE_OF_CONDUCT.md +0 -74
  134. data/Gemfile +0 -24
  135. data/Guardfile +0 -55
  136. data/Rakefile +0 -12
  137. data/_config.yml +0 -1
  138. data/assets/unique_digests_1.png +0 -0
  139. data/assets/unique_digests_2.png +0 -0
  140. data/bin/bench +0 -20
  141. data/examples/another_unique_job.rb +0 -15
  142. data/examples/custom_queue_job.rb +0 -12
  143. data/examples/custom_queue_job_with_filter_method.rb +0 -13
  144. data/examples/custom_queue_job_with_filter_proc.rb +0 -16
  145. data/examples/expiring_job.rb +0 -12
  146. data/examples/inline_worker.rb +0 -12
  147. data/examples/just_a_worker.rb +0 -13
  148. data/examples/long_running_job.rb +0 -14
  149. data/examples/main_job.rb +0 -14
  150. data/examples/my_job.rb +0 -12
  151. data/examples/my_unique_job.rb +0 -15
  152. data/examples/my_unique_job_with_filter_method.rb +0 -21
  153. data/examples/my_unique_job_with_filter_proc.rb +0 -19
  154. data/examples/notify_worker.rb +0 -14
  155. data/examples/plain_class.rb +0 -13
  156. data/examples/simple_worker.rb +0 -15
  157. data/examples/spawn_simple_worker.rb +0 -12
  158. data/examples/test_class.rb +0 -9
  159. data/examples/unique_across_workers_job.rb +0 -20
  160. data/examples/unique_job_on_conflict_raise.rb +0 -14
  161. data/examples/unique_job_on_conflict_reject.rb +0 -14
  162. data/examples/unique_job_on_conflict_reschedule.rb +0 -14
  163. data/examples/unique_job_with_conditional_parameter.rb +0 -18
  164. data/examples/unique_job_with_filter_method.rb +0 -21
  165. data/examples/unique_job_with_nil_unique_args.rb +0 -20
  166. data/examples/unique_job_with_no_unique_args_method.rb +0 -16
  167. data/examples/unique_job_withthout_unique_args_parameter.rb +0 -18
  168. data/examples/unique_on_all_queues_job.rb +0 -16
  169. data/examples/until_and_while_executing_job.rb +0 -17
  170. data/examples/until_executed_2_job.rb +0 -24
  171. data/examples/until_executed_job.rb +0 -25
  172. data/examples/until_executing_job.rb +0 -11
  173. data/examples/until_expired_job.rb +0 -12
  174. data/examples/until_global_expired_job.rb +0 -12
  175. data/examples/while_executing_job.rb +0 -15
  176. data/examples/while_executing_reject_job.rb +0 -14
  177. data/examples/without_argument_job.rb +0 -13
  178. data/lib/sidekiq_unique_jobs/client/middleware.rb +0 -56
  179. data/lib/sidekiq_unique_jobs/scripts.rb +0 -89
  180. data/lib/sidekiq_unique_jobs/server/middleware.rb +0 -40
  181. data/lib/sidekiq_unique_jobs/timeout/calculator.rb +0 -63
  182. data/lib/sidekiq_unique_jobs/timeout.rb +0 -8
  183. data/lib/sidekiq_unique_jobs/unique_args.rb +0 -149
  184. data/lib/sidekiq_unique_jobs/util.rb +0 -103
  185. data/lib/sidekiq_unique_jobs/web/views/unique_digest.erb +0 -28
  186. data/lib/sidekiq_unique_jobs/web/views/unique_digests.erb +0 -42
  187. data/redis/acquire_lock.lua +0 -21
  188. data/redis/delete.lua +0 -14
  189. data/redis/delete_by_digest.lua +0 -24
  190. data/redis/delete_job_by_digest.lua +0 -60
  191. data/redis/lock.lua +0 -58
  192. data/redis/release_stale_locks.lua +0 -90
  193. data/redis/unlock.lua +0 -32
  194. data/sidekiq-unique-jobs.gemspec +0 -42
@@ -1,24 +1,54 @@
1
1
  # frozen_string_literal: true
2
2
 
3
+ #
4
+ # Module with constants to avoid string duplication
5
+ #
6
+ # @author Mikael Henriksson <mikael@mhenrixon.com>
7
+ #
3
8
  module SidekiqUniqueJobs
4
- ARGS_KEY ||= 'args'
5
- AT_KEY ||= 'at'
6
- CLASS_KEY ||= 'class'
7
- JID_KEY ||= 'jid'
8
- LOCK_EXPIRATION_KEY ||= 'lock_expiration'
9
- LOCK_TIMEOUT_KEY ||= 'lock_timeout'
10
- LOG_DUPLICATE_KEY ||= 'log_duplicate_payload'
11
- QUEUE_KEY ||= 'queue'
12
- UNIQUE_ACROSS_QUEUES_KEY ||= 'unique_across_queues'
13
- UNIQUE_ACROSS_WORKERS_KEY ||= 'unique_across_workers'
14
- UNIQUE_ARGS_KEY ||= 'unique_args'
15
- UNIQUE_DIGEST_KEY ||= 'unique_digest'
16
- UNIQUE_KEY ||= 'unique'
17
- UNIQUE_SET ||= 'unique:keys'
18
- LOCK_KEY ||= 'lock'
19
- ON_CONFLICT_KEY ||= 'on_conflict'
20
- UNIQUE_ON_ALL_QUEUES_KEY ||= 'unique_on_all_queues' # TODO: Remove in v6.1
21
- UNIQUE_PREFIX_KEY ||= 'unique_prefix'
22
- RETRY_SET ||= 'retry'
23
- SCHEDULE_SET ||= 'schedule'
9
+ ARGS = "args"
10
+ APARTMENT = "apartment"
11
+ AT = "at"
12
+ CHANGELOGS = "uniquejobs:changelog"
13
+ CLASS = "class"
14
+ CREATED_AT = "created_at"
15
+ DEAD_VERSION = "uniquejobs:dead"
16
+ DIGESTS = "uniquejobs:digests"
17
+ EXPIRING_DIGESTS = "uniquejobs:expiring_digests"
18
+ ERRORS = "errors"
19
+ JID = "jid"
20
+ LIMIT = "limit"
21
+ LIVE_VERSION = "uniquejobs:live"
22
+ LOCK = "lock"
23
+ LOCK_ARGS = "lock_args"
24
+ LOCK_ARGS_METHOD = "lock_args_method"
25
+ LOCK_DIGEST = "lock_digest"
26
+ LOCK_EXPIRATION = "lock_expiration"
27
+ LOCK_INFO = "lock_info"
28
+ LOCK_LIMIT = "lock_limit"
29
+ LOCK_PREFIX = "lock_prefix"
30
+ LOCK_TIMEOUT = "lock_timeout"
31
+ LOCK_TTL = "lock_ttl"
32
+ LOCK_TYPE = "lock_type"
33
+ ON_CLIENT_CONFLICT = "on_client_conflict"
34
+ ON_CONFLICT = "on_conflict"
35
+ ON_SERVER_CONFLICT = "on_server_conflict"
36
+ PAYLOAD = "payload"
37
+ PROCESSES = "processes"
38
+ QUEUE = "queue"
39
+ RETRY = "retry"
40
+ SCHEDULE = "schedule"
41
+ TIME = "time"
42
+ TIMEOUT = "timeout"
43
+ TTL = "ttl"
44
+ TYPE = "type"
45
+ UNIQUE = "unique"
46
+ UNIQUE_ACROSS_QUEUES = "unique_across_queues"
47
+ UNIQUE_ACROSS_WORKERS = "unique_across_workers"
48
+ UNIQUE_ARGS = "unique_args"
49
+ UNIQUE_ARGS_METHOD = "unique_args_method"
50
+ UNIQUE_DIGEST = "unique_digest"
51
+ UNIQUE_PREFIX = "unique_prefix"
52
+ UNIQUE_REAPER = "uniquejobs:reaper"
53
+ WORKER = "worker"
24
54
  end
@@ -2,21 +2,67 @@
2
2
 
3
3
  # :nocov:
4
4
 
5
+ #
6
+ # Monkey patches for the ruby Hash
7
+ #
5
8
  class Hash
6
9
  unless {}.respond_to?(:slice)
10
+ #
11
+ # Returns only the matching keys in a new hash
12
+ #
13
+ # @param [Array<String>, Array<Symbol>] keys the keys to match
14
+ #
15
+ # @return [Hash]
16
+ #
7
17
  def slice(*keys)
8
18
  keys.map! { |key| convert_key(key) } if respond_to?(:convert_key, true)
9
19
  keys.each_with_object(self.class.new) { |k, hash| hash[k] = self[k] if key?(k) }
10
20
  end
11
21
  end
12
22
 
23
+ unless {}.respond_to?(:deep_stringify_keys)
24
+ #
25
+ # Depp converts all keys to string
26
+ #
27
+ #
28
+ # @return [Hash<String>]
29
+ #
30
+ def deep_stringify_keys
31
+ deep_transform_keys(&:to_s)
32
+ end
33
+ end
34
+
35
+ unless {}.respond_to?(:deep_transform_keys)
36
+ #
37
+ # Deep transfor all keys by yielding to the caller
38
+ #
39
+ #
40
+ # @return [Hash<String>]
41
+ #
42
+ def deep_transform_keys(&block)
43
+ _deep_transform_keys_in_object(self, &block)
44
+ end
45
+ end
46
+
13
47
  unless {}.respond_to?(:stringify_keys)
48
+ #
49
+ # Converts all keys to string
50
+ #
51
+ #
52
+ # @return [Hash<String>]
53
+ #
14
54
  def stringify_keys
15
55
  transform_keys(&:to_s)
16
56
  end
17
57
  end
18
58
 
19
59
  unless {}.respond_to?(:transform_keys)
60
+ #
61
+ # Transforms all keys by yielding to the caller
62
+ #
63
+ #
64
+ # @return [Hash]
65
+ #
20
66
  def transform_keys
21
67
  result = {}
22
68
  each_key do |key|
@@ -27,6 +73,13 @@ class Hash
27
73
  end
28
74
 
29
75
  unless {}.respond_to?(:slice!)
76
+ #
77
+ # Removes all keys not provided from the current hash and returns it
78
+ #
79
+ # @param [Array<String>, Array<Symbol>] keys the keys to match
80
+ #
81
+ # @return [Hash]
82
+ #
30
83
  def slice!(*keys)
31
84
  keys.map! { |key| convert_key(key) } if respond_to?(:convert_key, true)
32
85
  omit = slice(*self.keys - keys)
@@ -37,10 +90,37 @@ class Hash
37
90
  omit
38
91
  end
39
92
  end
93
+
94
+ private
95
+
96
+ unless {}.respond_to?(:_deep_transform_keys_in_object)
97
+ # support methods for deep transforming nested hashes and arrays
98
+ def _deep_transform_keys_in_object(object, &block)
99
+ case object
100
+ when Hash
101
+ object.each_with_object(self.class.new) do |(key, value), result|
102
+ result[yield(key)] = _deep_transform_keys_in_object(value, &block)
103
+ end
104
+ when Array
105
+ object.map { |element| _deep_transform_keys_in_object(element, &block) }
106
+ else
107
+ object
108
+ end
109
+ end
110
+ end
40
111
  end
41
112
 
113
+ #
114
+ # Monkey patches for the ruby Array
115
+ #
42
116
  class Array
43
117
  unless [].respond_to?(:extract_options!)
118
+ #
119
+ # Extract the last argument if it is a hash
120
+ #
121
+ #
122
+ # @return [Hash]
123
+ #
44
124
  def extract_options!
45
125
  if last.is_a?(Hash) && last.instance_of?(Hash)
46
126
  pop
@@ -0,0 +1,65 @@
1
+ # frozen_string_literal: true
2
+
3
+ module SidekiqUniqueJobs
4
+ #
5
+ # Class Deprecation provides logging of deprecations
6
+ #
7
+ # @author Mikael Henriksson <mikael@mhenrixon.com>
8
+ #
9
+ class Deprecation
10
+ #
11
+ # Mute warnings from this gem in a threaded context
12
+ #
13
+ #
14
+ # @return [void] <description>
15
+ #
16
+ # @yieldreturn [void]
17
+ def self.muted
18
+ orig_val = Thread.current[:uniquejobs_mute_deprecations]
19
+ Thread.current[:uniquejobs_mute_deprecations] = true
20
+ yield
21
+ ensure
22
+ Thread.current[:uniquejobs_mute_deprecations] = orig_val
23
+ end
24
+
25
+ #
26
+ # Check if deprecation warnings have been muted
27
+ #
28
+ #
29
+ # @return [true,false]
30
+ #
31
+ def self.muted?
32
+ Thread.current[:uniquejobs_mute_deprecations] == true
33
+ end
34
+
35
+ #
36
+ # Warn about deprecation
37
+ #
38
+ # @param [String] msg a descriptive reason for why the deprecation
39
+ #
40
+ # @return [void]
41
+ #
42
+ def self.warn(msg)
43
+ return if SidekiqUniqueJobs::Deprecation.muted?
44
+
45
+ warn "DEPRECATION WARNING: #{msg}"
46
+ nil
47
+ end
48
+
49
+ #
50
+ # Warn about deprecation and provide a context
51
+ #
52
+ # @param [String] msg a descriptive reason for why the deprecation
53
+ #
54
+ # @return [void]
55
+ #
56
+ def self.warn_with_backtrace(msg)
57
+ return if SidekiqUniqueJobs::Deprecation.muted?
58
+
59
+ trace = "\n\nCALLED FROM:\n#{caller.join("\n")}"
60
+ warn(msg + trace)
61
+
62
+ nil
63
+ end
64
+ end
65
+ end
@@ -1,77 +1,42 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module SidekiqUniqueJobs
4
- # Utility module to help manage unique digests in redis.
5
4
  #
6
- # @author Mikael Henriksson <mikael@zoolutions.se>
7
- module Digests
8
- DEFAULT_COUNT = 1_000
9
- SCAN_PATTERN = '*'
10
- CHUNK_SIZE = 100
11
-
12
- include SidekiqUniqueJobs::Logging
13
- include SidekiqUniqueJobs::Connection
14
- extend self # rubocop:disable Style/ModuleFunction
15
-
16
- # Return unique digests matching pattern
5
+ # Class Changelogs provides access to the changelog entries
6
+ #
7
+ # @author Mikael Henriksson <mikael@mhenrixon.com>
8
+ #
9
+ class Digests < Redis::SortedSet
17
10
  #
18
- # @param [String] pattern a pattern to match with
19
- # @param [Integer] count the maximum number to match
20
- # @return [Array<String>] with unique digests
21
- def all(pattern: SCAN_PATTERN, count: DEFAULT_COUNT)
22
- redis { |conn| conn.sscan_each(UNIQUE_SET, match: pattern, count: count).to_a }
23
- end
24
-
25
- # Paginate unique digests
11
+ # @return [Integer] the number of matches to return by default
12
+ DEFAULT_COUNT = 1_000
26
13
  #
27
- # @param [String] pattern a pattern to match with
28
- # @param [Integer] page the current cursor position
29
- # @param [Integer] count the maximum number to match
30
- # @return [Array<String>] with unique digests
31
- def page(pattern: SCAN_PATTERN, cursor: 0, page_size: 100)
32
- redis do |conn|
33
- total_size, digests = conn.multi do
34
- conn.scard(UNIQUE_SET)
35
- conn.sscan(UNIQUE_SET, cursor, match: pattern, count: page_size)
36
- end
14
+ # @return [String] the default pattern to use for matching
15
+ SCAN_PATTERN = "*"
37
16
 
38
- [total_size, digests[0], digests[1]]
39
- end
17
+ def initialize(digests_key = DIGESTS)
18
+ super(digests_key)
40
19
  end
41
20
 
42
- # Get a total count of unique digests
43
21
  #
44
- # @return [Integer] number of digests
45
- def count
46
- redis { |conn| conn.scard(UNIQUE_SET) }
47
- end
48
-
49
- # Deletes unique digest either by a digest or pattern
22
+ # Adds a digest
50
23
  #
51
- # @param [String] digest the full digest to delete
52
- # @param [String] pattern a key pattern to match with
53
- # @param [Integer] count the maximum number
54
- # @raise [ArgumentError] when both pattern and digest are nil
55
- # @return [Array<String>] with unique digests
56
- def del(digest: nil, pattern: nil, count: DEFAULT_COUNT)
57
- return delete_by_pattern(pattern, count: count) if pattern
58
- return delete_by_digest(digest) if digest
59
-
60
- raise ArgumentError, 'either digest or pattern need to be provided'
24
+ # @param [String] digest the digest to add
25
+ #
26
+ def add(digest)
27
+ redis { |conn| conn.zadd(key, now_f, digest) }
61
28
  end
62
29
 
63
- private
64
-
65
30
  # Deletes unique digests by pattern
66
31
  #
67
32
  # @param [String] pattern a key pattern to match with
68
33
  # @param [Integer] count the maximum number
69
- # @return [Array<String>] with unique digests
34
+ # @return [Hash<String,Float>] Hash mapping of digest matching the given pattern and score
35
+
70
36
  def delete_by_pattern(pattern, count: DEFAULT_COUNT)
71
37
  result, elapsed = timed do
72
- digests = all(pattern: pattern, count: count)
73
- batch_delete(digests)
74
- digests.size
38
+ digests = entries(pattern: pattern, count: count).keys
39
+ redis { |conn| BatchDelete.call(digests, conn) }
75
40
  end
76
41
 
77
42
  log_info("#{__method__}(#{pattern}, count: #{count}) completed in #{elapsed}ms")
@@ -79,13 +44,23 @@ module SidekiqUniqueJobs
79
44
  result
80
45
  end
81
46
 
82
- # Get a total count of unique digests
47
+ # Delete unique digests by digest
48
+ # Also deletes the :AVAILABLE, :EXPIRED etc keys
83
49
  #
84
- # @param [String] digest a key pattern to match with
85
- def delete_by_digest(digest)
50
+ # @param [String] digest a unique digest to delete
51
+ def delete_by_digest(digest) # rubocop:disable Metrics/MethodLength
86
52
  result, elapsed = timed do
87
- Scripts.call(:delete_by_digest, nil, keys: [UNIQUE_SET, digest])
88
- count
53
+ call_script(:delete_by_digest, [
54
+ digest,
55
+ "#{digest}:QUEUED",
56
+ "#{digest}:PRIMED",
57
+ "#{digest}:LOCKED",
58
+ "#{digest}:RUN",
59
+ "#{digest}:RUN:QUEUED",
60
+ "#{digest}:RUN:PRIMED",
61
+ "#{digest}:RUN:LOCKED",
62
+ key,
63
+ ])
89
64
  end
90
65
 
91
66
  log_info("#{__method__}(#{digest}) completed in #{elapsed}ms")
@@ -93,36 +68,44 @@ module SidekiqUniqueJobs
93
68
  result
94
69
  end
95
70
 
96
- def batch_delete(digests) # rubocop:disable Metrics/MethodLength
97
- redis do |conn|
98
- digests.each_slice(CHUNK_SIZE) do |chunk|
99
- conn.pipelined do
100
- chunk.each do |digest|
101
- conn.del digest
102
- conn.srem(UNIQUE_SET, digest)
103
- conn.del("#{digest}:EXISTS")
104
- conn.del("#{digest}:GRABBED")
105
- conn.del("#{digest}:VERSION")
106
- conn.del("#{digest}:AVAILABLE")
107
- conn.del("#{digest}:RUN:EXISTS")
108
- conn.del("#{digest}:RUN:GRABBED")
109
- conn.del("#{digest}:RUN:VERSION")
110
- conn.del("#{digest}:RUN:AVAILABLE")
111
- end
112
- end
113
- end
114
- end
115
- end
71
+ #
72
+ # The entries in this sorted set
73
+ #
74
+ # @param [String] pattern SCAN_PATTERN the match pattern to search for
75
+ # @param [Integer] count DEFAULT_COUNT the number of entries to return
76
+ #
77
+ # @return [Array<String>] an array of digests matching the given pattern
78
+ #
79
+ def entries(pattern: SCAN_PATTERN, count: DEFAULT_COUNT)
80
+ options = {}
81
+ options[:match] = pattern
82
+ options[:count] = count
116
83
 
117
- def timed
118
- start = current_time
119
- result = yield
120
- elapsed = (current_time - start).round(2)
121
- [result, elapsed]
84
+ redis { |conn| conn.zscan_each(key, **options).to_a }.to_h
122
85
  end
123
86
 
124
- def current_time
125
- Time.now
87
+ #
88
+ # Returns a paginated
89
+ #
90
+ # @param [Integer] cursor the cursor for this iteration
91
+ # @param [String] pattern SCAN_PATTERN the match pattern to search for
92
+ # @param [Integer] page_size 100 the size per page
93
+ #
94
+ # @return [Array<Integer, Integer, Array<Lock>>] total_size, next_cursor, locks
95
+ #
96
+ def page(cursor: 0, pattern: SCAN_PATTERN, page_size: 100)
97
+ redis do |conn|
98
+ total_size, digests = conn.multi do |pipeline|
99
+ pipeline.zcard(key)
100
+ pipeline.zscan(key, cursor, match: pattern, count: page_size)
101
+ end
102
+
103
+ [
104
+ total_size.to_i,
105
+ digests[0].to_i, # next_cursor
106
+ digests[1].map { |digest, score| Lock.new(digest, time: score) }, # entries
107
+ ]
108
+ end
126
109
  end
127
110
  end
128
111
  end
@@ -1,29 +1,105 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module SidekiqUniqueJobs
4
+ #
5
+ # Base class for all exceptions raised from the gem
6
+ #
7
+ # @author Mikael Henriksson <mikael@mhenrixon.com>
8
+ #
9
+ class UniqueJobsError < ::RuntimeError
10
+ end
11
+
4
12
  # Error raised when a Lua script fails to execute
5
13
  #
6
- # @author Mikael Henriksson <mikael@zoolutions.se>
7
- class Conflict < StandardError
14
+ # @author Mikael Henriksson <mikael@mhenrixon.com>
15
+ class Conflict < UniqueJobsError
8
16
  def initialize(item)
9
- super("Item with the key: #{item[UNIQUE_DIGEST_KEY]} is already scheduled or processing")
17
+ super("Item with the key: #{item[LOCK_DIGEST]} is already scheduled or processing")
18
+ end
19
+ end
20
+
21
+ #
22
+ # Raised when no block was given
23
+ #
24
+ class NoBlockGiven < SidekiqUniqueJobs::UniqueJobsError; end
25
+
26
+ #
27
+ # Raised when a notification has been mistyped
28
+ #
29
+ class NoSuchNotificationError < UniqueJobsError; end
30
+
31
+ #
32
+ # Error raised when trying to add a duplicate lock
33
+ #
34
+ # @author Mikael Henriksson <mikael@mhenrixon.com>
35
+ #
36
+ class DuplicateLock < UniqueJobsError
37
+ end
38
+
39
+ #
40
+ # Error raised when trying to add a duplicate stragegy
41
+ #
42
+ # @author Mikael Henriksson <mikael@mhenrixon.com>
43
+ #
44
+ class DuplicateStrategy < UniqueJobsError
45
+ end
46
+
47
+ #
48
+ # Error raised when an invalid argument is given
49
+ #
50
+ # @author Mikael Henriksson <mikael@mhenrixon.com>
51
+ #
52
+ class InvalidArgument < UniqueJobsError
53
+ end
54
+
55
+ #
56
+ # Raised when a workers configuration is invalid
57
+ #
58
+ # @author Mikael Henriksson <mikael@mhenrixon.com>
59
+ #
60
+ class InvalidWorker < UniqueJobsError
61
+ def initialize(lock_config)
62
+ super(<<~FAILURE_MESSAGE)
63
+ Expected #{lock_config.worker} to have valid sidekiq options but found the following problems:
64
+ #{lock_config.errors_as_string}
65
+ FAILURE_MESSAGE
66
+ end
67
+ end
68
+
69
+ # Error raised when a Lua script fails to execute
70
+ #
71
+ # @author Mikael Henriksson <mikael@mhenrixon.com>
72
+ class InvalidUniqueArguments < UniqueJobsError
73
+ def initialize(options)
74
+ given = options[:given]
75
+ job_class = options[:job_class]
76
+ lock_args_method = options[:lock_args_method]
77
+ lock_args_meth = job_class.method(lock_args_method)
78
+ num_args = lock_args_meth.arity
79
+ source_location = lock_args_meth.source_location
80
+
81
+ super(
82
+ "#{job_class}##{lock_args_method} takes #{num_args} arguments, received #{given.inspect}" \
83
+ "\n\n" \
84
+ " #{source_location.join(':')}"
85
+ )
10
86
  end
11
87
  end
12
88
 
13
- # Error raised from {OnConflict::Raise}
14
89
  #
15
- # @author Mikael Henriksson <mikael@zoolutions.se>
16
- class ScriptError < StandardError
17
- # @param [Symbol] file_name the name of the lua script
18
- # @param [Redis::CommandError] source_exception exception to handle
19
- def initialize(file_name:, source_exception:)
20
- super("Problem compiling #{file_name}. Message: #{source_exception.message}")
90
+ # Raised when a workers configuration is invalid
91
+ #
92
+ # @author Mikael Henriksson <mikael@mhenrixon.com>
93
+ #
94
+ class NotUniqueWorker < UniqueJobsError
95
+ def initialize(options)
96
+ super("#{options[:class]} is not configured for uniqueness. Missing the key `:lock` in #{options.inspect}")
21
97
  end
22
98
  end
23
99
 
24
100
  # Error raised from {OptionsWithFallback#lock_class}
25
101
  #
26
- # @author Mikael Henriksson <mikael@zoolutions.se>
27
- class UnknownLock < StandardError
102
+ # @author Mikael Henriksson <mikael@mhenrixon.com>
103
+ class UnknownLock < UniqueJobsError
28
104
  end
29
105
  end
@@ -0,0 +1,14 @@
1
+ # frozen_string_literal: true
2
+
3
+ module SidekiqUniqueJobs
4
+ #
5
+ # Class ExpiringDigests provides access to the expiring digests used by until_expired locks
6
+ #
7
+ # @author Mikael Henriksson <mikael@mhenrixon.com>
8
+ #
9
+ class ExpiringDigests < Digests
10
+ def initialize
11
+ super(EXPIRING_DIGESTS)
12
+ end
13
+ end
14
+ end
@@ -3,27 +3,61 @@
3
3
  module SidekiqUniqueJobs
4
4
  # Utility class to append uniqueness to the sidekiq job hash
5
5
  #
6
- # @author Mikael Henriksson <mikael@zoolutions.se>
6
+ # @author Mikael Henriksson <mikael@mhenrixon.com>
7
7
  module Job
8
- extend self # rubocop:disable Style/ModuleFunction
8
+ extend self
9
9
 
10
- # Adds timeout, expiration, unique_args, unique_prefix and unique_digest to the sidekiq job hash
11
- # @return [void] nothing returned here matters
12
- def add_uniqueness(item)
13
- add_timeout_and_expiration(item)
14
- add_unique_args_and_digest(item)
10
+ # Adds timeout, expiration, lock_args, lock_prefix and lock_digest to the sidekiq job hash
11
+ # @return [Hash] the job hash
12
+ def prepare(item)
13
+ stringify_on_conflict_hash(item)
14
+ add_lock_type(item)
15
+ add_lock_timeout(item)
16
+ add_lock_ttl(item)
17
+ add_digest(item)
18
+ end
19
+
20
+ # Adds lock_args, lock_prefix and lock_digest to the sidekiq job hash
21
+ # @return [Hash] the job hash
22
+ def add_digest(item)
23
+ add_lock_prefix(item)
24
+ add_lock_args(item)
25
+ add_lock_digest(item)
26
+
27
+ item
15
28
  end
16
29
 
17
30
  private
18
31
 
19
- def add_timeout_and_expiration(item)
20
- calculator = SidekiqUniqueJobs::Timeout::Calculator.new(item)
21
- item[LOCK_TIMEOUT_KEY] = calculator.lock_timeout
22
- item[LOCK_EXPIRATION_KEY] = calculator.lock_expiration
32
+ def stringify_on_conflict_hash(item)
33
+ on_conflict = item[ON_CONFLICT]
34
+ return unless on_conflict.is_a?(Hash)
35
+
36
+ item[ON_CONFLICT] = on_conflict.deep_stringify_keys
37
+ end
38
+
39
+ def add_lock_ttl(item)
40
+ item[LOCK_TTL] = SidekiqUniqueJobs::LockTTL.calculate(item)
41
+ end
42
+
43
+ def add_lock_timeout(item)
44
+ item[LOCK_TIMEOUT] ||= SidekiqUniqueJobs::LockTimeout.calculate(item)
45
+ end
46
+
47
+ def add_lock_args(item)
48
+ item[LOCK_ARGS] ||= SidekiqUniqueJobs::LockArgs.call(item)
49
+ end
50
+
51
+ def add_lock_digest(item)
52
+ item[LOCK_DIGEST] ||= SidekiqUniqueJobs::LockDigest.call(item)
53
+ end
54
+
55
+ def add_lock_prefix(item)
56
+ item[LOCK_PREFIX] ||= SidekiqUniqueJobs.config.lock_prefix
23
57
  end
24
58
 
25
- def add_unique_args_and_digest(item)
26
- SidekiqUniqueJobs::UniqueArgs.digest(item)
59
+ def add_lock_type(item)
60
+ item[LOCK] ||= SidekiqUniqueJobs::LockType.call(item)
27
61
  end
28
62
  end
29
63
  end