pause 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 81a777526619b80e87ad3e11b6794c88634ea326cf34aad34ac70268517cdf4f
-  data.tar.gz: 17f95640fde2ddd98e6922b7cab715e8c7973b791a3e728c65f132265da55b78
+  metadata.gz: 24edf9a7ae6f6e5556c6dea257d89e8bfa5dd1a4b7115436162758bf259ca36d
+  data.tar.gz: 0f90ae2d8f9dd8678e3e1e8e9dbdbbfd0cbcde8cbf28cf35780924dc3e654b71
 SHA512:
-  metadata.gz: f46245fe1330897e8bf6dee18d32b8cc561849f59d5c6049bd45360b5614d27a7f0e0caf8494e93cd6266a733750cdd3aad2559508364c9ee7990493fb0934de
-  data.tar.gz: c9fc4e23661001591aac93c7427e9e98ac03e6d5e15da060c537f43ce47b1eca3ac65658004ffff7e5706a59b1c98e7b7236329c1cd722e4348f2741acbd5e8c
+  metadata.gz: 2b2a54352c815d7c884a64b9953b0ea053b267903d667cceb0503e82756e4459ba766789e1fb85a5f6f079c7d9095aa720f35b464b051da7bc3818058073d91e
+  data.tar.gz: 2a9a41a61e6402516d0f243189af152d170decd6f5e5c5831b2b5d5758d243fe02ab4840e25237b18a557be081819264ed84e70ba1ffa7e524f49a36bd7bae3a

data/.github/workflows/rspec.yml

