attempt 0.6.1 → 0.6.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9f4489fdcd16a1e4fd93187cf684afc4eb42b9d1b35987372ce099b0081ab938
-  data.tar.gz: 0d359e069dded75e7e0871c1903f5950275b5f033e22490ea3358c55e8883df0
+  metadata.gz: c954f55aef2408950c9aeafde149fa2562576e62af9f6a0215f6dc90bec184eb
+  data.tar.gz: 1951edd8ffc473008f37850504fda990593721378c26c84c3375f9c58df868ef
 SHA512:
-  metadata.gz: 61728e4d946893471d103dfa8f2114212bf9438774b6636cff3744186fe0c99f7e48687969abe8627aa48b4cdb0d7203666978ded8bae2b3ba9d4f1e2616d57b
-  data.tar.gz: a34ac935d3fde78fed37884e93f9019c015a106c15f741732fedd2184c298eb1233ab23f967dfb85bfa6eaf1bb873d6e208730c20cf59cf40bbf101122f5c1a5
+  metadata.gz: 687f808427b5c2a686c89892af635b5528886207c6bf0a38036c0b4cceb92592a2a89579301083eb7a3ca01e297878e02ccf57148504e4fb10f1188ebf1841c4
+  data.tar.gz: '028d54de4b4602f76d2ffae474c1f1bdc2835604aac33d24cc503cdd250661839bb6eefcf15a7e8fa0d5e25af401cf5a91ff144213c2599551f3d28d38788972'

data/CHANGES.md

@@ -1,3 +1,6 @@
+## 0.6.2 - 2-Jun-2022
+* The safe_timeout library is not used on MS Windows.
+
 ## 0.6.1 - 20-Oct-2020
 * Switched the README, MANIFEST and CHANGES to markdown format.
 * Fiddling with the .travis.yml file again.

data/Gemfile

@@ -1,8 +1,2 @@
-source 'https://rubygems.org' do
-  gem 'rake'
-  gem 'structured_warnings', '~> 0.4.0'
-  gem 'safe_timeout', '~> 0.0.5'
-  group 'test' do
-    gem 'rspec', '~> 3.9'
-  end
-end
+source 'https://rubygems.org'
+gemspec

data/README.md

@@ -1,42 +1,40 @@
 ## Description
-
 A thin wrapper for begin + rescue + sleep + retry.
 
 ## Installation
+`gem install attempt`
 
-gem install attempt   
+## Adding the trusted cert
+`gem cert --add <(curl -Ls https://raw.githubusercontent.com/djberg96/attempt/main/certs/djberg96_pub.pem)`
 
 ## Synopsis
+```ruby
+require 'attempt'
+ 
+# Attempt to ftp to some host, trying 3 times with 30 seconds between
+# attempts before finally raising an error.
 
-```
-  require 'attempt'
-   
-  # Attempt to ftp to some host, trying 3 times with 30 seconds between
-  # attempts before finally raising an error.
+attempt(tries: 3, interval: 30){
+  Net::FTP.open(host, user, passwd){ ... }
+}
  
-  attempt(tries: 3, interval: 30){
-    Net::FTP.open(host, user, passwd){ ... }
-  }
-   
-  # Or, do things the long way...
-  code = Attempt.new do |a|
-    a.tries    = 3
-    a.interval = 30
-  end
-   
-  code.attempt{
-    Net::FTP.open(host, user, passwd){ ... }
-  }
+# Or, do things the long way...
+code = Attempt.new do |a|
+  a.tries    = 3
+  a.interval = 30
+end
+ 
+code.attempt{
+  Net::FTP.open(host, user, passwd){ ... }
+}
 ```
 
 ## Known Bugs
-
 None that I'm aware of. If you find any bugs, please log them on the project page at:
 
 https://github.com/djberg96/attempt
 
 ## Caveats
-
 Use with caution. Specifically, make sure you aren't inadvertantly
 wrapping code that already performs sleep + retry. Otherwise, you'll
 end up with a series of nested retry's that could take much longer to
@@ -49,36 +47,30 @@ As of version 0.3.0, this library requires structured_warnings 0.3.0 or
 later. This is necessary because of changes in Ruby 2.4.
 
 Update: I've switched from the timeout library in the standard library to
-the safe_timeout library which should improve things. In addition, the
-structured_warnings library requirement is now 0.4.0 or later in order to
-work with Ruby 2.7.
+the safe_timeout library on non-Windows platforms which should improve things.
+In addition, the structured_warnings library requirement is now 0.4.0 or later
+in order to work with Ruby 2.7.
 
 ## Future Plans
-
 Add the ability to set an absolute maximum number of seconds to prevent
 nested sleep/retry from delaying attempts longer than expected.
 
 Replace the timeout library with a self selecting pipe if possible.
 
 ## Acknowledgements
-
 This library is partially based on Mark Fowler's 'Attempt' Perl module.
 
 ## Warranty
-
 This package is provided "as is" and without any express or
 implied warranties, including, without limitation, the implied
 warranties of merchantability and fitness for a particular purpose.
 
 ## License
-
 Apache-2.0
 
 ## Copyright
-
-(C) 2006-2020, Daniel J. Berger
+(C) 2006-2022, Daniel J. Berger
 All Rights Reserved
 
 ## Author
-
 Daniel J. Berger

data/Rakefile

@@ -8,7 +8,7 @@ namespace :gem do
   desc 'Build the attempt gem'
   task :create => [:clean] do
     require 'rubygems/package'
-    spec = eval(IO.read('attempt.gemspec'))
+    spec = Gem::Specification.load('attempt.gemspec')
     spec.signing_key = File.join(Dir.home, '.ssh', 'gem-private_key.pem')
     Gem::Package.build(spec)
   end

data/attempt.gemspec

@@ -2,7 +2,7 @@ require 'rubygems'
 
 Gem::Specification.new do |spec|
   spec.name       = 'attempt'
-  spec.version    = '0.6.1'
+  spec.version    = '0.6.2'
   spec.author     = 'Daniel J. Berger'
   spec.license    = 'Apache-2.0'
   spec.email      = 'djberg96@gmail.com'
@@ -13,12 +13,13 @@ Gem::Specification.new do |spec|
   spec.cert_chain = Dir['certs/*']
   
   spec.metadata = {
-    'changelog_uri'   => 'https://github.com/djberg96/attempt/blob/master/CHANGES',
-    'source_code_uri' => 'https://github.com/djberg96/attempt/blob/master/lib/attempt.rb',
+    'changelog_uri'   => 'https://github.com/djberg96/attempt/blob/main/CHANGES.md',
+    'source_code_uri' => 'https://github.com/djberg96/attempt/blob/main/lib/attempt.rb',
     'bug_tracker_uri' => 'https://github.com/djberg96/attempt/issues',
     'wiki_uri'        => 'https://github.com/djberg96/attempt/wiki'
   }
 
+  spec.add_development_dependency('rake')
   spec.add_dependency('structured_warnings', '~> 0.4.0')
   spec.add_dependency('safe_timeout', '~> 0.0.5')
   spec.add_dependency('rspec', '~> 3.9')

data/lib/attempt.rb

@@ -1,12 +1,18 @@
-require 'safe_timeout'
+# frozen_string_literal: true
+
+if File::ALT_SEPARATOR
+  require 'timeout'
+else
+  require 'safe_timeout'
+end
+
 require 'structured_warnings'
 
 # The Attempt class encapsulates methods related to multiple attempts at
 # running the same method before actually failing.
 class Attempt
-
   # The version of the attempt library.
-  VERSION = '0.6.1'.freeze
+  VERSION = '0.6.2'
 
   # Warning raised if an attempt fails before the maximum number of tries
   # has been reached.
@@ -51,7 +57,7 @@ class Attempt
   # * warnings  - Boolean value that indicates whether or not errors are treated as warnings
   #               until the maximum number of attempts has been made. The default is true.
   # * timeout   - Boolean value to indicate whether or not to automatically wrap your
-  #               proc in a SafeTimeout block. The default is false.
+  #               proc in a Timeout/SafeTimeout block. The default is false.
   #
   # Example:
   #
@@ -74,18 +80,18 @@ class Attempt
   # You will not typically use this method directly, but the Kernel#attempt
   # method instead.
   #
-  def attempt
+  def attempt(&block)
     count = 1
     begin
       if @timeout
-        SafeTimeout.timeout(@timeout){ yield }
+        File::ALT_SEPARATOR ? Timeout.timeout(@timeout, &block) : SafeTimeout.timeout(@timeout, &block)
       else
         yield
       end
-    rescue @level => error
+    rescue @level => err
       @tries -= 1
       if @tries > 0
-        msg = "Error on attempt # #{count}: #{error}; retrying"
+        msg = "Error on attempt # #{count}: #{err}; retrying"
         count += 1
         warn Warning, msg if @warnings
 
@@ -102,30 +108,31 @@ class Attempt
   end
 end
 
+# Extend the Kernel module with a simple interface for the Attempt class.
 module Kernel
-   # :call-seq:
-   #    attempt(tries: 3, interval: 60, timeout: 10){ # some op }
-   #
-   # Attempt to perform the operation in the provided block up to +tries+
-   # times, sleeping +interval+ between each try. By default the number
-   # of tries defaults to 3, the interval defaults to 60 seconds, and there
-   # is no timeout specified.
-   #
-   # If +timeout+ is provided then the operation is wrapped in a Timeout
-   # block as well. This is handy for those rare occasions when an IO
-   # connection could hang indefinitely, for example.
-   #
-   # If the operation still fails the (last) error is then re-raised.
-   #
-   # This is really just a convenient wrapper for Attempt.new + Attempt#attempt.
-   #
-   # Example:
-   #
-   #    # Make 3 attempts to connect to the database, 60 seconds apart.
-   #    attempt{ DBI.connect(dsn, user, passwd) }
-   #
-   def attempt(**kwargs, &block)
-     object = Attempt.new(kwargs)
-     object.attempt(&block)
-   end
+  # :call-seq:
+  #    attempt(tries: 3, interval: 60, timeout: 10){ # some op }
+  #
+  # Attempt to perform the operation in the provided block up to +tries+
+  # times, sleeping +interval+ between each try. By default the number
+  # of tries defaults to 3, the interval defaults to 60 seconds, and there
+  # is no timeout specified.
+  #
+  # If +timeout+ is provided then the operation is wrapped in a Timeout
+  # block as well. This is handy for those rare occasions when an IO
+  # connection could hang indefinitely, for example.
+  #
+  # If the operation still fails the (last) error is then re-raised.
+  #
+  # This is really just a convenient wrapper for Attempt.new + Attempt#attempt.
+  #
+  # Example:
+  #
+  #    # Make 3 attempts to connect to the database, 60 seconds apart.
+  #    attempt{ DBI.connect(dsn, user, passwd) }
+  #
+  def attempt(**kwargs, &block)
+    object = Attempt.new(**kwargs)
+    object.attempt(&block)
+  end
 end

data/spec/attempt_spec.rb

@@ -23,7 +23,7 @@ RSpec.describe Attempt do
   end
 
   example "version constant is set to expected value" do
-    expect(Attempt::VERSION).to eq('0.6.1')
+    expect(Attempt::VERSION).to eq('0.6.2')
     expect(Attempt::VERSION).to be_frozen
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: attempt
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.6.2
 platform: ruby
 authors:
 - Daniel J. Berger
@@ -35,8 +35,22 @@ cert_chain:
   ORVCZpRuCPpmC8qmqxUnARDArzucjaclkxjLWvCVHeFa9UP7K3Nl9oTjJNv+7/jM
   WZs4eecIcUc4tKdHxcAJ0MO/Dkqq7hGaiHpwKY76wQ1+8xAh
   -----END CERTIFICATE-----
-date: 2020-10-20 00:00:00.000000000 Z
+date: 2022-06-02 00:00:00.000000000 Z
 dependencies:
+- !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: structured_warnings
   requirement: !ruby/object:Gem::Requirement
@@ -104,8 +118,8 @@ homepage: https://github.com/djberg96/attempt
 licenses:
 - Apache-2.0
 metadata:
-  changelog_uri: https://github.com/djberg96/attempt/blob/master/CHANGES
-  source_code_uri: https://github.com/djberg96/attempt/blob/master/lib/attempt.rb
+  changelog_uri: https://github.com/djberg96/attempt/blob/main/CHANGES.md
+  source_code_uri: https://github.com/djberg96/attempt/blob/main/lib/attempt.rb
   bug_tracker_uri: https://github.com/djberg96/attempt/issues
   wiki_uri: https://github.com/djberg96/attempt/wiki
 post_install_message:
@@ -123,7 +137,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.3.15
 signing_key:
 specification_version: 4
 summary: A thin wrapper for begin + rescue + sleep + retry