loop_hard 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0699c1f2cb84e6b558a558c3b5c64c7b2f4be7df
+  data.tar.gz: 2287abde57b5ed965765ec8bd15612a04e694189
+SHA512:
+  metadata.gz: 43b6dec2d6259200b72f64d57751d3d37088843a734f0276d27a5e4d44953cff4b8d47de0056bf311e95942203d8e831a0edbd073948730e8b1928b7c1b14e9c
+  data.tar.gz: 0ab323b7a1402cd7c79c944a5059fa49cdbeef2521e3842749843516b7d427f5debe7d85f1440281474d5341f2e56f8f3c489a270e5a190f364c5afcfd130b5b

data/.gitignore

@@ -0,0 +1,7 @@
+.DS_Store
+.idea
+*.gem
+coverage
+Gemfile.lock
+.yardoc
+doc

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+  - "2.1.1"
+  - "2.1.5"
+  - "2.2.2"
+
+script: bundle exec rake test_with_coveralls

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in loop_hard.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Daniel Magliola
+
+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,130 @@
+# loop_hard
+
+[![Build Status](https://travis-ci.org/dmagliola/loop_hard.svg?branch=master)](https://travis-ci.org/dmagliola/loop_hard)
+[![Coverage Status](https://coveralls.io/repos/dmagliola/loop_hard/badge.svg?branch=master&service=github)](https://coveralls.io/github/dmagliola/loop_hard?branch=master)
+[![Code Climate](https://codeclimate.com/github/dmagliola/loop_hard/badges/gpa.svg)](https://codeclimate.com/github/dmagliola/loop_hard)
+[![Inline docs](http://inch-ci.org/github/dmagliola/loop_hard.svg?branch=master&style=flat)](http://inch-ci.org/github/dmagliola/loop_hard)
+[![Gem Version](https://badge.fury.io/rb/loop_hard.png)](http://badge.fury.io/rb/loop_hard)
+
+Add timeouts to your long-running loops, and response to signals gracefully.
+
+LoopHard allows you to have long-running worker loops that will stop after a while,
+and also stop if they get an external signal to stop (for example, if Sidekiq stops due to a USR1,
+or a TERM signal is trapped).
+
+Possible use cases:
+
+- You have a background job that runs every 10 minutes and loops through a bunch of records until there are none left.
+    Use `LoopHard.loop(timeout: 9.5.minutes)` to generally prevent overlapping.
+- You don't have a time limit, but you're running a long job inside Sidekiq, and you want to exit gracefully when
+    Sidekiq decides it's terminating (and before Heroku kills the process!).
+    You shouldn't have long-running jobs on Sidekiq, but hey! it happens!
+- Same case as before, but not inside Sidekiq. You're either handling signals yourself, or have some other
+    library (in which case, please do a PR!)
+
+The assumption is, obviously, that your loop will run for a long time, but each iteration of your loop is going to be
+quick, otherwise, we can't really exit gracefully. But if we do exit gracefully, you know you're exiting in a known state.
+
+## Download
+
+Gem:
+
+`gem install loop_hard`
+
+## Installation
+
+Load the gem in your GemFile.
+
+  `gem "loop_hard"`
+
+
+## Loop Hard!
+
+Replace your:
+
+```
+loop do
+  # do stuff until we break
+end
+```
+
+with
+
+```
+LoopHard.loop(timeout: 10.minutes) do
+  # do stuff until we break, or until 10 minutes go by, or until something tells us to stop
+end
+```
+
+or, don't really specify a timeout if you're going to run forever, but just want to trap signals / Sidekiq shutdown
+gracefully.
+
+### Set your Logger
+
+LoopHard logs to LoopHard.logger every time it exits a loop, since normally these aren't normal conditions and you
+might want to be notified about it. By default, it logs to stdout.
+
+You probably want to set it to `LoopHard.logger = Rails.logger`, or whatever logger you're using in your app.
+
+
+
+### Trap your own signals
+
+If you want LoopHard to trap signals itself, you'll need to call `LoopHard::SignalTrap.trap_signals`
+
+By default it'll trap INT, TERM and USR1, but you can pass the signals you'd like trapped
+as a parameter to `trap_signals`.
+
+Only do this if you are sure nothing else in your app is trapping signals, because there can only be one signal handler
+per process. For example, if you are using Siekiq, **do not do this**, or you will get in the way of the Sidekiq shutdown
+process.
+
+If you are already trapping signals yourself, you can call `LoopHard::SignalTrap.signal_trapped` when you trap a signal
+that should stop your loops.
+
+
+## Version Compatibility and Continuous Integration
+
+Tested with [Travis](https://travis-ci.org/dmagliola/loop_hard) using Ruby 2.1.1, 2.1.5 and 2.2.2.
+
+LoopHard does work with Ruby 1.9, however, Sidekiq doesn't, so the Sidekiq trap won't work, but the rest will.
+
+To locally run tests do:
+
+```
+rake test
+```
+
+## Copyright
+
+Copyright (c) 2015, Daniel Magliola
+
+See LICENSE for details.
+
+
+## Users
+
+This gem is being used by:
+
+- [MSTY](https://www.msty.com)
+- You? please, let us know if you are using this gem.
+
+
+## Changelog
+
+### Version 0.1.0 (Oct 20th, 2015)
+- Newly released gem
+
+## Contributing
+
+1. Fork it
+1. Create your feature branch (`git checkout -b my-new-feature`)
+1. Code your thing
+1. Write and run tests:
+        bundle install
+        rake test
+1. Write documentation and make sure it looks good: yard server --reload
+1. Add items to the changelog, in README.
+1. Commit your changes (`git commit -am "Add some feature"`)
+1. Push to the branch (`git push origin my-new-feature`)
+1. Create new Pull Request

data/Rakefile

@@ -0,0 +1,15 @@
+require "rubygems"
+require "bundler/setup"
+require "bundler/gem_tasks"
+
+require "rake/testtask"
+Rake::TestTask.new do |t|
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task :default => :test
+
+require 'coveralls/rake/task'
+Coveralls::RakeTask.new
+task :test_with_coveralls => ["test", "coveralls:push"]

data/lib/loop_hard.rb

@@ -0,0 +1,11 @@
+require 'logger'
+require 'loop_hard/logger'
+require 'loop_hard/loop'
+require 'loop_hard/sidekiq_trap'
+require 'loop_hard/signal_trap'
+require 'loop_hard/timeout_trap'
+require 'loop_hard/version'
+
+# Have loops with a timeout, that listen to signals to know if they should stop prematurely
+module LoopHard
+end

data/lib/loop_hard/logger.rb

@@ -0,0 +1,10 @@
+module LoopHard
+  class << self
+    attr_writer :logger
+
+    # Set the Logger for LoopHard
+    def logger
+      @logger ||= Logger.new($stdout)
+    end
+  end
+end

data/lib/loop_hard/loop.rb

@@ -0,0 +1,28 @@
+module LoopHard
+  class << self
+    # Loop until the passed in block breaks, or until one of the traps open.
+    # Will yield to the block passed in until it decides to stop looping.
+    # Your block should break once it's done.
+    # @param options
+    #   - timeout [Int] Maximum time to run (eg: "10" for 10 seconds, 10.minutes if you are using Rails). Defaults to infinite
+    #   - traps [Array of Classes] Which traps to run. Defaults to [SidekiqTrap, SignalTrap, TimeoutTrap] (all of them)
+    def loop(options = {})
+      default_options = { timeout: nil,
+                          traps: [SidekiqTrap, SignalTrap, TimeoutTrap] }
+      options = default_options.merge(options)
+
+      options[:maximum_end_time] = (options[:timeout] ? Time.now + options[:timeout] : nil)
+
+      while continue_looping?(options)
+        yield # Block will call "break" once it's out of rows, which will break this loop
+      end
+    end
+
+    private
+
+    # Decide whether to continue looping, based on the traps involved.
+    def continue_looping?(options)
+      options[:traps].all?{|trap| trap.continue?(options)}
+    end
+  end
+end

data/lib/loop_hard/sidekiq_trap.rb

@@ -0,0 +1,20 @@
+module LoopHard
+  # If Sidekiq has decided to not process more jobs, then stop looping, to let this job end.
+  #   This is a massive hack, and we totally shouldn't be doing this (as per mperham himself!)
+  #     https://github.com/mperham/sidekiq/issues/2364
+  #   But it's better than an ungraceful shutdown
+  #   Also, we can't trap the signals ourselves, since Sidekiq is trapping them, and you can only have one "trap"
+  module SidekiqTrap
+    class << self
+
+      # Returns false if Sidekiq has decided to stop taking new jobs. True otherwise.
+      def continue?(options = nil)
+        if defined?(Sidekiq) && Sidekiq.server? && defined?(Sidekiq::Fetcher) && Sidekiq::Fetcher.done?
+          LoopHard.logger.info "Ending loop due to Sidekiq shutting down"
+          return false
+        end
+        return true
+      end
+    end
+  end
+end

data/lib/loop_hard/signal_trap.rb

@@ -0,0 +1,36 @@
+module LoopHard
+  module SignalTrap
+    class << self
+      @signal_trapped = nil
+
+      # Returns false if a signal has been trapped. True otherwise.
+      def continue?(options = nil)
+        if !@signal_trapped.nil?
+          LoopHard.logger.info "Ending loop due to #{@signal_trapped} signal"
+          return false
+        end
+        return true
+      end
+
+      # Set up a signal trap for the signals specified (defaults to INT, TERM and USR1)
+      # Do not call this if you're using Sidekiq or any other library that handles their own signals!
+      def trap_signals(signals = ["INT", "TERM", "USR1"])
+        signals.each do |sig|
+          Signal.trap sig do
+            signal_trapped(sig)
+          end
+        end
+      end
+
+      # Set the "signal" flag, if you've trapped a signal yourself, so that loops stop looping.
+      def signal_trapped(sig)
+        @signal_trapped = sig
+      end
+
+      # Reset the "signal" flag, so that loops keep looping.
+      def reset_signal_trapped
+        @signal_trapped = nil
+      end
+    end
+  end
+end

data/lib/loop_hard/timeout_trap.rb

@@ -0,0 +1,16 @@
+module LoopHard
+  module TimeoutTrap
+    class << self
+
+      # Returns false if the timeout has expired. True otherwise.
+      # Expects an options has with a `maximum_end_time` key.
+      def continue?(options)
+        if options[:maximum_end_time] && Time.now > options[:maximum_end_time]
+          LoopHard.logger.info "Ending loop due to timeout"
+          return false
+        end
+        return true
+      end
+    end
+  end
+end

data/lib/loop_hard/version.rb

@@ -0,0 +1,3 @@
+module LoopHard
+  VERSION = "0.1.0"
+end

data/loop_hard.gemspec

@@ -0,0 +1,40 @@
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "loop_hard/version"
+
+Gem::Specification.new do |s|
+  s.name        = 'loop_hard'
+  s.version     = LoopHard::VERSION
+  s.summary     = "Have long-running loops with a timeout, that listen to signals to know if they should stop prematurely"
+  s.description = %q{LoopHard allows you to have long-running worker loops that will stop after a while,
+                     and also stop if they get an external signal to stop (for example, if Sidekiq stops due to a USR1,
+                     or a KILL signal is trapped.
+                   }
+  s.authors     = ["Daniel Magliola"]
+  s.email       = 'dmagliola@crystalgears.com'
+  s.homepage    = 'https://github.com/dmagliola/loop_hard'
+  s.license     = 'MIT'
+
+  s.files       = `git ls-files`.split($/)
+  s.executables   = s.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  s.test_files    = s.files.grep(%r{^(test|s.features)/})
+  s.require_paths = ["lib"]
+
+  s.required_ruby_version = ">= 1.9.3"
+
+  s.add_runtime_dependency "logger"
+
+  s.add_development_dependency "bundler"
+  s.add_development_dependency "rake"
+
+  s.add_development_dependency "minitest"
+  s.add_development_dependency "minitest-reporters"
+  s.add_development_dependency "shoulda"
+  s.add_development_dependency "mocha"
+  s.add_development_dependency "simplecov"
+
+  s.add_development_dependency "sidekiq"
+
+  s.add_development_dependency "coveralls"
+  s.add_development_dependency "codeclimate-test-reporter"
+end

data/test/loop_hard_test.rb

@@ -0,0 +1,7 @@
+require_relative "test_helper"
+
+class LoopHardTest < MiniTest::Test
+  should "run tests" do
+    assert true
+  end
+end

data/test/loop_test.rb

@@ -0,0 +1,25 @@
+require_relative "test_helper"
+
+class LoopTest < MiniTest::Test
+  should "loop until break if nothing stops it" do
+    i = 0
+    LoopHard.loop do
+      i += 1
+      break if i == 10
+    end
+
+    assert_equal 10, i
+  end
+
+  should "loop for 100ms" do
+    i = 0
+    LoopHard.loop(timeout: 0.1) do
+      sleep 0.01
+      i += 1
+    end
+
+    # Not an exact science, this thing...
+    assert_operator i, :>, 7
+    assert_operator i, :<, 12
+  end
+end

data/test/sidekiq_trap_test.rb

@@ -0,0 +1,30 @@
+require_relative "test_helper"
+
+class SidekiqTrapTest < MiniTest::Test
+  should "continue if Sidekiq isn't there" do
+    assert LoopHard::SidekiqTrap.continue?
+  end
+
+  # This test is EXTREMELY important, because we're basically using undocumented shit in Sidekiq, so it needs to
+  #   do this in the most abstracted way possible
+  # Unfortunately, I can't really do that, because to get Sidekiq to the point of listening to signals, I need to
+  #   start too much crap, so I just need to hope that if this changes, the internals will change enough that this will
+  #   raise somehow
+  should "sidekiq kill" do
+    require 'sidekiq'
+    require 'sidekiq/cli'
+    require 'celluloid/current'
+    require 'sidekiq/launcher'
+
+    assert LoopHard::SidekiqTrap.continue?
+    assert_equal true, !!Sidekiq.server?
+    assert_equal true, !!defined?(Sidekiq::Fetcher)
+    assert_equal false, !!Sidekiq::Fetcher.done?
+
+    Sidekiq::Fetcher.done! # This is one of the many things that end up happening when Sidekiq gets a USR1 or TERM signal
+
+    assert_equal false, LoopHard::SidekiqTrap.continue?
+
+    Sidekiq::Fetcher.reset # Reset it so the rest of Sidekiq still works
+  end
+end

data/test/signal_trap_test.rb

@@ -0,0 +1,28 @@
+require_relative "test_helper"
+
+class SignalTrapTest < MiniTest::Test
+  should "continue if no signals have been trapped" do
+    assert LoopHard::SignalTrap.continue?
+  end
+
+  should "stop if a signal has been trapped" do
+    LoopHard::SignalTrap.signal_trapped("TERM")
+    assert_equal false, LoopHard::SignalTrap.continue?
+    LoopHard::SignalTrap.reset_signal_trapped
+  end
+
+  should "reset signal trap on demand" do
+    LoopHard::SignalTrap.signal_trapped("TERM")
+    assert_equal false, LoopHard::SignalTrap.continue?
+    LoopHard::SignalTrap.reset_signal_trapped
+    assert_equal true, LoopHard::SignalTrap.continue?
+  end
+
+  should "trap signals" do
+    LoopHard::SignalTrap.trap_signals
+    assert_nil LoopHard::SignalTrap.instance_variable_get(:@signal_trapped)
+    Process.kill "TERM", Process.pid
+    assert_equal "TERM", LoopHard::SignalTrap.instance_variable_get(:@signal_trapped)
+    LoopHard::SignalTrap.reset_signal_trapped
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,37 @@
+require "rubygems"
+
+require "simplecov"
+require "coveralls"
+SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+    SimpleCov::Formatter::HTMLFormatter,
+    Coveralls::SimpleCov::Formatter
+]
+SimpleCov.start do
+  add_filter "/test/"
+  add_filter "/gemfiles/vendor"
+end
+
+require "codeclimate-test-reporter"
+CodeClimate::TestReporter.start
+
+require "minitest/autorun"
+require "minitest/reporters"
+MiniTest::Reporters.use!
+
+require "shoulda"
+require "shoulda-context"
+require "shoulda-matchers"
+require "mocha/setup"
+
+# Make the code to be tested easy to load.
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), "..", "lib"))
+
+require 'active_support/testing/assertions'
+include ActiveSupport::Testing::Assertions
+
+require "benchmark"
+
+require "loop_hard"
+
+LoopHard.logger = Logger.new("/dev/null")

data/test/timeout_trap_test.rb

@@ -0,0 +1,15 @@
+require_relative "test_helper"
+
+class TimeoutTrapTest < MiniTest::Test
+  should "continue if no options are passed in" do
+    assert LoopHard::TimeoutTrap.continue?({})
+  end
+
+  should "continue if the maximum end time is in the future" do
+    assert LoopHard::TimeoutTrap.continue?(maximum_end_time: Time.now + 2)
+  end
+
+  should "stop if the maximum end time is in the past" do
+    assert_equal false, LoopHard::TimeoutTrap.continue?(maximum_end_time: Time.now - 2)
+  end
+end

metadata

@@ -0,0 +1,228 @@
+--- !ruby/object:Gem::Specification
+name: loop_hard
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Daniel Magliola
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-10-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest-reporters
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: shoulda
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sidekiq
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: codeclimate-test-reporter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: "LoopHard allows you to have long-running worker loops that will stop
+  after a while,\n                     and also stop if they get an external signal
+  to stop (for example, if Sidekiq stops due to a USR1,\n                     or a
+  KILL signal is trapped.\n                   "
+email: dmagliola@crystalgears.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/loop_hard.rb
+- lib/loop_hard/logger.rb
+- lib/loop_hard/loop.rb
+- lib/loop_hard/sidekiq_trap.rb
+- lib/loop_hard/signal_trap.rb
+- lib/loop_hard/timeout_trap.rb
+- lib/loop_hard/version.rb
+- loop_hard.gemspec
+- test/loop_hard_test.rb
+- test/loop_test.rb
+- test/sidekiq_trap_test.rb
+- test/signal_trap_test.rb
+- test/test_helper.rb
+- test/timeout_trap_test.rb
+homepage: https://github.com/dmagliola/loop_hard
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.3
+signing_key: 
+specification_version: 4
+summary: Have long-running loops with a timeout, that listen to signals to know if
+  they should stop prematurely
+test_files:
+- test/loop_hard_test.rb
+- test/loop_test.rb
+- test/sidekiq_trap_test.rb
+- test/signal_trap_test.rb
+- test/test_helper.rb
+- test/timeout_trap_test.rb
+has_rdoc: