shrine-zip-guard 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9359699bdaf1bf53ba7b23a7c271880166360df60bf26d78ef5b874cd8e605e2
-  data.tar.gz: d353357a3022c8f981501e735ca40f1a3264cdb8bc0d42c5093be2a369609d81
+  metadata.gz: 77f0c1a42fe262acd41c72ef110fd74cadf993c0b180624ddd1d47d4a76dd1e7
+  data.tar.gz: 60996e76aa76030fabf52f525be6e6048009c2d8dc063495935d23c2b730ce4e
 SHA512:
-  metadata.gz: 0c170879388c9bb5c29a50d25d74a3ce50718f30ae315b318151333b4c5e9424213ab6172254bf63302ff94ea32c456006ba4cd4334e3be3659998ed0578595c
-  data.tar.gz: 82c23d6223bfe1c618471cf62c06b44d86a93f17779bf149bc1272b120cfc9bed557927416ca47a1b9adc3313f99bbcb5e837d0ed9665aa581da01680adbe47d
+  metadata.gz: 217ee96460de7fea169f1ce225812866a54608f98e4e4af5935a328bcc092b19450561fb9c3b314d298b3b682c31d28749eb963414594656073be3c2fe87d7cc
+  data.tar.gz: 16a011fbd591b0224420807290a1dadf694f79706107b0cc029c108d13fc46ab2c9ba23b929cbed664055fae0e85f9879e36b5ba9b3e04cf9dbef049620fa986

data/CHANGELOG.md

@@ -1,6 +1,15 @@
 # Changelog
 
-## [Unreleased]
+## [0.3.0] - 2026-08-11
+
+### Fixed
+- All rescue branches in `create_derivatives` now explicitly return `{}` instead of the error messages array.
+
+### Changed
+- `rescue ZipGuard::Error` broadened to `rescue StandardError` — catches corrupt ZIP archives, other unexpected errors, and custom error subclasses like `NestedFileError`.
+- Fallback callback (`shrine_class.opts[:zip_guard][:fallback]`) is now invoked for all rescued errors, not just `ZipGuard::Error` subclasses.
+- Renamed internal method `handle_zip_guard_error` to `handle_error`.
+- Renamed internal method `report_fallback` to `report_error`.
 
 ## [0.2.0] - 2026-08-06
 

data/README.md

@@ -75,8 +75,9 @@ class XmlUploader < Shrine
 end
 ```
 
-Note that `with_zip` performs its own `required_files` check, so you should not also
-pass `required_files` to the plugin when you provide a custom `derivatives` block.
+`with_zip` checks for encryption and optional required file patterns before
+yielding the opened ZIP file. You do not need to pass `required_files` to both
+the plugin and `with_zip`.
 
 ## Error messages
 
@@ -115,9 +116,12 @@ would become `my_uploaders/xml_uploader`.
 
 ## Custom fallback for unexpected errors
 
-By default, unexpected `ZipGuard::Error` subclasses are reported to the Rails error
+By default, any unhandled error (including corrupt ZIP archives, `StandardError`
+subclasses not explicitly caught by the plugin) is reported to the Rails error
 reporter (if available) and a generic `processing_failed` message is added to
-`attacher.errors`. You can override this with your own handler:
+`attacher.errors`.
+
+You can override this with your own handler:
 
 ```ruby
 plugin :zip_guard,
@@ -128,6 +132,10 @@ plugin :zip_guard,
        }
 ```
 
+The fallback is called for any rescued error that is not a specific
+`EncryptedZipError` or `MissingFileError`. This includes corrupt ZIPs, custom
+application error classes, and other unexpected errors.
+
 ## Supported versions
 
 - Ruby >= 3.1

data/lib/shrine/plugins/zip_guard.rb

@@ -49,10 +49,13 @@ class Shrine
           super
         rescue ZipGuard::EncryptedZipError
           errors << I18n.t(error_message_key("password_protected"))
+          {}
         rescue ZipGuard::MissingFileError => e
           errors << I18n.t(error_message_key("missing_file"), pattern: e.pattern)
-        rescue ZipGuard::Error => e
-          handle_zip_guard_error(e)
+          {}
+        rescue StandardError => e
+          handle_error(e)
+          {}
         end
 
         private
@@ -74,18 +77,18 @@ class Shrine
             .downcase
         end
 
-        def handle_zip_guard_error(error)
+        def handle_error(error)
           fallback = shrine_class.opts[:zip_guard][:fallback]
 
           if fallback
             fallback.call(error, self)
           else
-            report_fallback(error)
+            report_error(error)
             errors << I18n.t(error_message_key("processing_failed"))
           end
         end
 
-        def report_fallback(error)
+        def report_error(error)
           return unless defined?(Rails) && Rails.respond_to?(:error) && Rails.error.respond_to?(:report)
 
           Rails.error.report(error)

data/lib/shrine-zip-guard/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ShrineZipGuard
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: shrine-zip-guard
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Martin Dobrovodský
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-06 00:00:00.000000000 Z
+date: 2026-08-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: i18n