appender.rb in imap-backup-14.4.3

- old
+ new

@@ -3,21 +3,20 @@
 module Imap; end
 
 module Imap::Backup
   class Serializer; end
 
+  # Appends messages to the local store
   class Serializer::Appender
-    attr_reader :imap
-    attr_reader :folder
-    attr_reader :mbox
-
     def initialize(folder:, imap:, mbox:)
       @folder = folder
       @imap = imap
       @mbox = mbox
     end
 
+    # Adds a message to the metadata file and the mailbox.
+    # Wraps any errors with information about the message that caused them.
     def append(uid:, message:, flags:)
       raise "Can't add messages without uid_validity" if !imap.uid_validity
 
       uid = uid.to_i
       existing = imap.get(uid)
@@ -53,9 +52,13 @@
         )
       end
     end
 
     private
+
+    attr_reader :imap
+    attr_reader :folder
+    attr_reader :mbox
 
     def wrap_error(error:, note:, folder:, uid:, message:)
       <<-ERROR.gsub(/^\s*/m, "")
         [#{folder}] #{note} #{uid}: #{message}.
         #{error}: