doc:appunti:linux:sa:offlineimap3_nametrans
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
doc:appunti:linux:sa:offlineimap3_nametrans [2024/03/22 09:40] – niccolo | doc:appunti:linux:sa:offlineimap3_nametrans [2024/03/22 10:23] (current) – [The configuration file] niccolo | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== offlineimap3 IMAP syncronization: | ====== offlineimap3 IMAP syncronization: | ||
+ | |||
+ | In this page we study a case of IMAP syncronization from a source IMAP server to a Maildir structure on local disk, using the **[[https:// | ||
+ | |||
+ | The main issue is the need to **map the source directory tree** into a tree compatible with the receiving Maildir hierarchy. Here are the issues: | ||
+ | |||
+ | The **source IMAP** server has the following characteristics: | ||
+ | |||
+ | * The directory separator is the "/" | ||
+ | * Some subfolders are stored into the INBOX, but others are stored at the top level. | ||
+ | * Some subfolders have names containing the " | ||
+ | |||
+ | The **destination Maildir** has the following characteristics: | ||
+ | |||
+ | * The directory separator is the " | ||
+ | * All the subfolders must be under the INBOX. | ||
+ | * The " | ||
+ | |||
+ | In this case we need a very special **nametrans** expression into the [[https:// | ||
+ | |||
+ | :!: **NOTICE**: The mapping of the top-level folders under the INBOX during the transfer from IMAP to Maildir prevents the reverse mapping from Maildir to IMAP, therefore only synchronization from IMAP to Maildir will be possible and not vice versa. | ||
+ | |||
+ | ===== Testing the nametrans option ===== | ||
+ | |||
+ | It is possibile to write a simple Python script to test the **nametrans** expression: | ||
<code python> | <code python> | ||
Line 31: | Line 55: | ||
print(' | print(' | ||
</ | </ | ||
+ | |||
+ | Running the script you can verify that directories from the source IMAP server will be mapped to the local Maildir: | ||
+ | |||
+ | < | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | " | ||
+ | </ | ||
+ | |||
+ | :!: **NOTICE**: The translated name of a sub-subfolder contains the original **directory separator** (.e.g. '' | ||
+ | |||
+ | ===== The configuration file ===== | ||
+ | |||
+ | This is the overall **offlineimap.conf** file: | ||
+ | |||
+ | < | ||
+ | [general] | ||
+ | accounts = CopyFromIMAP | ||
+ | |||
+ | [Account CopyFromIMAP] | ||
+ | remoterepository = OldServer | ||
+ | localrepository = NewServer | ||
+ | |||
+ | [Repository OldServer] | ||
+ | type = IMAP | ||
+ | nametrans = lambda foldername: re.sub(r' | ||
+ | remotehost = mail.oldserver.com | ||
+ | remoteuser = username@oldserver.com | ||
+ | remotepass = MySecret | ||
+ | createfolders = False | ||
+ | |||
+ | [Repository NewServer] | ||
+ | type = Maildir | ||
+ | localfolders = / | ||
+ | </ | ||
+ | |||
+ | Notice the '' | ||
+ | |||
+ | To run the command with some debugging: | ||
+ | |||
+ | < | ||
+ | offlineimap -1 -c ./ | ||
+ | </ | ||
+ | |||
+ | ===== Web References ===== | ||
+ | |||
+ | * **[[https:// | ||
+ |
doc/appunti/linux/sa/offlineimap3_nametrans.txt · Last modified: 2024/03/22 10:23 by niccolo