sidekiq-unique-jobs 6.0.25 → 7.1.5
Sign up to get free protection for your applications and to get access to all the features.
Potentially problematic release.
This version of sidekiq-unique-jobs might be problematic. Click here for more details.
- checksums.yaml +4 -4
- data/CHANGELOG.md +840 -41
- data/README.md +814 -284
- data/lib/sidekiq_unique_jobs/batch_delete.rb +123 -0
- data/lib/sidekiq_unique_jobs/changelog.rb +78 -0
- data/lib/sidekiq_unique_jobs/cli.rb +34 -31
- data/lib/sidekiq_unique_jobs/config.rb +275 -0
- data/lib/sidekiq_unique_jobs/connection.rb +6 -5
- data/lib/sidekiq_unique_jobs/constants.rb +45 -25
- data/lib/sidekiq_unique_jobs/core_ext.rb +80 -0
- data/lib/sidekiq_unique_jobs/deprecation.rb +35 -0
- data/lib/sidekiq_unique_jobs/digests.rb +71 -100
- data/lib/sidekiq_unique_jobs/exceptions.rb +87 -12
- data/lib/sidekiq_unique_jobs/job.rb +41 -12
- data/lib/sidekiq_unique_jobs/json.rb +40 -0
- data/lib/sidekiq_unique_jobs/key.rb +93 -0
- data/lib/sidekiq_unique_jobs/lock/base_lock.rb +100 -79
- data/lib/sidekiq_unique_jobs/lock/client_validator.rb +28 -0
- data/lib/sidekiq_unique_jobs/lock/server_validator.rb +27 -0
- data/lib/sidekiq_unique_jobs/lock/until_and_while_executing.rb +34 -15
- data/lib/sidekiq_unique_jobs/lock/until_executed.rb +19 -7
- data/lib/sidekiq_unique_jobs/lock/until_executing.rb +16 -2
- data/lib/sidekiq_unique_jobs/lock/until_expired.rb +20 -16
- data/lib/sidekiq_unique_jobs/lock/validator.rb +96 -0
- data/lib/sidekiq_unique_jobs/lock/while_executing.rb +19 -10
- data/lib/sidekiq_unique_jobs/lock/while_executing_reject.rb +3 -3
- data/lib/sidekiq_unique_jobs/lock.rb +325 -0
- data/lib/sidekiq_unique_jobs/lock_args.rb +123 -0
- data/lib/sidekiq_unique_jobs/lock_config.rb +126 -0
- data/lib/sidekiq_unique_jobs/lock_digest.rb +79 -0
- data/lib/sidekiq_unique_jobs/lock_info.rb +68 -0
- data/lib/sidekiq_unique_jobs/lock_timeout.rb +62 -0
- data/lib/sidekiq_unique_jobs/lock_ttl.rb +77 -0
- data/lib/sidekiq_unique_jobs/locksmith.rb +275 -102
- data/lib/sidekiq_unique_jobs/logging/middleware_context.rb +44 -0
- data/lib/sidekiq_unique_jobs/logging.rb +179 -33
- data/lib/sidekiq_unique_jobs/lua/delete.lua +51 -0
- data/lib/sidekiq_unique_jobs/lua/delete_by_digest.lua +42 -0
- data/lib/sidekiq_unique_jobs/lua/delete_job_by_digest.lua +38 -0
- data/lib/sidekiq_unique_jobs/lua/find_digest_in_queues.lua +26 -0
- data/lib/sidekiq_unique_jobs/lua/lock.lua +93 -0
- data/lib/sidekiq_unique_jobs/lua/locked.lua +35 -0
- data/lib/sidekiq_unique_jobs/lua/queue.lua +87 -0
- data/lib/sidekiq_unique_jobs/lua/reap_orphans.lua +94 -0
- data/lib/sidekiq_unique_jobs/lua/shared/_common.lua +40 -0
- data/lib/sidekiq_unique_jobs/lua/shared/_current_time.lua +8 -0
- data/lib/sidekiq_unique_jobs/lua/shared/_delete_from_queue.lua +22 -0
- data/lib/sidekiq_unique_jobs/lua/shared/_delete_from_sorted_set.lua +18 -0
- data/lib/sidekiq_unique_jobs/lua/shared/_find_digest_in_process_set.lua +53 -0
- data/lib/sidekiq_unique_jobs/lua/shared/_find_digest_in_queues.lua +43 -0
- data/lib/sidekiq_unique_jobs/lua/shared/_find_digest_in_sorted_set.lua +24 -0
- data/lib/sidekiq_unique_jobs/lua/shared/_hgetall.lua +13 -0
- data/lib/sidekiq_unique_jobs/lua/shared/_upgrades.lua +3 -0
- data/lib/sidekiq_unique_jobs/lua/unlock.lua +95 -0
- data/lib/sidekiq_unique_jobs/lua/update_version.lua +40 -0
- data/lib/sidekiq_unique_jobs/lua/upgrade.lua +68 -0
- data/lib/sidekiq_unique_jobs/middleware/client.rb +40 -0
- data/lib/sidekiq_unique_jobs/middleware/server.rb +29 -0
- data/lib/sidekiq_unique_jobs/middleware.rb +29 -43
- data/lib/sidekiq_unique_jobs/normalizer.rb +4 -4
- data/lib/sidekiq_unique_jobs/on_conflict/log.rb +9 -5
- data/lib/sidekiq_unique_jobs/on_conflict/null_strategy.rb +1 -1
- data/lib/sidekiq_unique_jobs/on_conflict/raise.rb +1 -1
- data/lib/sidekiq_unique_jobs/on_conflict/reject.rb +61 -15
- data/lib/sidekiq_unique_jobs/on_conflict/replace.rb +54 -14
- data/lib/sidekiq_unique_jobs/on_conflict/reschedule.rb +16 -5
- data/lib/sidekiq_unique_jobs/on_conflict/strategy.rb +25 -6
- data/lib/sidekiq_unique_jobs/on_conflict.rb +23 -10
- data/lib/sidekiq_unique_jobs/options_with_fallback.rb +34 -29
- data/lib/sidekiq_unique_jobs/orphans/lua_reaper.rb +29 -0
- data/lib/sidekiq_unique_jobs/orphans/manager.rb +213 -0
- data/lib/sidekiq_unique_jobs/orphans/null_reaper.rb +24 -0
- data/lib/sidekiq_unique_jobs/orphans/observer.rb +42 -0
- data/lib/sidekiq_unique_jobs/orphans/reaper.rb +114 -0
- data/lib/sidekiq_unique_jobs/orphans/reaper_resurrector.rb +170 -0
- data/lib/sidekiq_unique_jobs/orphans/ruby_reaper.rb +213 -0
- data/lib/sidekiq_unique_jobs/redis/entity.rb +112 -0
- data/lib/sidekiq_unique_jobs/redis/hash.rb +56 -0
- data/lib/sidekiq_unique_jobs/redis/list.rb +32 -0
- data/lib/sidekiq_unique_jobs/redis/set.rb +32 -0
- data/lib/sidekiq_unique_jobs/redis/sorted_set.rb +86 -0
- data/lib/sidekiq_unique_jobs/redis/string.rb +49 -0
- data/lib/sidekiq_unique_jobs/redis.rb +11 -0
- data/lib/sidekiq_unique_jobs/reflectable.rb +17 -0
- data/lib/sidekiq_unique_jobs/reflections.rb +68 -0
- data/lib/sidekiq_unique_jobs/rspec/matchers/have_valid_sidekiq_options.rb +51 -0
- data/lib/sidekiq_unique_jobs/rspec/matchers.rb +26 -0
- data/lib/sidekiq_unique_jobs/script/caller.rb +127 -0
- data/lib/sidekiq_unique_jobs/script.rb +15 -0
- data/lib/sidekiq_unique_jobs/server.rb +49 -0
- data/lib/sidekiq_unique_jobs/sidekiq_unique_ext.rb +92 -65
- data/lib/sidekiq_unique_jobs/sidekiq_unique_jobs.rb +241 -35
- data/lib/sidekiq_unique_jobs/sidekiq_worker_methods.rb +11 -15
- data/lib/sidekiq_unique_jobs/testing.rb +62 -21
- data/lib/sidekiq_unique_jobs/timer_task.rb +78 -0
- data/lib/sidekiq_unique_jobs/timing.rb +58 -0
- data/lib/sidekiq_unique_jobs/unlockable.rb +20 -4
- data/lib/sidekiq_unique_jobs/update_version.rb +25 -0
- data/lib/sidekiq_unique_jobs/upgrade_locks.rb +155 -0
- data/lib/sidekiq_unique_jobs/version.rb +3 -1
- data/lib/sidekiq_unique_jobs/version_check.rb +23 -4
- data/lib/sidekiq_unique_jobs/web/helpers.rb +128 -13
- data/lib/sidekiq_unique_jobs/web/views/_paging.erb +4 -4
- data/lib/sidekiq_unique_jobs/web/views/changelogs.erb +54 -0
- data/lib/sidekiq_unique_jobs/web/views/lock.erb +108 -0
- data/lib/sidekiq_unique_jobs/web/views/locks.erb +54 -0
- data/lib/sidekiq_unique_jobs/web.rb +57 -27
- data/lib/sidekiq_unique_jobs.rb +52 -7
- data/lib/tasks/changelog.rake +5 -5
- metadata +121 -177
- data/lib/sidekiq_unique_jobs/client/middleware.rb +0 -56
- data/lib/sidekiq_unique_jobs/scripts.rb +0 -118
- data/lib/sidekiq_unique_jobs/server/middleware.rb +0 -46
- data/lib/sidekiq_unique_jobs/timeout/calculator.rb +0 -63
- data/lib/sidekiq_unique_jobs/timeout.rb +0 -8
- data/lib/sidekiq_unique_jobs/unique_args.rb +0 -150
- data/lib/sidekiq_unique_jobs/util.rb +0 -103
- data/lib/sidekiq_unique_jobs/web/views/unique_digest.erb +0 -28
- data/lib/sidekiq_unique_jobs/web/views/unique_digests.erb +0 -46
- data/redis/acquire_lock.lua +0 -21
- data/redis/convert_legacy_lock.lua +0 -13
- data/redis/delete.lua +0 -14
- data/redis/delete_by_digest.lua +0 -23
- data/redis/delete_job_by_digest.lua +0 -60
- data/redis/lock.lua +0 -62
- data/redis/release_stale_locks.lua +0 -90
- data/redis/unlock.lua +0 -35
@@ -0,0 +1,213 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module SidekiqUniqueJobs
|
4
|
+
module Orphans
|
5
|
+
#
|
6
|
+
# Class DeleteOrphans provides deletion of orphaned digests
|
7
|
+
#
|
8
|
+
# @note this is a much slower version of the lua script but does not crash redis
|
9
|
+
#
|
10
|
+
# @author Mikael Henriksson <mikael@mhenrixon.com>
|
11
|
+
#
|
12
|
+
class RubyReaper < Reaper
|
13
|
+
RUN_SUFFIX = ":RUN"
|
14
|
+
#
|
15
|
+
# @!attribute [r] digests
|
16
|
+
# @return [SidekiqUniqueJobs::Digests] digest collection
|
17
|
+
attr_reader :digests
|
18
|
+
#
|
19
|
+
# @!attribute [r] scheduled
|
20
|
+
# @return [Redis::SortedSet] the Sidekiq ScheduleSet
|
21
|
+
attr_reader :scheduled
|
22
|
+
#
|
23
|
+
# @!attribute [r] retried
|
24
|
+
# @return [Redis::SortedSet] the Sidekiq RetrySet
|
25
|
+
attr_reader :retried
|
26
|
+
|
27
|
+
#
|
28
|
+
# Initialize a new instance of DeleteOrphans
|
29
|
+
#
|
30
|
+
# @param [Redis] conn a connection to redis
|
31
|
+
#
|
32
|
+
def initialize(conn)
|
33
|
+
super(conn)
|
34
|
+
@digests = SidekiqUniqueJobs::Digests.new
|
35
|
+
@scheduled = Redis::SortedSet.new(SCHEDULE)
|
36
|
+
@retried = Redis::SortedSet.new(RETRY)
|
37
|
+
end
|
38
|
+
|
39
|
+
#
|
40
|
+
# Delete orphaned digests
|
41
|
+
#
|
42
|
+
#
|
43
|
+
# @return [Integer] the number of reaped locks
|
44
|
+
#
|
45
|
+
def call
|
46
|
+
BatchDelete.call(orphans, conn)
|
47
|
+
end
|
48
|
+
|
49
|
+
#
|
50
|
+
# Find orphaned digests
|
51
|
+
#
|
52
|
+
#
|
53
|
+
# @return [Array<String>] an array of orphaned digests
|
54
|
+
#
|
55
|
+
def orphans
|
56
|
+
conn.zrevrange(digests.key, 0, -1).each_with_object([]) do |digest, memo|
|
57
|
+
next if belongs_to_job?(digest)
|
58
|
+
|
59
|
+
memo << digest
|
60
|
+
break if memo.size >= reaper_count
|
61
|
+
end
|
62
|
+
end
|
63
|
+
|
64
|
+
#
|
65
|
+
# Checks if the digest has a matching job.
|
66
|
+
# 1. It checks the scheduled set
|
67
|
+
# 2. It checks the retry set
|
68
|
+
# 3. It goes through all queues
|
69
|
+
#
|
70
|
+
#
|
71
|
+
# @param [String] digest the digest to search for
|
72
|
+
#
|
73
|
+
# @return [true] when either of the checks return true
|
74
|
+
# @return [false] when no job was found for this digest
|
75
|
+
#
|
76
|
+
def belongs_to_job?(digest)
|
77
|
+
scheduled?(digest) || retried?(digest) || enqueued?(digest) || active?(digest)
|
78
|
+
end
|
79
|
+
|
80
|
+
#
|
81
|
+
# Checks if the digest exists in the Sidekiq::ScheduledSet
|
82
|
+
#
|
83
|
+
# @param [String] digest the current digest
|
84
|
+
#
|
85
|
+
# @return [true] when digest exists in scheduled set
|
86
|
+
#
|
87
|
+
def scheduled?(digest)
|
88
|
+
in_sorted_set?(SCHEDULE, digest)
|
89
|
+
end
|
90
|
+
|
91
|
+
#
|
92
|
+
# Checks if the digest exists in the Sidekiq::RetrySet
|
93
|
+
#
|
94
|
+
# @param [String] digest the current digest
|
95
|
+
#
|
96
|
+
# @return [true] when digest exists in retry set
|
97
|
+
#
|
98
|
+
def retried?(digest)
|
99
|
+
in_sorted_set?(RETRY, digest)
|
100
|
+
end
|
101
|
+
|
102
|
+
#
|
103
|
+
# Checks if the digest exists in a Sidekiq::Queue
|
104
|
+
#
|
105
|
+
# @param [String] digest the current digest
|
106
|
+
#
|
107
|
+
# @return [true] when digest exists in any queue
|
108
|
+
#
|
109
|
+
def enqueued?(digest)
|
110
|
+
Sidekiq.redis do |conn|
|
111
|
+
queues(conn) do |queue|
|
112
|
+
entries(conn, queue) do |entry|
|
113
|
+
return true if entry.include?(digest)
|
114
|
+
end
|
115
|
+
end
|
116
|
+
|
117
|
+
false
|
118
|
+
end
|
119
|
+
end
|
120
|
+
|
121
|
+
def active?(digest) # rubocop:disable Metrics/MethodLength, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
|
122
|
+
Sidekiq.redis do |conn|
|
123
|
+
procs = conn.sscan_each("processes").to_a
|
124
|
+
return false if procs.empty?
|
125
|
+
|
126
|
+
procs.sort.each do |key|
|
127
|
+
valid, workers = conn.pipelined do
|
128
|
+
# TODO: Remove the if statement in the future
|
129
|
+
if conn.respond_to?(:exists?)
|
130
|
+
conn.exists?(key)
|
131
|
+
else
|
132
|
+
conn.exists(key)
|
133
|
+
end
|
134
|
+
conn.hgetall("#{key}:workers")
|
135
|
+
end
|
136
|
+
|
137
|
+
next unless valid
|
138
|
+
next unless workers.any?
|
139
|
+
|
140
|
+
workers.each_pair do |_tid, job|
|
141
|
+
next unless (item = safe_load_json(job))
|
142
|
+
|
143
|
+
payload = safe_load_json(item[PAYLOAD])
|
144
|
+
|
145
|
+
return true if match?(digest, payload[LOCK_DIGEST])
|
146
|
+
return true if considered_active?(payload[CREATED_AT])
|
147
|
+
end
|
148
|
+
end
|
149
|
+
|
150
|
+
false
|
151
|
+
end
|
152
|
+
end
|
153
|
+
|
154
|
+
def match?(key_one, key_two)
|
155
|
+
return false if key_one.nil? || key_two.nil?
|
156
|
+
|
157
|
+
key_one.delete_suffix(RUN_SUFFIX) == key_two.delete_suffix(RUN_SUFFIX)
|
158
|
+
end
|
159
|
+
|
160
|
+
def considered_active?(time_f)
|
161
|
+
(Time.now - reaper_timeout).to_f < time_f
|
162
|
+
end
|
163
|
+
|
164
|
+
#
|
165
|
+
# Loops through all the redis queues and yields them one by one
|
166
|
+
#
|
167
|
+
# @param [Redis] conn the connection to use for fetching queues
|
168
|
+
#
|
169
|
+
# @return [void]
|
170
|
+
#
|
171
|
+
# @yield queues one at a time
|
172
|
+
#
|
173
|
+
def queues(conn, &block)
|
174
|
+
conn.sscan_each("queues", &block)
|
175
|
+
end
|
176
|
+
|
177
|
+
def entries(conn, queue, &block) # rubocop:disable Metrics/MethodLength
|
178
|
+
queue_key = "queue:#{queue}"
|
179
|
+
initial_size = conn.llen(queue_key)
|
180
|
+
deleted_size = 0
|
181
|
+
page = 0
|
182
|
+
page_size = 50
|
183
|
+
|
184
|
+
loop do
|
185
|
+
range_start = page * page_size - deleted_size
|
186
|
+
range_end = range_start + page_size - 1
|
187
|
+
entries = conn.lrange(queue_key, range_start, range_end)
|
188
|
+
page += 1
|
189
|
+
|
190
|
+
break if entries.empty?
|
191
|
+
|
192
|
+
entries.each(&block)
|
193
|
+
|
194
|
+
deleted_size = initial_size - conn.llen(queue_key)
|
195
|
+
end
|
196
|
+
end
|
197
|
+
|
198
|
+
#
|
199
|
+
# Checks a sorted set for the existance of this digest
|
200
|
+
#
|
201
|
+
#
|
202
|
+
# @param [String] key the key for the sorted set
|
203
|
+
# @param [String] digest the digest to scan for
|
204
|
+
#
|
205
|
+
# @return [true] when found
|
206
|
+
# @return [false] when missing
|
207
|
+
#
|
208
|
+
def in_sorted_set?(key, digest)
|
209
|
+
conn.zscan_each(key, match: "*#{digest}*", count: 1).to_a.any?
|
210
|
+
end
|
211
|
+
end
|
212
|
+
end
|
213
|
+
end
|
@@ -0,0 +1,112 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module SidekiqUniqueJobs
|
4
|
+
module Redis
|
5
|
+
#
|
6
|
+
# Class Entity functions as a base class for redis types
|
7
|
+
#
|
8
|
+
# @author Mikael Henriksson <mikael@mhenrixon.com>
|
9
|
+
#
|
10
|
+
class Entity
|
11
|
+
# includes "SidekiqUniqueJobs::Logging"
|
12
|
+
# @!parse include SidekiqUniqueJobs::Logging
|
13
|
+
include SidekiqUniqueJobs::Logging
|
14
|
+
|
15
|
+
# includes "SidekiqUniqueJobs::Script::Caller"
|
16
|
+
# @!parse include SidekiqUniqueJobs::Script::Caller
|
17
|
+
include SidekiqUniqueJobs::Script::Caller
|
18
|
+
|
19
|
+
# includes "SidekiqUniqueJobs::JSON"
|
20
|
+
# @!parse include SidekiqUniqueJobs::JSON
|
21
|
+
include SidekiqUniqueJobs::JSON
|
22
|
+
|
23
|
+
# includes "SidekiqUniqueJobs::Timing"
|
24
|
+
# @!parse include SidekiqUniqueJobs::Timing
|
25
|
+
include SidekiqUniqueJobs::Timing
|
26
|
+
|
27
|
+
#
|
28
|
+
# @!attribute [r] key
|
29
|
+
# @return [String] the redis key for this entity
|
30
|
+
attr_reader :key
|
31
|
+
|
32
|
+
#
|
33
|
+
# Initialize a new Entity
|
34
|
+
#
|
35
|
+
# @param [String] key the redis key for this entity
|
36
|
+
#
|
37
|
+
def initialize(key)
|
38
|
+
@key = key
|
39
|
+
end
|
40
|
+
|
41
|
+
#
|
42
|
+
# Checks if the key for this entity exists in redis
|
43
|
+
#
|
44
|
+
#
|
45
|
+
# @return [true] when exists
|
46
|
+
# @return [false] when not exists
|
47
|
+
#
|
48
|
+
def exist?
|
49
|
+
redis do |conn|
|
50
|
+
# TODO: Remove the if statement in the future
|
51
|
+
value =
|
52
|
+
if conn.respond_to?(:exists?)
|
53
|
+
conn.exists?(key)
|
54
|
+
else
|
55
|
+
conn.exists(key)
|
56
|
+
end
|
57
|
+
|
58
|
+
return value if boolean?(value)
|
59
|
+
|
60
|
+
value.to_i.positive?
|
61
|
+
end
|
62
|
+
end
|
63
|
+
|
64
|
+
#
|
65
|
+
# The number of microseconds until the key expires
|
66
|
+
#
|
67
|
+
#
|
68
|
+
# @return [Integer] expiration in milliseconds
|
69
|
+
#
|
70
|
+
def pttl
|
71
|
+
redis { |conn| conn.pttl(key) }
|
72
|
+
end
|
73
|
+
|
74
|
+
#
|
75
|
+
# The number of seconds until the key expires
|
76
|
+
#
|
77
|
+
#
|
78
|
+
# @return [Integer] expiration in seconds
|
79
|
+
#
|
80
|
+
def ttl
|
81
|
+
redis { |conn| conn.ttl(key) }
|
82
|
+
end
|
83
|
+
|
84
|
+
#
|
85
|
+
# Check if the entity has expiration
|
86
|
+
#
|
87
|
+
#
|
88
|
+
# @return [true] when entity is set to exire
|
89
|
+
# @return [false] when entity isn't expiring
|
90
|
+
#
|
91
|
+
def expires?
|
92
|
+
pttl.positive? || ttl.positive?
|
93
|
+
end
|
94
|
+
|
95
|
+
#
|
96
|
+
# Returns the number of entries in this entity
|
97
|
+
#
|
98
|
+
#
|
99
|
+
# @return [Integer] 0
|
100
|
+
#
|
101
|
+
def count
|
102
|
+
0
|
103
|
+
end
|
104
|
+
|
105
|
+
private
|
106
|
+
|
107
|
+
def boolean?(value)
|
108
|
+
[TrueClass, FalseClass].any? { |klazz| value.is_a?(klazz) }
|
109
|
+
end
|
110
|
+
end
|
111
|
+
end
|
112
|
+
end
|
@@ -0,0 +1,56 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module SidekiqUniqueJobs
|
4
|
+
module Redis
|
5
|
+
#
|
6
|
+
# Class Hash provides convenient access to redis hashes
|
7
|
+
#
|
8
|
+
# @author Mikael Henriksson <mikael@mhenrixon.com>
|
9
|
+
#
|
10
|
+
class Hash < Entity
|
11
|
+
#
|
12
|
+
# Return entries for this hash
|
13
|
+
#
|
14
|
+
# @param [true,false] with_values false return hash
|
15
|
+
#
|
16
|
+
# @return [Array<Object>] when given with_values: false
|
17
|
+
# @return [Hash<String, String>] when given with_values: true
|
18
|
+
#
|
19
|
+
def entries(with_values: false)
|
20
|
+
if with_values
|
21
|
+
redis { |conn| conn.hgetall(key) }
|
22
|
+
else
|
23
|
+
redis { |conn| conn.hkeys(key) }
|
24
|
+
end
|
25
|
+
end
|
26
|
+
|
27
|
+
#
|
28
|
+
# Removes the key from redis
|
29
|
+
#
|
30
|
+
def del(*fields)
|
31
|
+
redis { |conn| conn.hdel(key, *fields) }
|
32
|
+
end
|
33
|
+
|
34
|
+
#
|
35
|
+
# Get a members value
|
36
|
+
#
|
37
|
+
# @param [String] member the member who's value to get
|
38
|
+
#
|
39
|
+
# @return [Object] whatever is stored on this hash member
|
40
|
+
#
|
41
|
+
def [](member)
|
42
|
+
redis { |conn| conn.hget(key, member) }
|
43
|
+
end
|
44
|
+
|
45
|
+
#
|
46
|
+
# Returns the count for this hash
|
47
|
+
#
|
48
|
+
#
|
49
|
+
# @return [Integer] the length of this hash
|
50
|
+
#
|
51
|
+
def count
|
52
|
+
redis { |conn| conn.hlen(key) }
|
53
|
+
end
|
54
|
+
end
|
55
|
+
end
|
56
|
+
end
|
@@ -0,0 +1,32 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module SidekiqUniqueJobs
|
4
|
+
module Redis
|
5
|
+
#
|
6
|
+
# Class List provides convenient access to redis hashes
|
7
|
+
#
|
8
|
+
# @author Mikael Henriksson <mikael@mhenrixon.com>
|
9
|
+
#
|
10
|
+
class List < Entity
|
11
|
+
#
|
12
|
+
# Entries in this list
|
13
|
+
#
|
14
|
+
#
|
15
|
+
# @return [Array<Object>] the elements in this list
|
16
|
+
#
|
17
|
+
def entries
|
18
|
+
redis { |conn| conn.lrange(key, 0, -1) }
|
19
|
+
end
|
20
|
+
|
21
|
+
#
|
22
|
+
# The number of entries in this list
|
23
|
+
#
|
24
|
+
#
|
25
|
+
# @return [Integer] the total number of entries
|
26
|
+
#
|
27
|
+
def count
|
28
|
+
redis { |conn| conn.llen(key) }
|
29
|
+
end
|
30
|
+
end
|
31
|
+
end
|
32
|
+
end
|
@@ -0,0 +1,32 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module SidekiqUniqueJobs
|
4
|
+
module Redis
|
5
|
+
#
|
6
|
+
# Class Set provides convenient access to redis sets
|
7
|
+
#
|
8
|
+
# @author Mikael Henriksson <mikael@mhenrixon.com>
|
9
|
+
#
|
10
|
+
class Set < Entity
|
11
|
+
#
|
12
|
+
# Return entries for this set
|
13
|
+
#
|
14
|
+
#
|
15
|
+
# @return [Array<String>]
|
16
|
+
#
|
17
|
+
def entries
|
18
|
+
redis { |conn| conn.smembers(key) }
|
19
|
+
end
|
20
|
+
|
21
|
+
#
|
22
|
+
# Returns the count for this sorted set
|
23
|
+
#
|
24
|
+
#
|
25
|
+
# @return [Integer] the number of entries
|
26
|
+
#
|
27
|
+
def count
|
28
|
+
redis { |conn| conn.scard(key) }
|
29
|
+
end
|
30
|
+
end
|
31
|
+
end
|
32
|
+
end
|
@@ -0,0 +1,86 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module SidekiqUniqueJobs
|
4
|
+
module Redis
|
5
|
+
#
|
6
|
+
# Class SortedSet provides convenient access to redis sorted sets
|
7
|
+
#
|
8
|
+
# @author Mikael Henriksson <mikael@mhenrixon.com>
|
9
|
+
#
|
10
|
+
class SortedSet < Entity
|
11
|
+
#
|
12
|
+
# Return entries for this sorted set
|
13
|
+
#
|
14
|
+
# @param [true,false] with_scores true return
|
15
|
+
#
|
16
|
+
# @return [Array<Object>] when given with_scores: false
|
17
|
+
# @return [Hash] when given with_scores: true
|
18
|
+
#
|
19
|
+
def entries(with_scores: true)
|
20
|
+
entrys = redis { |conn| conn.zrange(key, 0, -1, with_scores: with_scores) }
|
21
|
+
return entrys unless with_scores
|
22
|
+
|
23
|
+
entrys.each_with_object({}) { |pair, hash| hash[pair[0]] = pair[1] }
|
24
|
+
end
|
25
|
+
|
26
|
+
#
|
27
|
+
# Adds a value to the sorted set
|
28
|
+
#
|
29
|
+
# @param [Array<Float, String>, String] values the values to add
|
30
|
+
#
|
31
|
+
# @return [Boolean, Integer] <description>
|
32
|
+
#
|
33
|
+
def add(values)
|
34
|
+
redis do |conn|
|
35
|
+
if values.is_a?(Array)
|
36
|
+
conn.zadd(key, values)
|
37
|
+
else
|
38
|
+
conn.zadd(key, now_f, values)
|
39
|
+
end
|
40
|
+
end
|
41
|
+
end
|
42
|
+
|
43
|
+
#
|
44
|
+
# Return the zrak of the member
|
45
|
+
#
|
46
|
+
# @param [String] member the member to pull rank on
|
47
|
+
#
|
48
|
+
# @return [Integer]
|
49
|
+
#
|
50
|
+
def rank(member)
|
51
|
+
redis { |conn| conn.zrank(key, member) }
|
52
|
+
end
|
53
|
+
|
54
|
+
#
|
55
|
+
# Return score for a member
|
56
|
+
#
|
57
|
+
# @param [String] member the member for which score
|
58
|
+
#
|
59
|
+
# @return [Integer, Float]
|
60
|
+
#
|
61
|
+
def score(member)
|
62
|
+
redis { |conn| conn.zscore(key, member) }
|
63
|
+
end
|
64
|
+
|
65
|
+
#
|
66
|
+
# Clears the sorted set from all entries
|
67
|
+
#
|
68
|
+
#
|
69
|
+
# @return [Integer] number of entries removed
|
70
|
+
#
|
71
|
+
def clear
|
72
|
+
redis { |conn| conn.zremrangebyrank(key, 0, count) }
|
73
|
+
end
|
74
|
+
|
75
|
+
#
|
76
|
+
# Returns the count for this sorted set
|
77
|
+
#
|
78
|
+
#
|
79
|
+
# @return [Integer] the number of entries
|
80
|
+
#
|
81
|
+
def count
|
82
|
+
redis { |conn| conn.zcard(key) }
|
83
|
+
end
|
84
|
+
end
|
85
|
+
end
|
86
|
+
end
|
@@ -0,0 +1,49 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module SidekiqUniqueJobs
|
4
|
+
module Redis
|
5
|
+
#
|
6
|
+
# Class String provides convenient access to redis strings
|
7
|
+
#
|
8
|
+
# @author Mikael Henriksson <mikael@mhenrixon.com>
|
9
|
+
#
|
10
|
+
class String < Entity
|
11
|
+
#
|
12
|
+
# Returns the value of the key
|
13
|
+
#
|
14
|
+
#
|
15
|
+
# @return [String]
|
16
|
+
#
|
17
|
+
def value
|
18
|
+
redis { |conn| conn.get(key) }
|
19
|
+
end
|
20
|
+
|
21
|
+
#
|
22
|
+
# Sets the value of the key to given object
|
23
|
+
#
|
24
|
+
# @param [String] obj the object to update the key with
|
25
|
+
#
|
26
|
+
# @return [true, false]
|
27
|
+
#
|
28
|
+
def set(obj)
|
29
|
+
redis { |conn| conn.set(key, obj) }
|
30
|
+
end
|
31
|
+
|
32
|
+
#
|
33
|
+
# Removes the key from redis
|
34
|
+
#
|
35
|
+
def del(*)
|
36
|
+
redis { |conn| conn.del(key) }
|
37
|
+
end
|
38
|
+
|
39
|
+
#
|
40
|
+
# Used only for compatibility with other keys
|
41
|
+
#
|
42
|
+
# @return [1] when key exists
|
43
|
+
# @return [0] when key does not exists
|
44
|
+
def count
|
45
|
+
exist? ? 1 : 0
|
46
|
+
end
|
47
|
+
end
|
48
|
+
end
|
49
|
+
end
|
@@ -0,0 +1,17 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module SidekiqUniqueJobs
|
4
|
+
#
|
5
|
+
# Module Reflectable provides a method to notify subscribers
|
6
|
+
#
|
7
|
+
# @author Mikael Henriksson <mikael@mhenrixon.com>
|
8
|
+
#
|
9
|
+
module Reflectable
|
10
|
+
def reflect(name, *args)
|
11
|
+
SidekiqUniqueJobs.reflections.dispatch(name, *args)
|
12
|
+
nil
|
13
|
+
rescue UniqueJobsError => ex
|
14
|
+
SidekiqUniqueJobs.logger.error(ex)
|
15
|
+
end
|
16
|
+
end
|
17
|
+
end
|
@@ -0,0 +1,68 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module SidekiqUniqueJobs
|
4
|
+
#
|
5
|
+
# Class NotificationCollection provides a collection with known notifications
|
6
|
+
#
|
7
|
+
# @author Mikael Henriksson <mikael@mhenrixon.com>
|
8
|
+
#
|
9
|
+
class Reflections
|
10
|
+
#
|
11
|
+
# @return [Array<Symbol>] list of notifications
|
12
|
+
REFLECTIONS = [
|
13
|
+
:after_unlock_callback_failed,
|
14
|
+
:debug,
|
15
|
+
:duplicate,
|
16
|
+
:error,
|
17
|
+
:execution_failed,
|
18
|
+
:lock_failed,
|
19
|
+
:locked,
|
20
|
+
:reschedule_failed,
|
21
|
+
:rescheduled,
|
22
|
+
:timeout,
|
23
|
+
:unknown_sidekiq_worker,
|
24
|
+
:unlock_failed,
|
25
|
+
:unlocked,
|
26
|
+
].freeze
|
27
|
+
|
28
|
+
#
|
29
|
+
# @return [Hash<Symbol, Array<Symbol, String>>] a hash with deprecated notifications
|
30
|
+
DEPRECATIONS = {}.freeze
|
31
|
+
|
32
|
+
REFLECTIONS.each do |reflection|
|
33
|
+
class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
|
34
|
+
def #{reflection}(*args, &block) # def unlock_failed(*args, &block)
|
35
|
+
raise NoBlockGiven, "block required" unless block_given? # raise NoBlockGiven, "block required" unless block_given?
|
36
|
+
@reflections[:#{reflection}] = block # @notifications[:unlock_failed] = block
|
37
|
+
end # end
|
38
|
+
RUBY
|
39
|
+
end
|
40
|
+
|
41
|
+
def initialize
|
42
|
+
@reflections = {}
|
43
|
+
end
|
44
|
+
|
45
|
+
def dispatch(reflection, *args)
|
46
|
+
if (block = @reflections[reflection])
|
47
|
+
block.call(*args)
|
48
|
+
|
49
|
+
if DEPRECATIONS.key?(reflection)
|
50
|
+
replacement, removal_version = DEPRECATIONS[reflection]
|
51
|
+
SidekiqUniqueJobs::Deprecation.warn(
|
52
|
+
"#{reflection} is deprecated and will be removed in version #{removal_version}. Use #{replacement} instead.",
|
53
|
+
)
|
54
|
+
end
|
55
|
+
elsif misconfigured?(reflection)
|
56
|
+
raise NoSuchNotificationError, reflection
|
57
|
+
end
|
58
|
+
end
|
59
|
+
|
60
|
+
def configured?(reflection)
|
61
|
+
REFLECTIONS.include?(reflection)
|
62
|
+
end
|
63
|
+
|
64
|
+
def misconfigured?(reflection)
|
65
|
+
!configured?(reflection)
|
66
|
+
end
|
67
|
+
end
|
68
|
+
end
|