imap-backup 4.0.1 → 4.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 97ae9089aa19dee6fcf7a1c211091671a6befe882d5b664654a25d6d10e81704
-  data.tar.gz: 2677746ed662c457a738033224da11a40a76367e4031e7636b33391d51ee4659
+  metadata.gz: 14c0bd789a2532461bbfbe92dd3bb2466228fe0d14b676c308f766a5c62941cf
+  data.tar.gz: 06203ea6c126b17b26f784f2f91f3dd72d1bfd431fe100428931d624de85c53e
 SHA512:
-  metadata.gz: 5e97ba8ab64e27924166609c1cb80e52dbfa8136b4248324a7589e143d64ebddbb415ad6c4c7a0e472732db55c717d14e08be47c7640efcb36029c80b10938ef
-  data.tar.gz: 2fd74f2b86946b79d07a1354a55b00444022838fcd4968a6a2f0dc15494f4c2d80d0ea06b1e0290b921e7f2242566a56fb8e9bd6bf03b5a88595871c91d08604
+  metadata.gz: a4de838badaaf992ae6ff46d590bb782810f4dae83aeeb9bd1495525bddfc396341374e18c51bec2e71a1cf66135335f2e21bdd6632ced9f64bc81f93f4eafe1
+  data.tar.gz: 20cc1c12289c753a3814205fd7cf125a2b234b567301a37f88da65b7f86b26a66274209fc8e2218975877f6568df3d991f1db03f76fe4262c8415adc3a59d6e6

data/docs/development.md

@@ -2,18 +2,12 @@
 
 ## Integration Tests
 
-Integration tests (feature specs) are run against a Docker image
-(antespi/docker-imap-devel:latest).
-
-In one shell, run the Docker image:
+Integration tests (feature specs) are run against a local IMAP server
+controlled by Docker Compose, which needs to be started
+before running the test suite.
 
 ```sh
-$ docker run \
-  --env MAIL_ADDRESS=address@example.org \
-  --env MAIL_PASS=pass \
-  --env MAILNAME=example.org \
-  --publish 8993:993 \
-  antespi/docker-imap-devel:latest
+$ docker-compose up -d
 ```
 
 ```sh

data/imap-backup.gemspec

@@ -17,10 +17,6 @@ Gem::Specification.new do |gem|
   gem.files         += %w[imap-backup.gemspec]
   gem.files         += %w[LICENSE README.md]
 
-  gem.extra_rdoc_files += Dir.glob("README.md")
-  gem.extra_rdoc_files += Dir.glob("docs/*.md")
-  gem.rdoc_options = ["--main", "README.md"]
-
   gem.executables   = gem.files.grep(%r{^bin/}).map { |f| File.basename(f) }
   gem.test_files    = Dir.glob("spec/**/*{.rb,.yml}")
   gem.require_paths = ["lib"]

data/lib/email/mboxrd/message.rb

@@ -1,9 +1,13 @@
+require "forwardable"
 require "mail"
 
 module Email; end
 
 module Email::Mboxrd
   class Message
+    extend Forwardable
+    def_delegators :@parsed, :subject
+
     attr_reader :supplied_body
 
     def self.from_serialized(serialized)
@@ -36,12 +40,12 @@ module Email::Mboxrd
       supplied_body.gsub(/(?<!\r)\n/, "\r\n")
     end
 
+    private
+
     def parsed
       @parsed ||= Mail.new(supplied_body)
     end
 
-    private
-
     def from
       @from ||=
         begin

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

@@ -5,6 +5,19 @@ module Imap::Backup::CLI::Helpers
     options.each.with_object({}) { |(k, v), acc| acc[k.intern] = v }
   end
 
+  def account(email)
+    connections = Imap::Backup::Configuration::List.new
+    account = connections.accounts.find { |a| a[:username] == email }
+    raise "#{email} is not a configured account" if !account
+    account
+  end
+
+  def connection(email)
+    account = account(email)
+
+    Imap::Backup::Account::Connection.new(account)
+  end
+
   def each_connection(names)
     begin
       connections = Imap::Backup::Configuration::List.new(names)

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

@@ -6,49 +6,43 @@ module Imap::Backup
     desc "accounts", "List locally backed-up accounts"
     def accounts
       connections = Imap::Backup::Configuration::List.new
-      connections.accounts.each { |a| puts a[:username] }
+      connections.accounts.each { |a| Kernel.puts a[:username] }
     end
 
     desc "folders EMAIL", "List account folders"
     def folders(email)
-      connections = Imap::Backup::Configuration::List.new
-      account = connections.accounts.find { |a| a[:username] == email }
-      raise "#{email} is not a configured account" if !account
+      connection = connection(email)
 
-      account_connection = Imap::Backup::Account::Connection.new(account)
-      account_connection.local_folders.each do |_s, f|
-        puts %("#{f.name}")
+      connection.local_folders.each do |_s, f|
+        Kernel.puts %("#{f.name}")
       end
     end
 
     desc "list EMAIL FOLDER", "List emails in a folder"
     def list(email, folder_name)
-      connections = Imap::Backup::Configuration::List.new
-      account = connections.accounts.find { |a| a[:username] == email }
-      raise "#{email} is not a configured account" if !account
+      connection = connection(email)
 
-      account_connection = Imap::Backup::Account::Connection.new(account)
-      folder_serializer, _folder = account_connection.local_folders.find do |(_s, f)|
+      folder_serializer, _folder = connection.local_folders.find do |(_s, f)|
         f.name == folder_name
       end
       raise "Folder '#{folder_name}' not found" if !folder_serializer
 
       max_subject = 60
-      puts format("%-10<uid>s  %-#{max_subject}<subject>s - %<date>s", {uid: "UID", subject: "Subject", date: "Date"})
-      puts "-" * (12 + max_subject + 28)
+      Kernel.puts format("%-10<uid>s  %-#{max_subject}<subject>s - %<date>s", {uid: "UID", subject: "Subject", date: "Date"})
+      Kernel.puts "-" * (12 + max_subject + 28)
 
       uids = folder_serializer.uids
 
       folder_serializer.each_message(uids).map do |uid, message|
         m = {
           uid: uid,
-          date: message.parsed.date.to_s,
-          subject: message.parsed.subject || ""
+          date: message.date.to_s,
+          subject: message.subject || ""
         }
         if m[:subject].length > max_subject
-          puts format("% 10<uid>u: %.#{max_subject - 3}<subject>s... - %<date>s", m)
+          Kernel.puts format("% 10<uid>u: %.#{max_subject - 3}<subject>s... - %<date>s", m)
         else
-          puts format("% 10<uid>u: %-#{max_subject}<subject>s - %<date>s", m)
+          Kernel.puts format("% 10<uid>u: %-#{max_subject}<subject>s - %<date>s", m)
         end
       end
     end
@@ -60,12 +54,9 @@ module Imap::Backup
       the UID.
     DESC
     def show(email, folder_name, uids)
-      connections = Imap::Backup::Configuration::List.new
-      account = connections.accounts.find { |a| a[:username] == email }
-      raise "#{email} is not a configured account" if !account
+      connection = connection(email)
 
-      account_connection = Imap::Backup::Account::Connection.new(account)
-      folder_serializer, _folder = account_connection.local_folders.find do |(_s, f)|
+      folder_serializer, _folder = connection.local_folders.find do |(_s, f)|
         f.name == folder_name
       end
       raise "Folder '#{folder_name}' not found" if !folder_serializer
@@ -73,13 +64,13 @@ module Imap::Backup
       uid_list = uids.split(",")
       folder_serializer.each_message(uid_list).each do |uid, message|
         if uid_list.count > 1
-          puts <<~HEADER
+          Kernel.puts <<~HEADER
             #{'-' * 80}
             #{format('| UID: %-71s |', uid)}
             #{'-' * 80}
           HEADER
         end
-        puts message.supplied_body
+        Kernel.puts message.supplied_body
       end
     end
   end

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

@@ -1,26 +1,64 @@
+require "imap/backup/thunderbird/mailbox_exporter"
+
 module Imap::Backup
   class CLI::Utils < Thor
     include Thor::Actions
+    include CLI::Helpers
 
     FAKE_EMAIL = "fake@email.com"
 
     desc "ignore-history EMAIL", "Skip downloading emails up to today for all configured folders"
     def ignore_history(email)
-      connections = Imap::Backup::Configuration::List.new
-      account = connections.accounts.find { |a| a[:username] == email }
-      raise "#{email} is not a configured account" if !account
-
-      connection = Imap::Backup::Account::Connection.new(account)
+      connection = connection(email)
 
-      connection.local_folders.each do |_s, f|
+      connection.local_folders.each do |serializer, folder|
         next if !folder.exist?
-        do_ignore_folder_history(connection, folder)
+        do_ignore_folder_history(folder, serializer)
+      end
+    end
+
+    desc "export-to-thunderbird EMAIL [OPTIONS]",
+      <<~DOC
+        [Experimental] Copy backed up emails to Thunderbird.
+        A folder called 'imap-backup/EMAIL' is created under 'Local Folders'.
+      DOC
+    method_option(
+      "force",
+      type: :boolean,
+      banner: "overwrite existing mailboxes",
+      aliases: ["-f"]
+    )
+    method_option(
+      "profile",
+      type: :string,
+      banner: "the name of the Thunderbird profile to copy emails to",
+      aliases: ["-p"]
+    )
+    def export_to_thunderbird(email)
+      opts = symbolized(options)
+      force = opts.key?(:force) ? opts[:force] : false
+      profile_name = opts[:profile]
+
+      connection = connection(email)
+      profile = thunderbird_profile(profile_name)
+
+      if !profile
+        if profile_name
+          raise "Thunderbird profile '#{profile_name}' not found"
+        else
+          raise "Default Thunderbird profile not found"
+        end
+      end
+
+      connection.local_folders.each do |serializer, folder|
+        Thunderbird::MailboxExporter.new(
+          email, serializer, profile, force: force
+        ).run
       end
     end
 
     no_commands do
-      def do_ignore_folder_history(connection, folder)
-        serializer = Imap::Backup::Serializer::Mbox.new(connection.local_path, folder.name)
+      def do_ignore_folder_history(folder, serializer)
         uids = folder.uids - serializer.uids
         Imap::Backup.logger.info "Folder '#{folder.name}' - #{uids.length} messages"
 
@@ -36,6 +74,14 @@ module Imap::Backup
           serializer.save(uid, message)
         end
       end
+
+      def thunderbird_profile(name = nil)
+        if name
+          Thunderbird::Profiles.new.profile(name)
+        else
+          Thunderbird::Profiles.new.default
+        end
+      end
     end
   end
 end

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

@@ -1,7 +1,12 @@
+require "forwardable"
+
 require "imap/backup/serializer/mbox_store"
 
 module Imap::Backup
   class Serializer::Mbox
+    extend Forwardable
+    def_delegators :store, :mbox_pathname
+
     attr_reader :path
     attr_reader :folder
 

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

@@ -121,6 +121,14 @@ module Imap::Backup
       @folder = new_name
     end
 
+    def mbox_pathname
+      absolute_path("#{folder}.mbox")
+    end
+
+    def imap_pathname
+      absolute_path("#{folder}.imap")
+    end
+
     private
 
     def do_load
@@ -205,13 +213,5 @@ module Imap::Backup
     def absolute_path(relative_path)
       File.join(path, relative_path)
     end
-
-    def mbox_pathname
-      absolute_path("#{folder}.mbox")
-    end
-
-    def imap_pathname
-      absolute_path("#{folder}.imap")
-    end
   end
 end

data/lib/imap/backup/thunderbird/mailbox_exporter.rb

@@ -0,0 +1,71 @@
+require "thunderbird/local_folder"
+require "thunderbird/mailbox"
+require "thunderbird/profiles"
+
+module Imap::Backup
+  class Thunderbird::MailboxExporter
+    EXPORT_PREFIX = "imap-backup"
+
+    attr_reader :email
+    attr_reader :serializer
+    attr_reader :profile
+    attr_reader :force
+
+    def initialize(email, serializer, profile, force: false)
+      @email = email
+      @serializer = serializer
+      @profile = profile
+      @force = force
+    end
+
+    def run
+      local_folder.set_up
+
+      if mailbox.msf_exists?
+        if force
+          Kernel.puts "Deleting '#{mailbox.msf_path}' as --force option was supplied"
+          File.unlink mailbox.msf_path
+        else
+          Kernel.puts "Skipping export of '#{folder.name}' as '#{mailbox.msf_path}' exists"
+          return false
+        end
+      end
+
+      if mailbox.exists?
+        if force
+          Kernel.puts "Overwriting '#{mailbox.path}' as --force option was supplied"
+        else
+          Kernel.puts "Skipping export of '#{folder.name}' as '#{mailbox.path}' exists"
+          return false
+        end
+      end
+
+      FileUtils.cp serializer.mbox_pathname, mailbox.path
+
+      true
+    end
+
+    private
+
+    def local_folder
+      @local_folder ||= begin
+        folder_path = File.dirname(serializer.folder)
+        top_level_folders = [EXPORT_PREFIX, email]
+        prefixed_folder_path =
+          if folder_path == "."
+            File.join(top_level_folders)
+          else
+            File.join(top_level_folders, folder_path)
+          end
+        Thunderbird::LocalFolder.new(profile, prefixed_folder_path)
+      end
+    end
+
+    def mailbox
+      @mailbox ||= begin
+        mailbox_name = File.basename(serializer.folder)
+        Thunderbird::Mailbox.new(local_folder, mailbox_name)
+      end
+    end
+  end
+end

data/lib/imap/backup/version.rb

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

data/lib/thunderbird/local_folder.rb

@@ -0,0 +1,97 @@
+require "thunderbird/profile"
+require "thunderbird/local_folder_placeholder"
+
+class Thunderbird::LocalFolder
+  attr_reader :folder_path
+  attr_reader :profile
+
+  def initialize(profile, folder_path)
+    @profile = profile
+    @folder_path = folder_path
+  end
+
+  def local_folder_placeholder
+    if parent
+      path = File.join(parent.full_path, folder_path_elements[-1])
+      Thunderbird::LocalFolderPlaceholder.new(path)
+    end
+  end
+
+  def directory_is_directory?
+    File.directory?(full_path)
+  end
+
+  def full_path
+    File.join(profile.local_folders_path, relative_path)
+  end
+
+  def parent
+    if folder_path_elements.count > 0
+      self.class.new(profile, File.join(folder_path_elements[0..-2]))
+    end
+  end
+
+  def folder_path_elements
+    folder_path.split(File::SEPARATOR)
+  end
+
+  def directory_exists?
+    File.exists?(full_path)
+  end
+
+  def is_directory?
+    File.directory?(full_path)
+  end
+
+  def subdirectories
+    folder_path_elements.map { |p| "#{p}.sbd" }
+  end
+
+  def relative_path
+    File.join(subdirectories)
+  end
+
+  def set_up
+    ok = check
+    return if !ok
+
+    ensure_initialized
+  end
+
+  private
+
+  def ensure_initialized
+    return true if !parent
+
+    parent.ensure_initialized
+
+    local_folder_placeholder.ensure_initialized
+
+    FileUtils.mkdir_p full_path
+  end
+
+  def check
+    return true if !parent
+
+    parent_ok = parent.check
+
+    return if !parent_ok
+
+    case
+    when local_folder_placeholder.exists? && !directory_exists?
+      Kernel.puts "Can't set up folder '#{folder_path}': '#{local_folder_placeholder.path}' exists, but '#{full_path}' is missing"
+      false
+    when directory_exists? && !local_folder_placeholder.exists?
+      Kernel.puts "Can't set up folder '#{folder_path}': '#{full_path}' exists, but '#{local_folder_placeholder.path}' is missing"
+      false
+    when local_folder_placeholder.exists? && !local_folder_placeholder.is_regular?
+      Kernel.puts "Can't set up folder '#{folder_path}': '#{local_folder_placeholder.path}' exists, but it is not a regular file"
+      false
+    when directory_exists? && !is_directory?
+      Kernel.puts "Can't set up folder '#{folder_path}': '#{full_path}' exists, but it is not a directory"
+      false
+    else
+      true
+    end
+  end
+end

data/lib/thunderbird/local_folder_placeholder.rb

@@ -0,0 +1,21 @@
+# Each subdirectory is "accompanied" by a blank
+# file of the same name (without the '.sbd' extension)
+class Thunderbird::LocalFolderPlaceholder
+  attr_reader :path
+
+  def initialize(path)
+    @path = path
+  end
+
+  def exists?
+    File.exists?(path)
+  end
+
+  def is_regular?
+    File.file?(path)
+  end
+
+  def ensure_initialized
+    FileUtils.touch path
+  end
+end

data/lib/thunderbird/mailbox.rb

@@ -0,0 +1,25 @@
+class Thunderbird::Mailbox
+  attr_reader :local_folder
+  attr_reader :name
+
+  def initialize(local_folder, name)
+    @local_folder = local_folder
+    @name = name
+  end
+
+  def path
+    File.join(local_folder.full_path, name)
+  end
+
+  def exists?
+    File.exists?(path)
+  end
+
+  def msf_path
+    path + ".msf"
+  end
+
+  def msf_exists?
+    File.exists?(msf_path)
+  end
+end

data/lib/thunderbird/profile.rb

@@ -0,0 +1,30 @@
+require "thunderbird"
+
+class Thunderbird::Profile
+  attr_reader :title
+  attr_reader :entries
+
+  # entries are lines from profile.ini
+  def initialize(title, entries)
+    @title = title
+    @entries = entries
+  end
+
+  def root
+    if relative?
+      File.join(Thunderbird.new.data_path, entries[:Path])
+    else
+      entries[:Path]
+    end
+  end
+
+  def local_folders_path
+    File.join(root, "Mail", "Local Folders")
+  end
+
+  private
+
+  def relative?
+    entries[:IsRelative] == "1"
+  end
+end

data/lib/thunderbird/profiles.rb

@@ -0,0 +1,63 @@
+require "thunderbird"
+require "thunderbird/profile"
+
+# http://kb.mozillazine.org/Profiles.ini_file
+class Thunderbird::Profiles
+  def default
+    title, entries = blocks.find { |_name, entries| entries[:Default] == "1" }
+
+    Thunderbird::Profile.new(title, entries) if title
+  end
+
+  def profile(name)
+    title, entries = blocks.find { |_name, entries| entries[:Name] == name }
+
+    return nil if !title
+
+    Thunderbird::Profile.new(title, entries) if title
+  end
+
+  private
+
+  # Parse profiles.ini.
+  # Blocks start with a title, e.g. '[Abc]'
+  # and are followed by a number of lines
+  def blocks
+    @blocks ||= begin
+      blocks = {}
+      File.open(profiles_ini_path, "rb") do |f|
+        title = nil
+        entries = nil
+
+        loop do
+          line = f.gets
+          break if !line
+          line.chomp!
+
+          # Is this line the start of a new block
+          match = line.match(/\A\[([A-Za-z0-9]+)\]\z/)
+          if match
+            # Store what we got before this title as a new block
+            blocks[title] = entries if title
+
+            # Start a new block
+            title = match[1]
+            entries = {}
+          else
+            # Collect entries until we get to the next title
+            if line != ""
+              key, value = line.split("=")
+              entries[key.to_sym] = value
+            end
+          end
+        end
+      end
+
+      blocks
+    end
+  end
+
+  def profiles_ini_path
+    File.join(Thunderbird.new.data_path, "profiles.ini")
+  end
+end

data/lib/thunderbird.rb

@@ -0,0 +1,6 @@
+class Thunderbird
+  def data_path
+    # TODO: Handle other OSes
+    File.join(Dir.home, ".thunderbird")
+  end
+end

data/spec/unit/imap/backup/cli/local_spec.rb

@@ -0,0 +1,70 @@
+describe Imap::Backup::CLI::Local do
+  let(:list) do
+    instance_double(Imap::Backup::Configuration::List, accounts: accounts)
+  end
+  let(:accounts) { [{username: email}] }
+  let(:connection) do
+    instance_double(
+      Imap::Backup::Account::Connection,
+      local_folders: local_folders
+    )
+  end
+  let(:local_folders) { [[serializer, folder]] }
+  let(:folder) { instance_double(Imap::Backup::Account::Folder, name: "bar") }
+  let(:serializer) do
+    instance_double(
+      Imap::Backup::Serializer::Mbox,
+      uids: uids,
+      each_message: [[123, message]]
+    )
+  end
+  let(:uids) { ["123"] }
+  let(:message) do
+    instance_double(
+      Email::Mboxrd::Message,
+      date: Date.today,
+      subject: "Ciao",
+      supplied_body: "Supplied"
+    )
+  end
+  let(:email) { "foo@example.com" }
+
+  before do
+    allow(Kernel).to receive(:puts)
+    allow(Imap::Backup::Configuration::List).to receive(:new) { list }
+    allow(Imap::Backup::Account::Connection).to receive(:new) { connection }
+    allow(Mail).to receive(:new) { mail }
+  end
+
+  describe "accounts" do
+    it "lists configured emails" do
+      subject.accounts
+
+      expect(Kernel).to have_received(:puts).with(email)
+    end
+  end
+
+  describe "folders" do
+    it "lists downloaded folders in quotes" do
+      subject.folders(email)
+
+      expect(Kernel).to have_received(:puts).with(%("bar"))
+    end
+  end
+
+  describe "list" do
+    it "lists downloaded emails" do
+      subject.list(email, "bar")
+
+      expect(Kernel).to have_received(:puts).with(/Ciao/)
+    end
+  end
+
+  describe "show" do
+    it "prints a downloaded email" do
+      subject.show(email, "bar", "123")
+
+      expect(Kernel).to have_received(:puts).with("Supplied")
+    end
+  end
+end

data/spec/unit/imap/backup/cli/utils_spec.rb

@@ -0,0 +1,50 @@
+describe Imap::Backup::CLI::Utils do
+  let(:list) do
+    instance_double(Imap::Backup::Configuration::List, accounts: accounts)
+  end
+  let(:accounts) { [{username: email}] }
+  let(:connection) do
+    instance_double(
+      Imap::Backup::Account::Connection,
+      local_folders: local_folders
+    )
+  end
+  let(:local_folders) { [[serializer, folder]] }
+  let(:folder) do
+    instance_double(
+      Imap::Backup::Account::Folder,
+      exist?: true,
+      name: "name",
+      uid_validity: "uid_validity",
+      uids: ["123", "456"]
+    )
+  end
+  let(:serializer) do
+    instance_double(
+      Imap::Backup::Serializer::Mbox,
+      uids: ["123", "789"],
+      apply_uid_validity: nil,
+      save: nil
+    )
+  end
+  let(:email) { "foo@example.com" }
+
+  before do
+    allow(Imap::Backup::Configuration::List).to receive(:new) { list }
+    allow(Imap::Backup::Account::Connection).to receive(:new) { connection }
+  end
+
+  describe "ignore_history" do
+    it "ensures the local UID validity matches the server" do
+      subject.ignore_history(email)
+
+      expect(serializer).to have_received(:apply_uid_validity).with("uid_validity")
+    end
+
+    it "fills the local folder with fake emails" do
+      subject.ignore_history(email)
+
+      expect(serializer).to have_received(:save).with("456", /From: fake@email.com/)
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: imap-backup
 version: !ruby/object:Gem::Version
-  version: 4.0.1
+  version: 4.0.2
 platform: ruby
 authors:
 - Joe Yates
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-12-06 00:00:00.000000000 Z
+date: 2021-12-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: highline
@@ -156,11 +156,7 @@ email:
 executables:
 - imap-backup
 extensions: []
-extra_rdoc_files:
-- README.md
-- docs/setup.md
-- docs/restore.md
-- docs/development.md
+extra_rdoc_files: []
 files:
 - LICENSE
 - README.md
@@ -195,10 +191,17 @@ files:
 - lib/imap/backup/serializer/mbox.rb
 - lib/imap/backup/serializer/mbox_enumerator.rb
 - lib/imap/backup/serializer/mbox_store.rb
+- lib/imap/backup/thunderbird/mailbox_exporter.rb
 - lib/imap/backup/uploader.rb
 - lib/imap/backup/utils.rb
 - lib/imap/backup/version.rb
 - lib/retry_on_error.rb
+- lib/thunderbird.rb
+- lib/thunderbird/local_folder.rb
+- lib/thunderbird/local_folder_placeholder.rb
+- lib/thunderbird/mailbox.rb
+- lib/thunderbird/profile.rb
+- lib/thunderbird/profiles.rb
 - spec/features/backup_spec.rb
 - spec/features/helper.rb
 - spec/features/restore_spec.rb
@@ -217,6 +220,8 @@ files:
 - spec/unit/email/provider_spec.rb
 - spec/unit/imap/backup/account/connection_spec.rb
 - spec/unit/imap/backup/account/folder_spec.rb
+- spec/unit/imap/backup/cli/local_spec.rb
+- spec/unit/imap/backup/cli/utils_spec.rb
 - spec/unit/imap/backup/configuration/account_spec.rb
 - spec/unit/imap/backup/configuration/asker_spec.rb
 - spec/unit/imap/backup/configuration/connection_tester_spec.rb
@@ -236,9 +241,7 @@ licenses:
 - MIT
 metadata: {}
 post_install_message: 
-rdoc_options:
-- "--main"
-- README.md
+rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
@@ -252,40 +255,42 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: Backup GMail (or other IMAP) accounts to disk
 test_files:
 - spec/spec_helper.rb
+- spec/fixtures/connection.yml
+- spec/unit/email/provider_spec.rb
+- spec/unit/email/mboxrd/message_spec.rb
 - spec/unit/imap/backup_spec.rb
-- spec/unit/imap/backup/configuration/account_spec.rb
-- spec/unit/imap/backup/configuration/list_spec.rb
+- spec/unit/imap/backup/cli/utils_spec.rb
+- spec/unit/imap/backup/cli/local_spec.rb
+- spec/unit/imap/backup/utils_spec.rb
+- spec/unit/imap/backup/downloader_spec.rb
+- spec/unit/imap/backup/configuration/store_spec.rb
 - spec/unit/imap/backup/configuration/connection_tester_spec.rb
-- spec/unit/imap/backup/configuration/setup_spec.rb
 - spec/unit/imap/backup/configuration/asker_spec.rb
+- spec/unit/imap/backup/configuration/setup_spec.rb
 - spec/unit/imap/backup/configuration/folder_chooser_spec.rb
-- spec/unit/imap/backup/configuration/store_spec.rb
+- spec/unit/imap/backup/configuration/account_spec.rb
+- spec/unit/imap/backup/configuration/list_spec.rb
+- spec/unit/imap/backup/account/folder_spec.rb
+- spec/unit/imap/backup/account/connection_spec.rb
 - spec/unit/imap/backup/serializer/mbox_spec.rb
 - spec/unit/imap/backup/serializer/mbox_store_spec.rb
 - spec/unit/imap/backup/serializer/mbox_enumerator_spec.rb
-- spec/unit/imap/backup/downloader_spec.rb
 - spec/unit/imap/backup/uploader_spec.rb
-- spec/unit/imap/backup/account/folder_spec.rb
-- spec/unit/imap/backup/account/connection_spec.rb
-- spec/unit/imap/backup/utils_spec.rb
-- spec/unit/email/mboxrd/message_spec.rb
-- spec/unit/email/provider_spec.rb
+- spec/support/fixtures.rb
+- spec/support/shared_examples/account_flagging.rb
+- spec/support/higline_test_helpers.rb
+- spec/support/silence_logging.rb
+- spec/gather_rspec_coverage.rb
 - spec/features/backup_spec.rb
 - spec/features/helper.rb
-- spec/features/restore_spec.rb
-- spec/features/support/email_server.rb
 - spec/features/support/backup_directory.rb
-- spec/features/support/shared/connection_context.rb
 - spec/features/support/shared/message_fixtures.rb
-- spec/support/fixtures.rb
-- spec/support/silence_logging.rb
-- spec/support/higline_test_helpers.rb
-- spec/support/shared_examples/account_flagging.rb
-- spec/fixtures/connection.yml
-- spec/gather_rspec_coverage.rb
+- spec/features/support/shared/connection_context.rb
+- spec/features/support/email_server.rb
+- spec/features/restore_spec.rb