resque-unique_in_queue 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 32f50a9af11ff498a110d4a93549fbb653c2d471252bde302e50c8b7d30eb5f2
+  data.tar.gz: 5913f22ba7c2c23666833c86200d181431b2e4f2c9827e363bee62d8dbca18a2
+SHA512:
+  metadata.gz: f2905f2489519bff3cd7424827fb67d6ef24bfaba5e164d0c539ebb986c2174d4d8fd38a4e5433447bc171a1313de44a82c9129662e0bfcb0c64ada21fb5868d
+  data.tar.gz: 8bda5be739bb307679330cf658d5e8865dedc6295af8d7ec657ac6982d5d4ac1ff394cd943070240d8d8c79c5504d3d7b1431645820c338e8fb67c8666c50633

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rubocop.yml

@@ -0,0 +1,2 @@
+inherit_from: .rubocop_todo.yml
+TargetRubyVersion: 2.5

data/.rubocop_todo.yml

@@ -0,0 +1,91 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2018-11-07 04:05:15 -0800 using RuboCop version 0.60.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 1
+# Configuration parameters: Include.
+# Include: **/*.gemspec
+Gemspec/DuplicatedAssignment:
+  Exclude:
+    - 'resque-unique_in_queue.gemspec'
+
+# Offense count: 1
+# Configuration parameters: Include.
+# Include: **/*.gemspec
+Gemspec/RequiredRubyVersion:
+  Exclude:
+    - 'resque-unique_in_queue.gemspec'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyleAlignWith, AutoCorrect, Severity.
+# SupportedStylesAlignWith: start_of_line, def
+Layout/DefEndAlignment:
+  Exclude:
+    - 'lib/resque/unique_in_queue/queue.rb'
+
+# Offense count: 1
+Lint/HandleExceptions:
+  Exclude:
+    - 'test/test_helper.rb'
+
+# Offense count: 2
+# Configuration parameters: CountComments, ExcludedMethods.
+Metrics/MethodLength:
+  Max: 11
+
+# Offense count: 1
+# Configuration parameters: ExpectMatchingDefinition, Regex, IgnoreExecutableScripts, AllowedAcronyms.
+# AllowedAcronyms: CLI, DSL, ACL, API, ASCII, CPU, CSS, DNS, EOF, GUID, HTML, HTTP, HTTPS, ID, IP, JSON, LHS, QPS, RAM, RHS, RPC, SLA, SMTP, SQL, SSH, TCP, TLS, TTL, UDP, UI, UID, UUID, URI, URL, UTF8, VM, XML, XMPP, XSRF, XSS
+Naming/FileName:
+  Exclude:
+    - 'lib/resque-unique_in_queue.rb'
+
+# Offense count: 1
+# Configuration parameters: NamePrefix, NamePrefixBlacklist, NameWhitelist, MethodDefinitionMacros.
+# NamePrefix: is_, has_, have_
+# NamePrefixBlacklist: is_, has_, have_
+# NameWhitelist: is_a?
+# MethodDefinitionMacros: define_method, define_singleton_method
+Naming/PredicateName:
+  Exclude:
+    - 'spec/**/*'
+    - 'lib/resque/unique_in_queue/queue.rb'
+
+# Offense count: 4
+# Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
+# AllowedNames: io, id, to, by, on, in, at, ip, db
+Naming/UncommunicativeMethodParamName:
+  Exclude:
+    - 'test/fake_jobs.rb'
+
+# Offense count: 6
+Style/Documentation:
+  Exclude:
+    - 'spec/**/*'
+    - 'test/**/*'
+    - 'lib/resque-unique_in_queue.rb'
+    - 'lib/resque/plugins/unique_in_queue.rb'
+    - 'lib/resque/unique_in_queue/configuration.rb'
+    - 'lib/resque/unique_in_queue/queue.rb'
+    - 'lib/resque/unique_in_queue/resque_ext/job.rb'
+    - 'lib/resque/unique_in_queue/resque_ext/resque.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: AutoCorrect, EnforcedStyle, IgnoredMethods.
+# SupportedStyles: predicate, comparison
+Style/NumericPredicate:
+  Exclude:
+    - 'spec/**/*'
+    - 'lib/resque/unique_in_queue/queue.rb'
+
+# Offense count: 26
+# Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, IgnoredPatterns.
+# URISchemes: http, https
+Metrics/LineLength:
+  Max: 116

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.5.1

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+sudo: false
+cache: bundler
+rvm:
+  - 2.4.0
+  - 2.3.3
+  - 2.2.6

data/Gemfile

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
+
+group :test do
+  unless ENV['TRAVIS']
+    gem 'byebug', '~> 10', platform: :mri, require: false
+    gem 'pry', '~> 0', platform: :mri, require: false
+    gem 'pry-byebug', '~> 3', platform: :mri, require: false
+  end
+  gem 'rubocop', '~> 0.60.0'
+  gem 'simplecov', '~> 0', require: false
+end
+
+# Specify your gem's dependencies in resque-unique_in_queue.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,24 @@
+Copyright (c) 2010 Moviepilot GmbH http://moviepilot.com
+Copyright (c) 2013 Neighborland, Inc.
+Copyright (c) 2017 - 2018 Peter H. Boling
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,158 @@
+# Resque::UniqueInQueue
+
+| Project                 |  Resque::UniqueInQueue |
+|------------------------ | ----------------------- |
+| gem name                |  [resque-unique_in_queue](https://rubygems.org/gems/resque-unique_in_queue) |
+| license                 |  [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) |
+| download rank           |  [![Downloads Today](https://img.shields.io/gem/rd/resque-unique_in_queue.svg)](https://github.com/pboling/resque-unique_in_queue) |
+| version                 |  [![Version](https://img.shields.io/gem/v/resque-unique_in_queue.svg)](https://rubygems.org/gems/resque-unique_in_queue) |
+| dependencies            |  [![Depfu](https://badges.depfu.com/badges/25c6e1e4c671926e9adea898f2df9a47/count.svg)](https://depfu.com/github/pboling/resque-unique_in_queue?project_id=2729) |
+| continuous integration  |  [![Build Status](https://travis-ci.org/pboling/resque-unique_in_queue.svg?branch=master)](https://travis-ci.org/pboling/resque-unique_in_queue) |
+| test coverage           |  [![Test Coverage](https://api.codeclimate.com/v1/badges/7520df3968eb146c8894/test_coverage)](https://codeclimate.com/github/pboling/resque-unique_in_queue/test_coverage) |
+| maintainability         |  [![Maintainability](https://api.codeclimate.com/v1/badges/7520df3968eb146c8894/maintainability)](https://codeclimate.com/github/pboling/resque-unique_in_queue/maintainability) |
+| code triage             |  [![Open Source Helpers](https://www.codetriage.com/pboling/resque-unique_in_queue/badges/users.svg)](https://www.codetriage.com/pboling/resque-unique_in_queue) |
+| homepage                |  [on Github.com][homepage], [on Railsbling.com][blogpage] |
+| documentation           |  [on RDoc.info][documentation] |
+| Spread ~♡ⓛⓞⓥⓔ♡~      |  [🌍 🌎 🌏](https://about.me/peter.boling), [🍚](https://www.crowdrise.com/helprefugeeswithhopefortomorrowliberia/fundraiser/peterboling), [➕](https://plus.google.com/+PeterBoling/posts), [👼](https://angel.co/peter-boling), [🐛](https://www.topcoder.com/members/pboling/), [:shipit:](http://coderwall.com/pboling), [![Tweet Peter](https://img.shields.io/twitter/follow/galtzo.svg?style=social&label=Follow)](http://twitter.com/galtzo) |
+
+Resque::UniqueInQueue is a resque plugin to add unique jobs to resque.
+
+It is a re-write of [resque-loner](https://github.com/jayniz/resque-loner).
+
+It requires resque 1.25 and works with ruby 2.0 and later.
+
+It removes the dependency on `Resque::Helpers`, which is deprecated for resque 2.0.
+
+## Install
+
+Add the gem to your Gemfile:
+
+```ruby
+gem 'resque-unique_in_queue'
+```
+
+## Usage
+
+```ruby
+class UpdateCat
+  include Resque::Plugins::UniqueJob
+  @queue = :cats
+
+  def self.perform(cat_id)
+    # do something
+  end
+end
+```
+
+If you attempt to queue a unique job multiple times, it is ignored:
+
+```
+Resque.enqueue UpdateCat, 1
+=> true
+Resque.enqueue UpdateCat, 1
+=> nil
+Resque.enqueue UpdateCat, 1
+=> nil
+Resque.size :cats
+=> 1
+Resque.enqueued? UpdateCat, 1
+=> true
+Resque.enqueued_in? :dogs, UpdateCat, 1
+=> false
+```
+
+### Options
+
+#### `lock_after_execution_period`
+
+By default, lock_after_execution_period is 0 and `enqueued?` becomes false as soon as the job
+is being worked on.
+
+The `lock_after_execution_period` setting can be used to delay when the unique job key is deleted
+(i.e. when `enqueued?` becomes `false`). For example, if you have a long-running unique job that
+takes around 10 seconds, and you don't want to requeue another job until you are sure it is done,
+you could set `lock_after_execution_period = 20`. Or if you never want to run a long running
+job more than once per minute, set `lock_after_execution_period = 60`.
+
+```ruby
+class UpdateCat
+  include Resque::Plugins::UniqueJob
+  @queue = :cats
+  @lock_after_execution_period = 20
+
+  def self.perform(cat_id)
+    # do something
+  end
+end
+```
+
+#### Oops, I have stale Queue Time uniqueness keys...
+ 
+Preventing jobs with matching signatures from being queued, and they never get
+dequeued because there is no actual corresponding job to dequeue.
+
+*How to deal?*
+
+Option: Rampage
+
+```ruby
+# Delete *all* queued jobs in the queue, and
+#   delete *all* unqueness keys for the queue.
+Redis.remove_queue('queue_name')
+```
+
+Option: Butterfly
+
+```ruby
+# Delete *no* queued jobs at all, and
+#   delete *all* unqueness keys for the queue (might then allow duplicates).
+Resque::UniqueInQueue::Queue.cleanup('queue_name')
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/pboling/resque-unique_in_queue. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## Code of Conduct
+
+Everyone interacting in the Resque::Plugins::UniqueInQueue project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/pboling/resque-unique_in_queue/blob/master/CODE_OF_CONDUCT.md).
+
+## Versioning
+
+This library aims to adhere to [Semantic Versioning 2.0.0][semver].
+Violations of this scheme should be reported as bugs. Specifically,
+if a minor or patch version is released that breaks backward
+compatibility, a new version should be immediately released that
+restores compatibility. Breaking changes to the public API will
+only be introduced with new major versions.
+
+As a result of this policy, you can (and should) specify a
+dependency on this gem using the [Pessimistic Version Constraint][pvc] with two digits of precision.
+
+For example:
+
+```ruby
+spec.add_dependency 'resque-unique_in_queue', '~> 1.0'
+```
+
+## License
+
+* Copyright (c) 2012 Jonathan R. Wallace
+* Copyright (c) 2017 - 2018 [Peter H. Boling][peterboling] of [Rails Bling][railsbling]
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) 
+
+[license]: LICENSE
+[semver]: http://semver.org/
+[pvc]: http://guides.rubygems.org/patterns/#pessimistic-version-constraint
+[railsbling]: http://www.railsbling.com
+[peterboling]: http://www.peterboling.com
+[documentation]: http://rdoc.info/github/pboling/resque-unique_in_queue/frames
+[homepage]: https://github.com/pboling/resque-unique_in_queue/
+[blogpage]: http://www.railsbling.com/tags/resque-unique_in_queue/

data/Rakefile

@@ -0,0 +1,14 @@
+#!/usr/bin/env rake
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+desc 'Run tests'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+task default: :test

data/lib/resque-unique_in_queue.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require 'resque/unique_in_queue/version'
+
+# Ruby Std Lib
+require 'digest/md5'
+
+# External Gems
+require 'colorized_string'
+require 'resque'
+
+# This Gem
+require 'resque/plugins/unique_in_queue'
+require 'resque/unique_in_queue/resque_ext/job'
+require 'resque/unique_in_queue/resque_ext/resque'
+require 'resque/unique_in_queue/queue'
+require 'resque/unique_in_queue/configuration'
+
+# See lib/resque/plugins/unique_in_queue.rb for the actual plugin
+#
+# This is not that ^.  Rather, it is an API used by the plugin or as tools by a
+#   developer.  These methods are not intended to be included/extended into
+#   Resque, Resque::Job, or Resque::Queue.
+module Resque
+  module UniqueInQueue
+    PLUGIN_TAG = (ColorizedString['[R-UIQ] '].blue).freeze
+
+    def in_queue_unique_log(message, config_proxy = nil)
+      config_proxy ||= uniqueness_configuration
+      config_proxy.unique_logger&.send(config_proxy.unique_log_level, message) if config_proxy.unique_logger
+    end
+
+    def in_queue_unique_debug(message, config_proxy = nil)
+      config_proxy ||= uniqueness_configuration
+      config_proxy.unique_logger&.debug("#{PLUGIN_TAG}#{message}") if config_proxy.debug_mode
+    end
+
+    # There are times when the class will need access to the configuration object,
+    #   such as to override it per instance method
+    def uniq_config
+      @uniqueness_configuration
+    end
+
+    # For per-class config with a block
+    def uniqueness_configure
+      @uniqueness_configuration ||= Configuration.new
+      yield(@uniqueness_configuration)
+    end
+
+    #### CONFIG ####
+    class << self
+      attr_accessor :uniqueness_configuration
+    end
+    def uniqueness_config_reset(config = Configuration.new)
+      @uniqueness_configuration = config
+    end
+
+    def uniqueness_log_level
+      @uniqueness_configuration.log_level
+    end
+
+    def uniqueness_log_level=(log_level)
+      @uniqueness_configuration.log_level = log_level
+    end
+
+    self.uniqueness_configuration = Configuration.new # setup defaults
+
+    module_function(:in_queue_unique_log,
+                    :in_queue_unique_debug,
+                    :uniq_config,
+                    :uniqueness_configure,
+                    :uniqueness_config_reset,
+                    :uniqueness_log_level,
+                    :uniqueness_log_level=)
+  end
+end

data/lib/resque/plugins/unique_in_queue.rb

@@ -0,0 +1,72 @@
+module Resque
+  module Plugins
+    # If you want your job to support uniqueness at enqueue-time, simply include
+    #   this module into your job class.
+    #
+    #   class EnqueueAlone
+    #     @queue = :enqueue_alone
+    #     include Resque::Plugins::UniqueInQueue
+    #
+    #     def self.perform(arg1, arg2)
+    #       alone_stuff
+    #     end
+    #   end
+    #
+    module UniqueInQueue
+      def self.included(base)
+        base.extend ClassMethods
+      end
+
+      module ClassMethods
+        def unique_in_queue_redis_key(queue, item)
+          "#{unique_in_queue_key_base}:queue:#{queue}:job:#{Resque::UniqueInQueue::Queue.const_for(item).redis_key(item)}"
+        end
+
+        # Payload is what Resque stored for this job along with the job's class name:
+        # a hash containing string keys 'class' and 'args'
+        def redis_key(payload)
+          payload = Resque.decode(Resque.encode(payload))
+          job  = payload['class']
+          args = payload['args']
+          args.map! do |arg|
+            arg.is_a?(Hash) ? arg.sort : arg
+          end
+
+          Digest::MD5.hexdigest Resque.encode(class: job, args: args)
+        end
+
+        # The default ttl of a locking key is -1 (forever).
+        # To expire the lock after a certain amount of time, set a ttl (in seconds).
+        # For example:
+        #
+        # class FooJob
+        #   include Resque::Plugins::UniqueJob
+        #   @ttl = 40
+        # end
+        def ttl
+          @ttl ||= Resque::UniqueInQueue.uniq_config&.ttl
+        end
+
+        # The default ttl of a persisting key is 0, i.e. immediately deleted.
+        # Set lock_after_execution_period to block the execution
+        # of the job for a certain amount of time (in seconds).
+        # For example:
+        #
+        # class FooJob
+        #   include Resque::Plugins::UniqueJob
+        #   @lock_after_execution_period = 40
+        # end
+        def lock_after_execution_period
+          @lock_after_execution_period ||= Resque::UniqueInQueue.uniq_config&.lock_after_execution_period
+        end
+
+        # Can't be overridden per each class because it wouldn't make sense.
+        # It wouldn't be able to determine or enforce uniqueness across queues,
+        #   and general cleanup of stray keys would be nearly impossible.
+        def unique_in_queue_key_base
+          Resque::UniqueInQueue.uniq_config&.unique_in_queue_key_base
+        end
+      end
+    end
+  end
+end

data/lib/resque/unique_in_queue/configuration.rb

@@ -0,0 +1,49 @@
+require 'logger'
+module Resque
+  module UniqueInQueue
+    class Configuration
+      DEFAULT_IN_QUEUE_KEY_BASE = 'r-uiq'.freeze
+      DEFAULT_LOCK_AFTER_EXECUTION_PERIOD = 0
+      DEFAULT_TTL = -1
+
+      attr_accessor :logger,
+                    :log_level,
+                    :unique_in_queue_key_base,
+                    :lock_after_execution_period,
+                    :ttl,
+                    :debug_mode
+      def initialize(**options)
+        @logger = options.key?(:logger) ? options[:logger] : Logger.new(STDOUT)
+        @log_level = options.key?(:log_level) ? options[:log_level] : :debug
+
+        # Can't be set per job:
+        @unique_in_queue_key_base = options.key?(:unique_in_queue_key_base) ? options[:unique_in_queue_key_base] : DEFAULT_IN_QUEUE_KEY_BASE
+
+        # Can be set per each job:
+        @lock_after_execution_period = options.key?(:lock_after_execution_period) ? options[:lock_after_execution_period] : DEFAULT_LOCK_AFTER_EXECUTION_PERIOD
+        @ttl = options.key?(:ttl) ? options[:ttl] : DEFAULT_TTL
+        env_debug = ENV['RESQUE_DEBUG']
+        @debug_mode = options.key?(:debug_mode) ? options[:debug_mode] : env_debug == 'true' || (env_debug.is_a?(String) && env_debug.match?(/in_queue/))
+      end
+
+      def unique_logger
+        logger
+      end
+
+      def unique_log_level
+        log_level
+      end
+
+      def log(msg)
+        Resque::UniqueInQueue.in_queue_unique_log(msg, self)
+      end
+
+      def to_hash
+        {
+          logger: logger,
+          log_level: log_level
+        }
+      end
+    end
+  end
+end

data/lib/resque/unique_in_queue/queue.rb

@@ -0,0 +1,90 @@
+module Resque
+  module UniqueInQueue
+    module Queue
+      def queued?(queue, item)
+        return false unless is_unique?(item)
+
+        redis.get(unique_key(queue, item)) == '1'
+      end
+
+      def mark_queued(queue, item)
+        return unless is_unique?(item)
+
+        key = unique_key(queue, item)
+        redis.set(key, 1)
+        ttl = item_ttl(item)
+        redis.expire(key, ttl) if ttl >= 0
+      end
+
+      def mark_unqueued(queue, job)
+        item = job.is_a?(Resque::Job) ? job.payload : job
+        return unless is_unique?(item)
+
+        ttl = lock_after_execution_period(item)
+        if ttl == 0
+          redis.del(unique_key(queue, item))
+        else
+          redis.expire(unique_key(queue, item), ttl)
+        end
+      end
+
+      def unique_key(queue, item)
+        const_for(item).unique_in_queue_redis_key(queue, item)
+      end
+
+      def is_unique?(item)
+        const_for(item).included_modules.include?(::Resque::Plugins::UniqueInQueue)
+      rescue NameError
+        false
+      end
+
+      def item_ttl(item)
+        const_for(item).ttl
+      rescue NameError
+        -1
+      end
+
+      def lock_after_execution_period(item)
+        const_for(item).lock_after_execution_period
+      rescue NameError
+        0
+      end
+
+      def destroy(queue, klass, *args)
+        klass = klass.to_s
+        redis_queue = "queue:#{queue}"
+
+        redis.lrange(redis_queue, 0, -1).each do |string|
+          json = Resque.decode(string)
+          next unless json['class'] == klass
+          next if args.any? && json['args'] != args
+
+          Resque::UniqueInQueue::Queue.mark_unqueued(queue, json)
+        end
+      end
+
+      def cleanup(queue)
+        keys = redis.keys("#{Resque::UniqueInQueue.uniq_config&.unique_in_queue_key_base}:queue:#{queue}:job:*")
+        redis.del(*keys) if keys.any?
+      end
+
+      private
+
+      def redis
+        Resque.redis
+      end
+
+      def item_class(item)
+        item[:class] || item['class']
+      end
+
+      def const_for(item)
+        Resque.constantize(item_class(item))
+        end
+
+      module_function :queued?, :mark_queued, :mark_unqueued, :unique_key
+      module_function :is_unique?, :item_ttl, :lock_after_execution_period
+      module_function :destroy, :cleanup, :redis, :item_class, :const_for
+    end
+  end
+end

data/lib/resque/unique_in_queue/resque_ext/job.rb

@@ -0,0 +1,64 @@
+module Resque
+  class Job
+    class << self
+      # Mark an item as queued
+      def create_unique_in_queue(queue, klass, *args)
+        item = { class: klass.to_s, args: args }
+        if Resque.inline? || !Resque::UniqueInQueue::Queue.is_unique?(item)
+          return create_without_unique_in_queue(queue, klass, *args)
+        end
+        return 'EXISTED' if Resque::UniqueInQueue::Queue.queued?(queue, item)
+
+        create_return_value = false
+        # redis transaction block
+        Resque.redis.multi do
+          create_return_value = create_without_unique_in_queue(queue, klass, *args)
+          Resque::UniqueInQueue::Queue.mark_queued(queue, item)
+        end
+        create_return_value
+      end
+
+      # Mark an item as unqueued
+      def reserve_unique_in_queue(queue)
+        item = reserve_without_unique_in_queue(queue)
+        Resque::UniqueInQueue::Queue.mark_unqueued(queue, item) if item && !Resque.inline?
+        item
+      end
+
+      # Mark destroyed jobs as unqueued
+      def destroy_unique_in_queue(queue, klass, *args)
+        Resque::UniqueInQueue::Queue.destroy(queue, klass, *args) unless Resque.inline?
+        destroy_without_unique_in_queue(queue, klass, *args)
+      end
+
+      alias create_without_unique_in_queue create
+      alias create create_unique_in_queue
+      alias reserve_without_unique_in_queue reserve
+      alias reserve reserve_unique_in_queue
+      alias destroy_without_unique_in_queue destroy
+      alias destroy destroy_unique_in_queue
+
+      if defined?(Resque::Plugins::PriorityEnqueue::Resque)
+        # Hack to support resque-priority_enqueue: https://github.com/coupa/resque-priority_enqueue
+        def priority_create_unique_in_queue(queue, klass, *args)
+          item = { class: klass.to_s, args: args }
+          if Resque.inline? || !Resque::UniqueInQueue::Queue.is_unique?(item)
+            return priority_create_without_unique_in_queue(queue, klass, *args)
+          end
+          return 'EXISTED' if Resque::UniqueInQueue::Queue.queued?(queue, item)
+
+          priority_create_return_value = false
+          # redis transaction block
+          Resque.redis.multi do
+            priority_create_return_value = priority_create_without_unique_in_queue(queue, klass, *args)
+            Resque::UniqueInQueue::Queue.mark_queued(queue, item)
+          end
+          priority_create_return_value
+        end
+
+        alias priority_create_without_unique_in_queue priority_create
+        alias priority_create priority_create_unique_in_queue
+      end
+    end
+  end
+end

data/lib/resque/unique_in_queue/resque_ext/resque.rb

@@ -0,0 +1,41 @@
+module Resque
+  class << self
+    # Override
+    # https://github.com/resque/resque/blob/master/lib/resque.rb
+    def enqueue_to(queue, klass, *args)
+      # Perform before_enqueue hooks. Don't perform enqueue if any hook returns false
+      before_hooks = Plugin.before_enqueue_hooks(klass).collect do |hook|
+        klass.send(hook, *args)
+      end
+      return nil if before_hooks.any? { |result| result == false }
+
+      result = Job.create(queue, klass, *args)
+      return nil if result == 'EXISTED'
+
+      Plugin.after_enqueue_hooks(klass).each do |hook|
+        klass.send(hook, *args)
+      end
+
+      true
+    end
+
+    def enqueued?(klass, *args)
+      enqueued_in?(queue_from_class(klass), klass, *args)
+    end
+
+    def enqueued_in?(queue, klass, *args)
+      item = { class: klass.to_s, args: args }
+      return nil unless Resque::UniqueInQueue::Queue.is_unique?(item)
+
+      Resque::UniqueInQueue::Queue.queued?(queue, item)
+    end
+
+    def remove_queue_with_unique_in_queue_cleanup(queue)
+      remove_queue_without_unique_in_queue_cleanup(queue)
+      Resque::UniqueInQueue::Queue.cleanup(queue)
+    end
+
+    alias remove_queue_without_unique_in_queue_cleanup remove_queue
+    alias remove_queue remove_queue_with_unique_in_queue_cleanup
+  end
+end

data/lib/resque/unique_in_queue/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Resque
+  module UniqueInQueue
+    VERSION = '1.0.0'.freeze
+  end
+end

data/resque-unique_in_queue.gemspec

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require File.expand_path('lib/resque/unique_in_queue/version', __dir__)
+
+Gem::Specification.new do |spec|
+  spec.name          = 'resque-unique_in_queue'
+  spec.version       = Resque::UniqueInQueue::VERSION
+  spec.authors       = ['Peter H. Boling', 'Tee Parham']
+  spec.email         = %w[peter.boling@gmail.com]
+  spec.license       = 'MIT'
+
+  spec.summary       = 'A resque plugin that ensures job uniqueness at enqueue time.'
+  spec.summary       = 'A resque plugin that ensures job uniqueness at enqueue time.'
+  spec.homepage      = 'https://github.com/pboling/resque-unique_in_queue'
+  spec.required_ruby_version = '>= 2.3.0'
+
+  spec.files = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_runtime_dependency 'colorize', '~> 0.8'
+  spec.add_runtime_dependency 'resque', '>= 1.2'
+
+  spec.add_development_dependency 'bundler', '~> 1.16'
+  spec.add_development_dependency 'byebug', '~> 10.0'
+  spec.add_development_dependency 'fakeredis', '~> 0.7'
+  spec.add_development_dependency 'minitest', '~> 5.11'
+  spec.add_development_dependency 'pry', '~> 0.11'
+  spec.add_development_dependency 'pry-byebug', '~> 3.6'
+  spec.add_development_dependency 'rake', '~> 12.3'
+  spec.add_development_dependency 'rubocop', '~> 0.60'
+end

metadata

@@ -0,0 +1,202 @@
+--- !ruby/object:Gem::Specification
+name: resque-unique_in_queue
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Peter H. Boling
+- Tee Parham
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-11-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: resque
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: fakeredis
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.11'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.3'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.60'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.60'
+description: 
+email:
+- peter.boling@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
+- ".ruby-version"
+- ".travis.yml"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/resque-unique_in_queue.rb
+- lib/resque/plugins/unique_in_queue.rb
+- lib/resque/unique_in_queue/configuration.rb
+- lib/resque/unique_in_queue/queue.rb
+- lib/resque/unique_in_queue/resque_ext/job.rb
+- lib/resque/unique_in_queue/resque_ext/resque.rb
+- lib/resque/unique_in_queue/version.rb
+- resque-unique_in_queue.gemspec
+homepage: https://github.com/pboling/resque-unique_in_queue
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.7
+signing_key: 
+specification_version: 4
+summary: A resque plugin that ensures job uniqueness at enqueue time.
+test_files: []