imap-backup 14.4.4 → 14.4.5

data/docs/development.md

@@ -1,110 +0,0 @@
-# Repository
-
-After cloning the repo, run the following command to get
-better `git blame` output:
-
-```sh
-git config --local blame.ignoreRevsFile .git-blame-ignore-revs
-```
-
-# Design Goals
-
-* Secure - use a local configuration file protected by permissions
-* Restartable - calculate start point based on already downloaded messages
-* Standalone - do not rely on an email client or MTA
-
-# Testing
-
-## Feature Specs
-
-Specs under `specs/features` are integration specs.
-Some of these specs run against two local IMAP servers
-controlled by Podman (or Docker) Compose.
-
-Start them before running the test suite
-
-```sh
-$ podman-compose -f dev/compose.yml up -d
-```
-
-or, with Podman
-
-```sh
-$ podman-compose -f dev/compose.yml up -d
-```
-
-Then, run all specs
-
-```sh
-$ rspec
-```
-
-To exclude container-based tests
-
-```sh
-$ rspec --tag ~docker
-```
-
-To run **just** the feature specs
-
-```sh
-rspec spec/features/**/*_spec.rb
-```
-
-## Full Test Run
-
-The full test run includes RSpec specs **and** Runbocop checks
-
-```sh
-rake
-```
-
-# Older Rubies
-
-A Containerfile is available to allow testing with all available Ruby versions,
-see the README in the `dev` directory.
-
-# Performance Specs
-
-```sh
-PERFORMANCE=1 rspec --order=defined
-```
-
-Beware: the performance spec (just backup for now) takes a very
-long time to run, approximately 24 hours!
-
-### Debugging
-
-The feature specs are run 'out of process' via the Aruba gem.
-In order to see debugging output from the process,
-use `last_command_started.output`.
-
-## Access Docker imap server
-
-```ruby
-require "net/imap"
-require_relative "spec/features/support/30_email_server_helpers"
-
-include EmailServerHelpers
-
-test_connection = test_server_connection_parameters
-
-test_imap = Net::IMAP.new(test_connection[:server], test_connection[:connection_options])
-test_imap.login(test_connection[:username], test_connection[:password])
-
-message = "From: #{test_connection[:username]}\nSubject: Some Subject\n\nHello!\n"
-response = test_imap.append("INBOX", message, nil, nil)
-
-test_imap.examine("INBOX")
-uids = test_imap.uid_search(["ALL"]).sort
-
-fetch_data_items = test_imap.uid_fetch(uids, ["BODY[]"])
-```
-
-# Contributing
-
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Added some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request

data/docs/migrate-server-keep-address.md

@@ -1,47 +0,0 @@
-# Migrate to a new e-mail server while keeping your existing address
-
-While switching e-mail provider (from provider `A` to `B`),
-you might want to keep the same address (`mymail@domain.com`),
-and copy all your existing e-mails to your new server `B`.
-`imap-backup` can do that too!
-
-It is best to use [`imap-backup migrate`](/docs/commands/migrate.md)
-and not [`imap-backup restore`](/docs/commands/restore.md) here because
-`migrate` simply copies emails to folders with the same name as the ones
-they were downloaded from, while `restore` changes the names of restored
-folders if folders with the same name already exist on the destination server.
-
-1. Backup your e-mails: use [`imap-backup setup`](/docs/commands/setup.md)
-  to setup connection to your old provider `A`,
-  then launch [`imap-backup backup`](/docs/commands/backup.md).
-1. Actually switch your e-mail service provider (update your DNS MX and all that...).
-1. As both the source and the destination have the same address,
-  you need to manually rename your old account first:
-
-    1. Modify your configuration file manually
-      (i.e. not via `imap-backup setup`) and
-      rename your account to `mymail-old@domain.com`:
-
-        ```diff
-          "accounts": [
-            {
-        -     "username": "mymail@domain.com",
-        +     "username": "mymail-old@domain.com",
-              "password": "...",
-        -     "local_path": "/some/path/.imap-backup/mymail_domain.com",
-        +     "local_path": "/some/path/.imap-backup/mymail-old_domain.com",
-              "folders": [...],
-              "server": "..."
-            }
-        ```
-
-    1. Rename the backup directory from `mymail_domain.com`
-      to `mymail-old_domain.com`.
-
-1. Set up a new account giving access to the new provider `B`
-  using `imap-backup setup`.
-1. Now you can use `imap-backup migrate`, optionally adapting
-  [delimiters and prefixes configuration](/docs/delimiters-and-prefixes.md)
-  if need be:
-
-		imap-backup migrate mymail-old@domain.com mymail@domain.com [options]