The way out of an archive for anything that doesn't speak JMAP. This is the neutral export: mail, contacts, calendars and filters leave in open formats, without this tool or any vendor's store format.
DIR/
mail/ Maildir++ (Dovecot/Courier layout, modified UTF-7 names, dovecot-keywords)
contacts/*.vcf one per address book, vCard 4.0
calendars/*.ics one VCALENDAR per calendar, X-WR-CALNAME, each time zone once
sieve/*.sieve
files/
manifest.json real folder names, roles, active script, identities, links; written last
No network. DIR must be new or empty and is made 0700.
Every name comes from the source, so each becomes one safe path component (no separators or .., no Windows-reserved names), and clashes are numbered, case-blind.
Photos and attachments are inlined as data: URIs, the same as export.
Links are listed in the manifest and never created.
import takeout unfolds and unescapes X-WR-CALNAME/X-WR-CALDESC.
Checked locally:cargo test --locked (all 31 test binaries pass) and clippy clean on the new code. The new tests are tests/export_files.rs (write out, then read back with import maildir and import takeout; also refusal of a non-empty dir, dry run, --objects, missing archive) plus 14 unit tests.
Not in this PR: pushing to an IMAP, CalDAV or CardDAV server; the admin manifest of accounts and domains; Maildir names containing . (they become _, and the manifest keeps the real name). scripts/export_archive.py (inherited, writes calendars and contacts as JSON) is left alone; this supersedes it.
The way out of an archive for anything that doesn't speak JMAP. This is the neutral export: mail, contacts, calendars and filters leave in open formats, without this tool or any vendor's store format.
```
inbuxa-migrate export-files [--objects <list>] [--dry-run] <ARCHIVE> <DIR>
```
```
DIR/
mail/ Maildir++ (Dovecot/Courier layout, modified UTF-7 names, dovecot-keywords)
contacts/*.vcf one per address book, vCard 4.0
calendars/*.ics one VCALENDAR per calendar, X-WR-CALNAME, each time zone once
sieve/*.sieve
files/
manifest.json real folder names, roles, active script, identities, links; written last
```
- No network. `DIR` must be new or empty and is made 0700.
- Every name comes from the source, so each becomes one safe path component (no separators or `..`, no Windows-reserved names), and clashes are numbered, case-blind.
- Photos and attachments are inlined as `data:` URIs, the same as `export`.
- Links are listed in the manifest and never created.
The readers it round-trips through:
- `import maildir` decodes modified UTF-7 folder names and reads `dovecot-keywords` (roadmap phase 3, item 11).
- `import takeout` unfolds and unescapes `X-WR-CALNAME`/`X-WR-CALDESC`.
**Checked locally:** `cargo test --locked` (all 31 test binaries pass) and clippy clean on the new code. The new tests are `tests/export_files.rs` (write out, then read back with `import maildir` and `import takeout`; also refusal of a non-empty dir, dry run, `--objects`, missing archive) plus 14 unit tests.
Not in this PR: pushing to an IMAP, CalDAV or CardDAV server; the admin manifest of accounts and domains; Maildir names containing `.` (they become `_`, and the manifest keeps the real name). `scripts/export_archive.py` (inherited, writes calendars and contacts as JSON) is left alone; this supersedes it.
The way out of an archive for anything that doesn't speak JMAP: mail as a
Maildir++ tree Dovecot and Courier serve as it is, each address book as a
.vcf, each calendar as one .ics, Sieve scripts, the file tree, and a
manifest.json with what those formats don't hold (real folder names, roles,
the active script, identities, links). No network; a new or empty
directory only, private to its owner; every name from the source made safe
as a path. Photos and attachments are inlined as data: URIs, as export
sends them. Links are listed, never made.
The readers it round-trips through get what that needs:
- import maildir decodes modified UTF-7 folder names and reads each
folder's dovecot-keywords, so Junk and labels come back;
- import takeout unfolds and unescapes X-WR-CALNAME and X-WR-CALDESC.
tests/export_files.rs writes an archive out and reads it back with import
maildir and import takeout.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
The way out of an archive for anything that doesn't speak JMAP. This is the neutral export: mail, contacts, calendars and filters leave in open formats, without this tool or any vendor's store format.
DIRmust be new or empty and is made 0700..., no Windows-reserved names), and clashes are numbered, case-blind.data:URIs, the same asexport.The readers it round-trips through:
import maildirdecodes modified UTF-7 folder names and readsdovecot-keywords(roadmap phase 3, item 11).import takeoutunfolds and unescapesX-WR-CALNAME/X-WR-CALDESC.Checked locally:
cargo test --locked(all 31 test binaries pass) and clippy clean on the new code. The new tests aretests/export_files.rs(write out, then read back withimport maildirandimport takeout; also refusal of a non-empty dir, dry run,--objects, missing archive) plus 14 unit tests.Not in this PR: pushing to an IMAP, CalDAV or CardDAV server; the admin manifest of accounts and domains; Maildir names containing
.(they become_, and the manifest keeps the real name).scripts/export_archive.py(inherited, writes calendars and contacts as JSON) is left alone; this supersedes it.