deploy_pin 1.3.6 → 1.3.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f8d54545ca8705415995b4ed6e7b59fbb308ea4421d08d4eeeeacdae1be1f087
-  data.tar.gz: afe158691f1856b272544cfe7716639c1d91c850633b10a9ca78d80753203258
+  metadata.gz: e3d6aa336c010d58ff4462cc64038351fa67432faf2f4dd3e094b12d3c912c9e
+  data.tar.gz: a9e8d29ac5e8db0c207f2e40a59f6d77013c98efbf7e9cb38c5b1e1b6840f577
 SHA512:
-  metadata.gz: 774e3e0e1b5393aa33faeadba2d895824007ed9edcd50e2489f12208d054b976dc687737ee093020bf74c0ee92260cc01cae16e44665961395055cd2bb10f308
-  data.tar.gz: 9239fad3c44d2ae433bb9568cc8ae687f014e8ab6e387201d507911e81bb98844fa8dc1306ec64adcb0c45477c5c9e2b61de477c0c501a5213e505514be987ed
+  metadata.gz: bf2efc8fd1cc48f8e1bf5568bb11544d6a20510e7bbfa2ae81f63f831da6776945b6dc22e5d9befa444c77d042b3d6a9a87bb9b40f246c4a54e9801fd960069a
+  data.tar.gz: 1527b98cccfec97dad84286cea3063c9a76a051f9286a8be01181bb1bd1c6032e94693b57ed1f3cfea7b1286a2849d5fa2e36a0d8e7a1fe90f41dba946212c63

data/README.md

@@ -110,7 +110,7 @@ A default value must be defined in the deploy_pin initializer. Ex.:
 # config/initializers/deploy_pin.rb
 DeployPin.setup do
   statement_timeout 0.2.second # 200 ms
-end 
+end
 ```
 
 In order to not use the default value, it's required to use explicitly in the task, like:
@@ -127,7 +127,7 @@ end
 
 To know more about the params, please check the documentation [here](lib/deploy_pin/database.rb).
 
-### Parallel
+## Parallel
 To run parallel tasks using timeout, it's required to use the parallel wrapper, which mimics parallel interface,  
 but adding the timeout option.
 
@@ -142,6 +142,52 @@ end
 
 Check the documentation [here](lib/deploy_pin/parallel_wrapper.rb).
 
+## Formatting
+`run_formatter` is used to format the output of a `run` task  
+`list_formatter` is used to format the output of a `list` task
+
+A default value must be defined in the deploy_pin initializer. Ex.:
+```ruby
+# config/initializers/deploy_pin.rb
+DeployPin.setup do
+  run_formatter(
+    lambda do |index, task_count, task, executable, start, duration = nil|
+      end_of_msg = if executable
+                     start ? '(Started)' : "(Done in #{duration})\n\n"
+                   else
+                     "(Skipped)\n\n"
+                   end
+
+      puts("[#{index + 1}/#{task_count}] Task #{task.title} #{task.uuid}##{task.group} #{end_of_msg}".blue.bold)
+    end
+  )
+  list_formatter(
+    lambda do |index, task|
+      puts("======= Task ##{index} ========".blue.bold)
+
+      # print details
+      task.details.each do |key, value|
+        puts("#{key}:\t\t#{value}")
+      end
+
+      puts("\n<<<\n#{task.script.strip.green}\n>>>\n\n")
+    end
+  )
+end
+```
+
+In order to not use the default value, it's required to use explicitly in the task, like:
+```ruby
+# Some deploy_pin task 
+# 20190401135040:I
+# task_title: Execute some query with timeout
+
+# === task code goes down here ===
+DeployPin::Database::execute_with_timeout do
+ ActiveRecord::Base.connection.execute("select * from shipments;")
+end
+```
+
 ## Contributing
 Contribution directions go here.
 

data/lib/deploy_pin/collector.rb

@@ -3,7 +3,7 @@
 # executes tasks
 module DeployPin
   class Collector
-    attr_reader :identifiers
+    attr_reader :identifiers, :formatter
 
     def initialize(identifiers:)
       @identifiers = identifiers
@@ -16,13 +16,15 @@ module DeployPin
         # run only uniq tasks
         executable = _tasks[0..index].none? { |_task| task.eql?(_task) }
 
-        yield(index, _tasks.count, task, executable)
+        DeployPin.run_formatter.call(index, _tasks.count, task, executable, true)
 
         # run if executable
         if executable
-          run_with_timeout(!task.explicit_timeout? && !task.parallel?) do
-            task.run
+          duration = execution_duration do
+            run_with_timeout(task) { task.run }
           end
+
+          DeployPin.run_formatter.call(index, _tasks.count, task, executable, false, duration)
         end
 
         # mark each task as done
@@ -33,11 +35,11 @@ module DeployPin
     def list
       _tasks = tasks
       _tasks.each_with_index do |task, index|
-        yield(index, _tasks.count, task)
+        DeployPin.list_formatter.call(index, task)
       end
     end
 
-    def exacutable
+    def executable
       # cache tasks
       _tasks = tasks
       _tasks.map.with_index do |task, index|
@@ -71,10 +73,18 @@ module DeployPin
       end
 
       # :reek:UtilityFunction and :reek:ControlParameter
-      def run_with_timeout(under_timeout, &block)
-        return yield unless under_timeout
+      def run_with_timeout(task, &block)
+        return yield unless task.under_timeout?
 
         DeployPin::Database.execute_with_timeout(DeployPin.statement_timeout, **{}, &block)
       end
+
+      def execution_duration
+        start_time = Time.now
+
+        yield
+
+        Time.now - start_time
+      end
   end
 end

data/lib/deploy_pin/runner.rb

@@ -4,32 +4,17 @@
 module DeployPin
   module Runner
     def self.run(identifiers:)
-      DeployPin::Collector.new(identifiers: identifiers).run do |index, count, task, executable|
-        self.print("[#{index + 1}/#{count}] Task #{task.title} #{task.uuid}##{task.group} (#{executable ? 'run' : 'skip'})")
-      end
+      DeployPin::Collector.new(identifiers: identifiers).run
     end
 
     def self.list(identifiers:)
-      DeployPin::Collector.new(identifiers: identifiers).list do |index, _count, task|
-        self.print("======= Task ##{index} ========".white)
-
-        # print details
-        task.details.each do |key, value|
-          self.print("#{key}:\t\t#{value}")
-        end
-
-        self.print('')
-        self.print('<<<')
-        self.print task.script.strip.green
-        self.print('>>>')
-        self.print('')
-      end
+      DeployPin::Collector.new(identifiers: identifiers).list
     end
 
     def self.summary(identifiers:)
       # print summary
       self.print('======= Summary ========')
-      self.print("tasks number: #{DeployPin::Collector.new(identifiers: identifiers).tasks_count}")
+      self.print("Tasks number: #{DeployPin::Collector.new(identifiers: identifiers).tasks_count}")
     end
 
     def self.print(msg)

data/lib/deploy_pin/task.rb

@@ -37,12 +37,8 @@ module DeployPin
       DeployPin::Record.where(uuid: uuid).exists?
     end
 
-    def explicit_timeout?
-      @explicit_timeout
-    end
-
-    def parallel?
-      @parallel
+    def under_timeout?
+      !explicit_timeout? && !parallel?
     end
 
     def parse_file
@@ -85,5 +81,13 @@ module DeployPin
       def group_index
         DeployPin.groups.index(group)
       end
+
+      def explicit_timeout?
+        @explicit_timeout
+      end
+
+      def parallel?
+        @parallel
+      end
   end
 end

data/lib/deploy_pin/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DeployPin
-  VERSION = '1.3.6'
+  VERSION = '1.3.8'
 end

data/lib/deploy_pin.rb

@@ -17,6 +17,8 @@ module DeployPin
     fallback_group
     groups
     statement_timeout
+    run_formatter
+    list_formatter
   ].freeze
 
   OPTIONS.each do |option|

data/lib/generators/deploy_pin/install/templates/deploy_pin.rb

@@ -4,6 +4,28 @@ DeployPin.setup do
   tasks_path 'lib/deploy_pin'
   groups %w[I II III]
   fallback_group 'II'
-
   statement_timeout 10.minutes
+  run_formatter(
+    lambda do |index, task_count, task, executable, start, duration = nil|
+      end_of_msg = if executable
+                     start ? '(Started)' : "(Done in #{duration})\n\n"
+                   else
+                     "(Skipped)\n\n"
+                   end
+
+      puts("[#{index + 1}/#{task_count}] Task #{task.title} #{task.uuid}##{task.group} #{end_of_msg}".blue.bold)
+    end
+  )
+  list_formatter(
+    lambda do |index, task|
+      puts("======= Task ##{index} ========".blue.bold)
+
+      # print details
+      task.details.each do |key, value|
+        puts("#{key}:\t\t#{value}")
+      end
+
+      puts("\n<<<\n#{task.script.strip.green}\n>>>\n\n")
+    end
+  )
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: deploy_pin
 version: !ruby/object:Gem::Version
-  version: 1.3.6
+  version: 1.3.8
 platform: ruby
 authors:
 - Viktor Sych
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-02-20 00:00:00.000000000 Z
+date: 2023-03-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: colorize