imap-backup 14.5.0 → 14.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ee294a8f4d7c0af90c725939b3f4cd7826ac521194460af3446e7cf5378629f4
-  data.tar.gz: c67cac7ddfb2448a9cb22b642b53be02b157959d51f3677bc37ec891da2471c8
+  metadata.gz: e2b34662687d096c2dc7e4522910a009d12aeb4eb6f57c66c9f352ca3e1d8051
+  data.tar.gz: 993b38940bf5c037cdf56a088b0dde8e380ec6bb081f1268eeddad72f6d9ea76
 SHA512:
-  metadata.gz: e1b2f9affe114ea775b4f7f7d4d2db4349e03b3ccb842885b3423c28c2b84ff6e8872b224a520654e0cef8eb353e9f0ea268e9d0dcda2666b07709f5071a0db7
-  data.tar.gz: 2feab585634685c45606d6e4668e52190af3fd193cf3c8468ea5b306a8834257c2944ca4c668ee5e1f9423ebfb3cf605de9d6c8052a983d57f3fe0df07d105c8
+  metadata.gz: 3cc751ae2e157ea6e1e6f59cff363c21536219fd732962f2a5d5b97e3c8373a9bf698868023cf212590d75b784f74b8a36a5c5c87d2e6005f71314aa1511be00
+  data.tar.gz: 0ed900bd4e5ae9b01c3d10cefeb35da2d4185788fd6aded23b1f957dfdfae476c1a6dabb2804a61a889b91359f03e74a208eb6e3c411af255f61aec7a18435ad

data/lib/imap/backup/cli/single.rb

@@ -104,9 +104,12 @@ module Imap::Backup
       "path",
       type: "string",
       desc: "the path of the directory where backups are to be saved. " \
-            "If the directory does not exists, it will be created. " \
+            "If the directory does not exist, it will be created. " \
             "If not set, this is set to a diretory under the current path " \
-            "which is derived from the username, by replacing '@' with '_'.",
+            "which is derived from the username, by replacing '@' with '_'." \
+            "If this path parameter is not indicated, " \
+            "the default is the current directory plus the email " \
+            "with '@' replaced by '_'.",
       aliases: ["-P"]
     )
     method_option(

data/lib/imap/backup/serializer/imap.rb

@@ -108,6 +108,7 @@ module Imap::Backup
     def delete
       return if !exist?
 
+      Logger.logger.info("Deleting metadata file '#{pathname}'")
       FileUtils.rm(pathname)
       @loaded = false
       @messages = nil

data/lib/imap/backup/serializer/mbox.rb

@@ -70,6 +70,7 @@ module Imap::Backup
     def delete
       return if !exist?
 
+      Logger.logger.info("Deleting mailbox '#{pathname}'")
       FileUtils.rm(pathname)
     end
 

data/lib/imap/backup/serializer.rb

@@ -28,7 +28,41 @@ module Imap::Backup
     extend Forwardable
 
     def_delegator :mbox, :pathname, :mbox_pathname
-    def_delegators :imap, :get, :messages, :uid_validity, :uids, :update_uid
+
+    # Get message metadata
+    # @param uid [Integer] a message UID
+    # @return [Serializer::Message]
+    def get(uid)
+      validate!
+      imap.get(uid)
+    end
+
+    # @return [Array<Hash>]
+    def messages
+      validate!
+      imap.messages
+    end
+
+    # @return [Integer] the UID validity for the folder
+    def uid_validity
+      validate!
+      imap.uid_validity
+    end
+
+    # @return [Array<Integer>] The uids of all messages
+    def uids
+      validate!
+      imap.uids
+    end
+
+    # Update a message's metadata, replacing its UID
+    # @param old [Integer] the existing message UID
+    # @param new [Integer] the new UID to apply to the message
+    # @return [void]
+    def update_uid(old, new)
+      validate!
+      imap.update_uid(old, new)
+    end
 
     # @return [String] a folder name
     attr_reader :folder
@@ -62,10 +96,16 @@ module Imap::Backup
 
       optionally_migrate2to3
 
-      if imap.valid? && mbox.valid?
+      imap_valid = imap.valid?
+      mbox_valid = mbox.valid?
+      if imap_valid && mbox_valid
         @validated = true
         return true
       end
+      warn_imap = !imap_valid && imap.exist?
+      Logger.logger.info("Metadata file '#{imap.pathname}' is invalid") if warn_imap
+      warn_mbox = !mbox_valid && mbox.exist?
+      Logger.logger.info("Mailbox '#{mbox.pathname}' is invalid") if warn_mbox
 
       delete
 
@@ -247,6 +287,8 @@ module Imap::Backup
       MESSAGE
 
       migrator.run
+      # Ensure new metadata gets loaded
+      @imap = nil
     end
 
     def ensure_containing_directory

data/lib/imap/backup/version.rb

@@ -6,7 +6,7 @@ module Imap::Backup
   # @private
   MINOR    = 5
   # @private
-  REVISION = 0
+  REVISION = 2
   # @private
   PRE      = nil
   # The application version

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: imap-backup
 version: !ruby/object:Gem::Version
-  version: 14.5.0
+  version: 14.5.2
 platform: ruby
 authors:
 - Joe Yates
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-01-13 00:00:00.000000000 Z
+date: 2024-01-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: highline
@@ -233,7 +233,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.5.3
 signing_key: 
 specification_version: 4
 summary: Backup GMail (or other IMAP) accounts to disk