@@ -0,0 +1,31 @@
+name: RSpec
+
+on:
+  pull_request:
+  push: { branches: [master] }
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby-version: [3.4.1, 3.3.6, 3.2.6, 3.1.6]
+    env:
+      RUBY_LATEST_VERSION: "3.4.1"
+      RUBY_VERSION: ${{ matrix.ruby-version }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby ${{ matrix.ruby-version }}
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+
+      - name: Bundle Install
+        run: |
+          bundle check || bundle install -j 4
+
+      - name: Run Rubocop
+        run: |
+          bundle exec rspec --format progress -p1

data/.github/workflows/rubocop.yml

@@ -0,0 +1,31 @@
+name: Rubocop
+
+on:
+  pull_request:
+  push: { branches: [master] }
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby-version: [3.4.1, 3.3.6, 3.2.6, 3.1.6]
+    env:
+      RUBY_LATEST_VERSION: "3.4.1"
+      RUBY_VERSION: ${{ matrix.ruby-version }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby ${{ matrix.ruby-version }}
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+
+      - name: Bundle Install
+        run: |
+          bundle check || bundle install -j 4
+
+      - name: Run Rubocop
+        run: |
+          bundle exec rubocop --parallel --format progress

data/.gitignore

@@ -3,7 +3,6 @@
 .bundle
 .config
 .yardoc
-Gemfile.lock
 InstalledFiles
 _yardoc
 coverage

data/.rubocop.yml

@@ -0,0 +1,28 @@
+require:
+  - rubocop-rake
+  - rubocop-rspec
+
+inherit_from: .rubocop_todo.yml
+
+# The behavior of RuboCop can be controlled via the .rubocop.yml
+# configuration file. It makes it possible to enable/disable
+# certain cops (checks) and to alter their behavior if they accept
+# any parameters. The file can be placed either in your home
+# directory or in some project directory.
+#
+# RuboCop will start looking for the configuration file in the directory
+# where the inspected file is and continue its way up to the root directory.
+#
+# See https://docs.rubocop.org/rubocop/configuration
+#
+AllCops:
+  NewCops: enable
+
+RSpec/MultipleMemoizedHelpers:
+  Enabled: false
+
+RSpec/ExampleLength:
+  Enabled: false
+
+RSpec/MultipleExpectations:
+  Enabled: false

data/.rubocop_todo.yml

@@ -0,0 +1,192 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2025-02-07 21:04:05 UTC using RuboCop version 1.71.2.
+# 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: Severity, Include.
+# Include: **/*.gemspec
+Gemspec/RequiredRubyVersion:
+  Exclude:
+    - 'pause.gemspec'
+
+# Offense count: 9
+# Configuration parameters: AllowedMethods.
+# AllowedMethods: enums
+Lint/ConstantDefinitionInBlock:
+  Exclude:
+    - 'spec/pause/action_spec.rb'
+    - 'spec/pause/analyzer_spec.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedParentClasses.
+Lint/MissingSuper:
+  Exclude:
+    - 'lib/pause/action.rb'
+
+# Offense count: 1
+Lint/StructNewOverride:
+  Exclude:
+    - 'lib/pause.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
+Metrics/AbcSize:
+  Max: 33
+
+# Offense count: 1
+# Configuration parameters: CountComments, CountAsOne.
+Metrics/ClassLength:
+  Max: 108
+
+# Offense count: 1
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Max: 16
+
+# Offense count: 1
+# Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
+# AllowedNames: as, at, by, cc, db, id, if, in, io, ip, of, on, os, pp, to
+Naming/MethodParameterName:
+  Exclude:
+    - 'lib/pause/redis/adapter.rb'
+
+# Offense count: 1
+RSpec/AnyInstance:
+  Exclude:
+    - 'spec/pause/action_spec.rb'
+
+# Offense count: 7
+# Configuration parameters: Prefixes, AllowedPatterns.
+# Prefixes: when, with, without
+RSpec/ContextWording:
+  Exclude:
+    - 'spec/pause/action_spec.rb'
+    - 'spec/pause/pause_spec.rb'
+    - 'spec/pause/redis/adapter_spec.rb'
+
+# Offense count: 1
+RSpec/DescribeMethod:
+  Exclude:
+    - 'spec/pause/action_spec.rb'
+
+# Offense count: 15
+# Configuration parameters: CountAsOne.
+RSpec/ExampleLength:
+  Max: 14
+
+# Offense count: 10
+RSpec/ExpectInHook:
+  Exclude:
+    - 'spec/pause/action_spec.rb'
+    - 'spec/pause/logger_spec.rb'
+    - 'spec/pause/redis/adapter_spec.rb'
+
+# Offense count: 10
+RSpec/LeakyConstantDeclaration:
+  Exclude:
+    - 'spec/pause/action_spec.rb'
+    - 'spec/pause/analyzer_spec.rb'
+
+# Offense count: 10
+# Configuration parameters: .
+# SupportedStyles: have_received, receive
+RSpec/MessageSpies:
+  EnforcedStyle: receive
+
+# Offense count: 1
+RSpec/MultipleDescribes:
+  Exclude:
+    - 'spec/pause/action_spec.rb'
+
+# Offense count: 24
+RSpec/MultipleExpectations:
+  Max: 6
+
+# Offense count: 26
+# Configuration parameters: AllowSubject.
+RSpec/MultipleMemoizedHelpers:
+  Max: 10
+
+# Offense count: 14
+# Configuration parameters: EnforcedStyle, IgnoreSharedExamples.
+# SupportedStyles: always, named_only
+RSpec/NamedSubject:
+  Exclude:
+    - 'spec/pause/configuration_spec.rb'
+
+# Offense count: 2
+# Configuration parameters: AllowedGroups.
+RSpec/NestedGroups:
+  Max: 4
+
+# Offense count: 5
+# Configuration parameters: AllowedPatterns.
+# AllowedPatterns: ^expect_, ^assert_
+RSpec/NoExpectationExample:
+  Exclude:
+    - 'spec/pause/action_spec.rb'
+    - 'spec/pause/logger_spec.rb'
+    - 'spec/pause/redis/adapter_spec.rb'
+
+# Offense count: 1
+RSpec/PendingWithoutReason:
+  Exclude:
+    - 'spec/pause/redis/adapter_spec.rb'
+
+# Offense count: 4
+# This cop supports unsafe autocorrection (--autocorrect-all).
+RSpec/ReceiveMessages:
+  Exclude:
+    - 'spec/pause/action_spec.rb'
+
+# Offense count: 4
+RSpec/RepeatedDescription:
+  Exclude:
+    - 'spec/pause/action_spec.rb'
+
+# Offense count: 1
+# Configuration parameters: Include, CustomTransform, IgnoreMethods, IgnoreMetadata.
+# Include: **/*_spec.rb
+RSpec/SpecFilePathFormat:
+  Exclude:
+    - '**/spec/routing/**/*'
+    - 'spec/pause/configuration_spec.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+Rake/Desc:
+  Exclude:
+    - 'Rakefile'
+
+# Offense count: 6
+# Configuration parameters: AllowedConstants.
+Style/Documentation:
+  Exclude:
+    - 'spec/**/*'
+    - 'test/**/*'
+    - 'lib/pause.rb'
+    - 'lib/pause/action.rb'
+    - 'lib/pause/analyzer.rb'
+    - 'lib/pause/configuration.rb'
+    - 'lib/pause/helper/timing.rb'
+    - 'lib/pause/rate_limited_event.rb'
+
+# Offense count: 1
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: always, always_true, never
+Style/FrozenStringLiteralComment:
+  Exclude:
+    - '**/*.arb'
+    - 'spec/pause/action_spec.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 307

data/Gemfile

@@ -1,7 +1,22 @@
 #!/usr/bin/env ruby
-#^syntax detection
+# frozen_string_literal: true
+
+# ^syntax detection
 
 source 'https://rubygems.org'
 
+group :development, :test do
+  gem 'fakeredis'
+  gem 'guard-rspec'
+  gem 'rake'
+  gem 'rspec'
+  gem 'rubocop'
+  gem 'rubocop-rake'
+  gem 'rubocop-rspec'
+  gem 'simplecov'
+  gem 'timecop'
+  gem 'yard'
+end
+
 # Specify your gem's dependencies in pause.gemspec
 gemspec

data/Gemfile.lock

@@ -0,0 +1,145 @@
+PATH
+  remote: .
+  specs:
+    pause (0.5.0)
+      colored2
+      redis
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    coderay (1.1.3)
+    colored2 (4.0.3)
+    diff-lcs (1.5.1)
+    docile (1.4.1)
+    fakeredis (0.9.2)
+      redis (~> 4.8)
+    ffi (1.17.1)
+    ffi (1.17.1-aarch64-linux-gnu)
+    ffi (1.17.1-aarch64-linux-musl)
+    ffi (1.17.1-arm-linux-gnu)
+    ffi (1.17.1-arm-linux-musl)
+    ffi (1.17.1-arm64-darwin)
+    ffi (1.17.1-x86-linux-gnu)
+    ffi (1.17.1-x86-linux-musl)
+    ffi (1.17.1-x86_64-darwin)
+    ffi (1.17.1-x86_64-linux-gnu)
+    ffi (1.17.1-x86_64-linux-musl)
+    formatador (1.1.0)
+    guard (2.19.1)
+      formatador (>= 0.2.4)
+      listen (>= 2.7, < 4.0)
+      logger (~> 1.6)
+      lumberjack (>= 1.0.12, < 2.0)
+      nenv (~> 0.1)
+      notiffany (~> 0.0)
+      ostruct (~> 0.6)
+      pry (>= 0.13.0)
+      shellany (~> 0.0)
+      thor (>= 0.18.1)
+    guard-compat (1.2.1)
+    guard-rspec (4.7.3)
+      guard (~> 2.1)
+      guard-compat (~> 1.1)
+      rspec (>= 2.99.0, < 4.0)
+    json (2.9.1)
+    language_server-protocol (3.17.0.4)
+    listen (3.9.0)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
+    logger (1.6.5)
+    lumberjack (1.2.10)
+    method_source (1.1.0)
+    nenv (0.3.0)
+    notiffany (0.1.3)
+      nenv (~> 0.1)
+      shellany (~> 0.0)
+    ostruct (0.6.1)
+    parallel (1.26.3)
+    parser (3.3.7.1)
+      ast (~> 2.4.1)
+      racc
+    pry (0.15.2)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.2.1)
+    rb-fsevent (0.11.2)
+    rb-inotify (0.11.1)
+      ffi (~> 1.0)
+    redis (4.8.1)
+    regexp_parser (2.10.0)
+    rspec (3.13.0)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.3)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.2)
+    rubocop (1.71.2)
+      json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.38.0)
+      parser (>= 3.3.1.0)
+    rubocop-rake (0.6.0)
+      rubocop (~> 1.0)
+    rubocop-rspec (3.4.0)
+      rubocop (~> 1.61)
+    ruby-progressbar (1.13.0)
+    shellany (0.0.1)
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.13.1)
+    simplecov_json_formatter (0.1.4)
+    thor (1.3.2)
+    timecop (0.9.10)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
+    yard (0.9.37)
+
+PLATFORMS
+  aarch64-linux-gnu
+  aarch64-linux-musl
+  arm-linux-gnu
+  arm-linux-musl
+  arm64-darwin
+  ruby
+  x86-linux-gnu
+  x86-linux-musl
+  x86_64-darwin
+  x86_64-linux-gnu
+  x86_64-linux-musl
+
+DEPENDENCIES
+  fakeredis
+  guard-rspec
+  pause!
+  rake
+  rspec
+  rubocop
+  rubocop-rake
+  rubocop-rspec
+  simplecov
+  timecop
+  yard
+
+BUNDLED WITH
+   2.6.3

data/Guardfile

@@ -1,15 +1,16 @@
 #!/usr/bin/env ruby
-#^syntax detection
+# frozen_string_literal: true
+
+# ^syntax detection
 
 # A sample Guardfile
 # More info at https://github.com/guard/guard#readme
 
 guard 'rspec' do
-  watch(%r{^spanx\.gemspec}) { "spec"}
-  watch(%r{^lib/(.+)\.rb$}) { "spec" }
+  watch(/^spanx\.gemspec/) { 'spec' }
+  watch(%r{^lib/(.+)\.rb$}) { 'spec' }
 
   watch(%r{^spec/.+_spec\.rb$})
-  watch('spec/spec_helper.rb')  { "spec" }
-  watch(%r{spec/support/.*}) { "spec" }
+  watch('spec/spec_helper.rb') { 'spec' }
+  watch(%r{spec/support/.*}) { 'spec' }
 end
-

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2012 Wanelo, Inc
+Copyright © 2018 Konstantin Gredeskoul, Atasay Gokkaya, Eric Saxby, Paul Henry
 
 MIT License
 

data/README.md

@@ -1,7 +1,13 @@
-# Pause
 
-[![Gem Version](https://badge.fury.io/rb/pause.png)](http://badge.fury.io/rb/pause)
-[![Build Status](https://travis-ci.org/kigster/pause.svg?branch=master)](https://travis-ci.org/kigster/pause)
+[![RSpec](https://github.com/kigster/pause/actions/workflows/rspec.yml/badge.svg?style=for-the-badge)](https://github.com/kigster/pause/actions/workflows/rspec.yml)
+[![Rubocop](https://github.com/kigster/pause/actions/workflows/rubocop.yml/badge.svg?style=for-the-badge)](https://github.com/kigster/pause/actions/workflows/rubocop.yml)
+
+[![Gem Version](https://badge.fury.io/rb/pause@2x.png?icon=si%3Arubygems)](https://badge.fury.io/rb/pause)
+
+[![Downloads](https://img.shields.io/gem/dt/pause.svg?style=for-the-badge&color=0AF)](https://rubygems.org/gems/pause)
+[![License](https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge&color=0AF)](https://opensource.org/licenses/MIT)
+
+# Pause
 
 ## In a Nutshell
 
@@ -49,17 +55,21 @@ Pause.configure do |config|
   config.redis_host = '127.0.0.1'
   config.redis_port = 6379
   config.redis_db   = 1
-  
-  # aggregate all events into 10 minute blocks. 
-  # Larger blocks require less RAM and CPU, smaller blocks are more 
-  # computationally expensive.
-  config.resolution = 600
-       
-  # discard all events older than 1 day
-  config.history    = 86400   
+  config.resolution = 600     
+  config.history    = 7 * 86400  # discard events older than 7 days   
 end
 ```
 
+> NOTE: **resolution** is an setting that's key to understanding how Pause works. It represents the length of time during which similar events are aggregated into a Hash-like object, where the key is the identifier, and the value is the count within that period.
+> 
+> Because of this,
+>  
+>   * _Larger resolution requires less RAM and CPU and are faster to compute_
+>   * _Smaller resolution is more computationally expensive, but provides higher granularity_.
+>
+> The resolution setting must set to the smallest rate-limit period across all of your checks. Below it is set to 10 minutes, meaning that you can use Pause to **rate limit any event to no more than N times within a period of 10 minutes or more.**
+
+
 #### Define Rate Limited "Action"
 
 Next we must define the rate limited action based on the specification above. This is how easy it is:
@@ -69,13 +79,22 @@ module MyApp
   class UserNotificationLimiter < ::Pause::Action
     # this is a redis key namespace added to all data in this action
     scope 'un'  
-    check period_seconds:       120, max_allowed: 1
-    check period_seconds:     86400, max_allowed: 3
-    check period_seconds: 7 * 86400, max_allowed: 7
+    
+    check period_seconds: 120, 
+          max_allowed: 1, 
+          block_ttl: 240
+          
+    check period_seconds: 86400, 
+          max_allowed: 3
+          
+    check period_seconds: 7 * 86400, 
+          max_allowed: 7
   end
 end
 ```
 
+> NOTE: for each check, `block_ttl` defaults to `period_seconds`, and represents the duration of time the action will consider itself as "rate limited" after a particular check reaches the limit.  Note, that all actions will automatically leave the "rate limited" state after `block_ttl` seconds have passed.
+
 #### Perform operation, but only if the user is not rate-limited
 
 Now we simply instantiate this limiter by passing user ID (any unique identifier works). We can then ask the limiter, `ok?` or `rate_limited?`, or we can use two convenient methods that only execute enclosed block if the described condition is satisfied:
@@ -83,17 +102,18 @@ Now we simply instantiate this limiter by passing user ID (any unique identifier
 ```ruby
 class NotificationsWorker
   def perform(user_id)
-    limiter = MyApp::UserNotificationLimiter.new(user_id)
-    
-    limiter.unless_rate_limited do
-      user = User.find(user_id) 
-      user.send_push_notification!
-    end
-    
-    # You can also do something in case the user is rate limited:
-    limiter.if_rate_limited do |rate_limit_event|
-      Rails.logger.info("user #{user.id} has exceeded rate limit: #{rate_limit_event}") 
-    end
+    MyApp::UserNotificationLimiter.new(user_id) do 
+      unless_rate_limited do
+        # this block ONLY runs if rate limit is not reached
+        user = User.find(user_id) 
+        PushNotifications.new(user).send_push_notification!
+      end
+      
+      if_rate_limited do |rate_limit_event|
+        # this block ONLY runs if the action has reached it's rate limit.
+        Rails.logger.info("user #{user.id} has exceeded rate limit: #{rate_limit_event}") 
+      end
+    end   
   end
 end
 ```
@@ -301,9 +321,7 @@ Pause.configure do |config|
 end
 ```
 
-With this configuration, any Pause operation that we know is not supported by Twemproxy will raise
-`Pause::Redis::OperationNotSupported`. For instance, when sharding we are unable to get a list of all
-tracked identifiers.
+With this configuration, any Pause operation that we know is not supported by Twemproxy will raise `Pause::Redis::OperationNotSupported`. For instance, when sharding we are unable to get a list of all tracked identifiers.
 
 The action block list is implemented as a sorted set, so it should still be usable when sharding.
 
@@ -339,8 +357,10 @@ Want to make it better? Cool. Here's how:
 
 ## Authors
 
-This gem was written by Eric Saxby, Atasay Gokkaya and Konstantin Gredeskoul at Wanelo, Inc.
+ * This gem was written by Eric Saxby, Atasay Gokkaya and Konstantin Gredeskoul at Wanelo, Inc.
+ * It's been updated and refreshed by Konstantin Gredeskoul.
+
 
-Please see the LICENSE.txt file for further details.
+Please see the [LICENSE.txt](LICENSE.txt) file for further details.
 
 

data/Rakefile

@@ -1,10 +1,12 @@
+# frozen_string_literal: true
+
 require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 require 'yard'
 
 RSpec::Core::RakeTask.new(:spec)
 
-task :default => %w(spec:unit spec:integration)
+task default: %w[spec:unit spec:integration]
 
 namespace :spec do
   desc 'Run specs using fakeredis'
@@ -25,23 +27,22 @@ def shell(*args)
 end
 
 task :clean do
-  shell('rm -rf pkg/ tmp/ coverage/ doc/ ' )
+  shell('rm -rf pkg/ tmp/ coverage/ doc/ ')
 end
 
-task :gem => [:build] do
+task gem: [:build] do
   shell('gem install pkg/*')
 end
 
-task :permissions => [ :clean ] do
+task permissions: [:clean] do
   shell('chmod -v o+r,g+r * */* */*/* */*/*/* */*/*/*/* */*/*/*/*/*')
-  shell("find . -type d -exec chmod o+x,g+x {} \\;")
+  shell('find . -type d -exec chmod o+x,g+x {} \\;')
 end
 
-task :build => :permissions
+task build: :permissions
 
 YARD::Rake::YardocTask.new(:doc) do |t|
-  t.files = %w(lib/**/*.rb exe/*.rb - README.md LICENSE.txt)
-  t.options.unshift('--title','"Pause - Redis-backed Rate Limiter"')
-  t.after = ->() { exec('open doc/index.html') }
+  t.files = %w[lib/**/*.rb exe/*.rb - README.md LICENSE.txt]
+  t.options.unshift('--title', '"Pause - Redis-backed Rate Limiter"')
+  t.after = -> { exec('open doc/index.html') }
 end
-

data/bin/spec

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+
+retry-errors() {
+  sleep 1
+  bundle exec rspec --only-failures
+}
+
+specs() {
+  bundle exec rspec && \
+    PAUSE_REAL_REDIS=true bundle exec rspec
+}
+
+specs || retry-errors
+