rya 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 17faa5426332cbf2e4feef95b01dce87da18cbd5
-  data.tar.gz: c3443b989de0b26626635c564a4f226fd2d3cf03
+  metadata.gz: d52060122b7a4d83a2a2b2bea5e393e638f4cccf
+  data.tar.gz: 5d31718797355f9c4cf5577af3a6e03aeaf2a86e
 SHA512:
-  metadata.gz: af2e443c83eff05d51c31acd6609145ac37b1c07bc13357fcc817262cbc7c5893bd55395a8a4db04e83df81711feaf450fddd92b85cfdd3f4c5bb53ce9a78f79
-  data.tar.gz: 9dea5ef86e1cc1f577aebe6010792580c29d258388ea714992f4cdd1302a7d5fdf7c7c76a48187b3dcc650b9dacfc5d29a70c629fc3f4914db7820c95aa88b4c
+  metadata.gz: c5a0c332cce2f4e75ee24a35db64fdd0215161097c2cefb7e2de3cea0c724379d75163bc83e6877c2d8998580f43e296aebcf80af0746157088fadbb54f0d705
+  data.tar.gz: 02bedea663577ccb182fcc42148ec57954665387747d8a8c89a1d850fc895e9962ad5d14244353a387fcc60679282be9dbe32ef77ed21cc618e11638e9550a95

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    rya (0.4.0)
+    rya (0.5.0)
       abort_if (~> 0.2.0)
       systemu (~> 2.6, >= 2.6.5)
 

data/lib/rya.rb

@@ -7,6 +7,13 @@ require "rya/version"
 require "rya/core_extensions"
 
 module Rya
+  # Provide errors for the Rya class.
+  class Error < StandardError
+  end
+
+  class MaxAttemptsExceededError < Error
+  end
+
   # If you want to use AbortIf from this module, you can use it as Rya::AbortIf
   module AbortIf
     # To include the methods

data/lib/rya/core_extensions.rb

@@ -109,6 +109,60 @@ module Rya
     module Process
       include CoreExtensions::Time
 
+      # I run your program until it succeeds or I fail too many times.
+      #
+      # @example I'll keep retrying your command line program until it succeeds.
+      #   klass = Class.new { extend Rya::CoreExtensions::Process }
+      #   max_attempts = 10
+      #
+      #   tries = klass.run_until_success max_attempts do
+      #     # This command returns a Process::Status object!
+      #     klass.run_it "echo 'hi'"
+      #   end
+      #
+      #   tries == 1 #=> true
+      #
+      # @example I'll raise an error if the program doesn't succeed after max_attempts tries.
+      #   klass = Class.new { extend Rya::CoreExtensions::Process }
+      #   max_attempts = 10
+      #
+      #   begin
+      #     klass.run_until_success max_attempts do
+      #       # This command returns a Process::Status object!
+      #       klass.run_it "ls 'file_that_doesnt_exist'"
+      #     end
+      #   rescue Rya::MaxAttemptsExceededError => err
+      #     STDERR.puts "The command didn't succeed after #{max_attempts} tries!"
+      #   end
+      #
+      # @param max_attempts [Integer] max attempts before I fail
+      #
+      # @yield The block specifies the command you want to run.  Make sure that it returns something that responds to exitstatus!
+      #
+      # @return [Integer] the number of attempts before successful completion
+      #
+      # @raise [Rya::Error] if the block does not return an object that responds to exitstatus (e.g., Prosses::Status)
+      # @raise [Rya::MaxAttemptsExceededError] if the program fails more than max_attempts times
+      #
+      def run_until_success max_attempts, &block
+        max_attempts.times do |attempt_index|
+          proc_status = yield block
+
+          unless proc_status.respond_to? :exitstatus
+            raise Rya::Error, "The block did not return an object that responds to exitstatus"
+          end
+
+          puts "proc_status in run_until_success fn: #{proc_status.inspect}"
+
+          if proc_status.exitstatus.zero?
+            return attempt_index + 1
+          end
+        end
+
+        raise Rya::MaxAttemptsExceededError, "max_attempts exceeded"
+      end
+
+
       # Runs a command and outputs stdout and stderr
       def run_it *a, &b
         exit_status, stdout, stderr = systemu *a, &b

data/lib/rya/version.rb

@@ -1,3 +1,3 @@
 module Rya
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rya
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Ryan Moore
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-07-30 00:00:00.000000000 Z
+date: 2019-01-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler