worker_tools 1.3 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a69e014d2d2959641972ad163b5567e957693c90b54ae9e7aec4a723f1f39c6
-  data.tar.gz: 3cc3536cf26ab79054761570671361d23bbcb2c708e4974ebfd07ea8671180f3
+  metadata.gz: 36547805fb8cfbbf750b84c31fb325a918c54501830bbdfd68f8f2c8f5b1267e
+  data.tar.gz: 47361b96ca6e8964b688b0ea50e426c2786edc9b0415984fc9dd4c5247c9cc1d
 SHA512:
-  metadata.gz: f4d622417f3afd6057ae548f2b0e688ce1d8087d1e75a176ff4fe85caef5b1a1469e3ad07db2e21da2be6a365e97ba0bae18fbdd818f2eaea47bc7bb4e2fd0b7
-  data.tar.gz: e479438605973cf104b4c9d60cf3a7f821d09c053c7e569370afa7a1bbcc5e52006f65863a8a2085caa31f878df987c85d8daa7461c41f229aaa71094f9a6c2b
+  metadata.gz: d0fbe8c88c4aa16ea93840bae76823d43aa98539110ba3f347607ca809ddf0ae5687a84608d86b73ae3b771816ad746d9e2006c681192fca3c1bec33c04a9af6
+  data.tar.gz: c0bbd1d018d2d77a61fd538c337423d6380ed1a351e8844eb930e6fd416068461df06fa8732527cadd5949348be44f3ec70bf6ac97dcfdb1b7eec02825dfd0e2

data/README.md

@@ -84,6 +84,7 @@ class Import < ApplicationRecord
     complete_with_warnings
     failed
     running
+    empty
   ].map { |e| [e, e] }.to_h
 
   enum kind: { foo: 0, bar: 1 }
@@ -99,6 +100,8 @@ The state `complete` and `failed` are used by the modules. Both `state` and `kin
 
 The state `complete_with_warnings` indicates that the model contains notes that did not lead to a failure but should get some attention. By default those levels are `warning` and `errors` and can be customized.
 
+The state `empty` is automatically set by the CSV and XLSX input modules when the input file does not exist or is empty (0 bytes).
+
 In this case the migration would be something like this:
 
 ```ruby
@@ -199,6 +202,22 @@ See all methods in [slack_error_notifier](/lib/worker_tools/slack_error_notifier
 
 See all methods in [csv_input](/lib/worker_tools/csv_input.rb)
 
+### Skipping File Presence Check
+
+By default, the CSV Input module checks if the file exists and is not empty. If you need to skip this validation (for example, if an empty file is valid for your process), you can override the `csv_input_file_presence_check` method:
+
+```ruby
+class CsvInputExample
+  include WorkerTools::CsvInput
+
+  def csv_input_file_presence_check
+    true
+  end
+
+  # ... rest of your implementation
+end
+```
+
 ## Module CSV Output
 
 See all methods in [csv_output](/lib/worker_tools/csv_output.rb)

data/lib/worker_tools/basics.rb

@@ -57,7 +57,9 @@ module WorkerTools
     # rubocop:disable Lint/RescueException
     rescue Exception => e
       # rubocop:enable Lint/RescueException
-      save_state_without_validate('failed')
+      state = e.is_a?(WorkerTools::Errors::EmptyFile) ? 'empty' : 'failed'
+      save_state_without_validate(state)
+
       raise unless silent_error?(e)
     end
 

data/lib/worker_tools/csv_input.rb

@@ -59,6 +59,8 @@ module WorkerTools
     end
 
     def csv_input_columns_array_check(csv_rows_enum)
+      return if csv_rows_enum.first.nil?
+
       expected_columns_length = csv_input_columns.length
       actual_columns_length = csv_rows_enum.first.length
       return if expected_columns_length == actual_columns_length
@@ -68,6 +70,8 @@ module WorkerTools
     end
 
     def csv_input_columns_hash_check(csv_rows_enum)
+      raise Errors::MissingColumns, 'The headers are missing' if csv_rows_enum.first.nil?
+
       expected_names = csv_input_columns.values
       filtered_actual_names = csv_rows_enum.first.map { |n| csv_input_header_normalized(n) }
       csv_input_columns_hash_check_duplicates(filtered_actual_names)
@@ -145,8 +149,14 @@ module WorkerTools
       true
     end
 
+    def csv_input_file_presence_check
+      raise Errors::EmptyFile, 'The file does not exist' unless File.exist?(csv_input_file_path)
+      raise Errors::EmptyFile, 'The file is empty' if File.zero?(csv_input_file_path)
+    end
+
     def csv_input_foreach
       @csv_input_foreach ||= begin
+        csv_input_file_presence_check
         csv_input_columns_check(csv_rows_enum)
 
         CsvInputForeach.new(

data/lib/worker_tools/errors.rb

@@ -6,5 +6,11 @@ module WorkerTools
     WrongNumberOfColumns = Class.new(Silent)
     DuplicatedColumns = Class.new(Silent)
     MissingColumns = Class.new(Silent)
+
+    class EmptyFile < Silent
+      def initialize(msg = 'The file is empty')
+        super(msg)
+      end
+    end
   end
 end

data/lib/worker_tools/version.rb

@@ -1,3 +1,3 @@
 module WorkerTools
-  VERSION = '1.3'.freeze
+  VERSION = '1.3.1'.freeze
 end

data/lib/worker_tools/xlsx_input.rb

@@ -142,8 +142,14 @@ module WorkerTools
       true
     end
 
+    def xlsx_input_file_presence_check
+      raise Errors::EmptyFile, 'The file does not exist' unless File.exist?(xlsx_input_file_path)
+      raise Errors::EmptyFile, 'The file is empty' if File.zero?(xlsx_input_file_path)
+    end
+
     def xlsx_input_foreach
       @xlsx_input_foreach ||= begin
+        xlsx_input_file_presence_check
         xlsx_input_columns_check(xlsx_rows_enum)
 
         XlsxInputForeach.new(

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: worker_tools
 version: !ruby/object:Gem::Version
-  version: '1.3'
+  version: 1.3.1
 platform: ruby
 authors:
 - fsainz
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-24 00:00:00.000000000 Z
+date: 2026-01-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport