imap-backup 9.1.1 → 9.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5cf8072ca8c7a95ca74edc961352099b468a287e846c71c0243d5c2fc285e17
-  data.tar.gz: 8b66b63ed93044a9fe019ce5af838f165589a9f7b1eebe0751cc804891dacab2
+  metadata.gz: 2817e61358b848f7dbef08e1a16562def8cd364e66d317e4dac56c1f5e62f958
+  data.tar.gz: ec0e2d2963e863b204b0529ca3746492703486e8f77a9e7c08bc301b203249de
 SHA512:
-  metadata.gz: 79a410fe6b307969a27cafed38cd145951016c86c45f62033b91dd6b9df289993f4e134c42bd6ddabbb8b4a523534fdad18ea4b71cd40aa6656375c750c4aaf6
-  data.tar.gz: baf5eb4583afe8263f54cede96ad308f1b0ce507987b10adfba337eb899ecc456f22c9895cb18805a87ef486ba3712f150af17ca21beed5160081b3eb4c07ffe
+  metadata.gz: 66871fce3faebbcbd87737fef230803b46f32025b28753fe4f83813e652ef14817fce302da0570000f0d0ecb582862589a84f535a94aa1fa7cc1578eaf30591c
+  data.tar.gz: 274cfc47767322e31eb1e7206c3d1d449b2098ba1a65073c80aa5010c06924abfc7a952aeace01436715a7f95599503d86bcecbbdf210f7c8b5529bf7bee4fdf

data/lib/imap/backup/logger.rb

@@ -2,7 +2,7 @@ require "logger"
 require "singleton"
 
 require "imap/backup/configuration"
-require "imap/backup/sanitizer"
+require "text/sanitizer"
 
 module Imap::Backup
   class Logger
@@ -33,7 +33,7 @@ module Imap::Backup
     end
 
     def self.sanitize_stderr
-      sanitizer = Sanitizer.new($stdout)
+      sanitizer = Text::Sanitizer.new($stdout)
       previous_stderr = $stderr
       $stderr = sanitizer
       yield

data/lib/imap/backup/naming.rb

@@ -0,0 +1,25 @@
+module Imap::Backup
+  class Naming
+    INVALID_FILENAME_CHARACTERS = ":%;".freeze
+    INVALID_FILENAME_CHARACTER_MATCH = /([#{INVALID_FILENAME_CHARACTERS}])/.freeze
+
+    # `*_path` functions treat `/` as an acceptable character
+    def self.to_local_path(name)
+      name.gsub(INVALID_FILENAME_CHARACTER_MATCH) do |character|
+        hex =
+          character.
+          codepoints[0].
+          to_s(16)
+        "%#{hex};"
+      end
+    end
+
+    def self.from_local_path(name)
+      name.gsub(/%(.*?);/) do
+        ::Regexp.last_match(1).
+          to_i(16).
+          chr("UTF-8")
+      end
+    end
+  end
+end

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

@@ -1,4 +1,6 @@
 module Imap::Backup
+  class Serializer; end
+
   class Serializer::Appender
     attr_reader :imap
     attr_reader :folder

data/lib/imap/backup/serializer.rb

@@ -1,6 +1,7 @@
 require "forwardable"
 
 require "email/mboxrd/message"
+require "imap/backup/naming"
 require "imap/backup/serializer/appender"
 require "imap/backup/serializer/imap"
 require "imap/backup/serializer/message"
@@ -72,7 +73,7 @@ module Imap::Backup
     def append(uid, message, flags)
       validate!
 
-      appender = Serializer::Appender.new(folder: folder, imap: imap, mbox: mbox)
+      appender = Serializer::Appender.new(folder: sanitized, imap: imap, mbox: mbox)
       appender.run(uid: uid, message: message, flags: flags)
     end
 
@@ -116,14 +117,16 @@ module Imap::Backup
     end
 
     def folder_path
-      self.class.folder_path_for(path: path, folder: folder)
+      self.class.folder_path_for(path: path, folder: sanitized)
     end
 
     private
 
     def rename(new_name)
       destination = self.class.folder_path_for(path: path, folder: new_name)
-      ensure_containing_directory(new_name)
+      relative = File.dirname(new_name)
+      directory = Serializer::Directory.new(path, relative)
+      directory.ensure_exists
       mbox.rename destination
       imap.rename destination
     end
@@ -136,7 +139,7 @@ module Imap::Backup
     def mbox
       @mbox ||=
         begin
-          ensure_containing_directory(folder)
+          ensure_containing_directory
           Serializer::Mbox.new(folder_path)
         end
     end
@@ -144,11 +147,15 @@ module Imap::Backup
     def imap
       @imap ||=
         begin
-          ensure_containing_directory(folder)
+          ensure_containing_directory
           Serializer::Imap.new(folder_path)
         end
     end
 
+    def sanitized
+      @sanitized ||= Naming.to_local_path(folder)
+    end
+
     def optionally_migrate2to3
       migrator = Version2Migrator.new(folder_path)
       return if !migrator.required?
@@ -162,8 +169,8 @@ module Imap::Backup
       migrator.run
     end
 
-    def ensure_containing_directory(folder)
-      relative = File.dirname(folder)
+    def ensure_containing_directory
+      relative = File.dirname(sanitized)
       directory = Serializer::Directory.new(path, relative)
       directory.ensure_exists
     end

data/lib/imap/backup/version.rb

@@ -2,8 +2,8 @@ module Imap; end
 
 module Imap::Backup
   MAJOR    = 9
-  MINOR    = 1
-  REVISION = 1
+  MINOR    = 2
+  REVISION = 0
   PRE      = nil
   VERSION  = [MAJOR, MINOR, REVISION, PRE].compact.map(&:to_s).join(".")
 end

data/lib/text/sanitizer.rb

@@ -0,0 +1,46 @@
+require "forwardable"
+
+module Text; end
+
+class Text::Sanitizer
+  extend Forwardable
+
+  attr_reader :output
+
+  delegate puts: :output
+  delegate write: :output
+
+  def initialize(output)
+    @output = output
+    @current = ""
+  end
+
+  def print(*args)
+    @current << args.join
+    loop do
+      line, newline, rest = @current.partition("\n")
+      break if newline != "\n"
+
+      clean = sanitize(line)
+      output.puts clean
+      @current = rest
+    end
+  end
+
+  def flush
+    return if @current == ""
+
+    clean = sanitize(@current)
+    output.puts clean
+  end
+
+  private
+
+  def sanitize(text)
+    # Hide password in Net::IMAP debug output
+    text.gsub(
+      /\A(C: RUBY\d+ LOGIN \S+) \S+/,
+      "\\1 [PASSWORD REDACTED]"
+    )
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: imap-backup
 version: !ruby/object:Gem::Version
-  version: 9.1.1
+  version: 9.2.0
 platform: ruby
 authors:
 - Joe Yates
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-02-19 00:00:00.000000000 Z
+date: 2023-03-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: highline
@@ -258,7 +258,7 @@ files:
 - lib/imap/backup/migrator.rb
 - lib/imap/backup/mirror.rb
 - lib/imap/backup/mirror/map.rb
-- lib/imap/backup/sanitizer.rb
+- lib/imap/backup/naming.rb
 - lib/imap/backup/serializer.rb
 - lib/imap/backup/serializer/appender.rb
 - lib/imap/backup/serializer/directory.rb
@@ -282,6 +282,7 @@ files:
 - lib/imap/backup/utils.rb
 - lib/imap/backup/version.rb
 - lib/retry_on_error.rb
+- lib/text/sanitizer.rb
 homepage: https://github.com/joeyates/imap-backup
 licenses:
 - MIT

data/lib/imap/backup/sanitizer.rb

@@ -1,46 +0,0 @@
-require "forwardable"
-
-module Imap::Backup
-  class Sanitizer
-    extend Forwardable
-
-    attr_reader :output
-
-    delegate puts: :output
-    delegate write: :output
-
-    def initialize(output)
-      @output = output
-      @current = ""
-    end
-
-    def print(*args)
-      @current << args.join
-      loop do
-        line, newline, rest = @current.partition("\n")
-        break if newline != "\n"
-
-        clean = sanitize(line)
-        output.puts clean
-        @current = rest
-      end
-    end
-
-    def flush
-      return if @current == ""
-
-      clean = sanitize(@current)
-      output.puts clean
-    end
-
-    private
-
-    def sanitize(text)
-      # Hide password in Net::IMAP debug output
-      text.gsub(
-        /\A(C: RUBY\d+ LOGIN \S+) \S+/,
-        "\\1 [PASSWORD REDACTED]"
-      )
-    end
-  end
-end