Crate melib

Source
Expand description

§melib

GitHub license Crates.io docs.rs

Library for handling email for email clients.

§Cargo Compile-time Features

melib supports opting in and out of features at compile time with cargo features.

The contents of the default feature are:

default = ["imap", "nntp", "maildir", "mbox-notify", "smtp"]

A list of all the features and a description for each follows:

Feature flagDependenciesNotes
maildirnotify crateProvides the maildir backend
mbox-notifynotify crateProvides notification support for the mbox backend
notmuchmaildir featureProvides the notmuch backend
imapimap-codec crate, tls featureProvides the IMAP backend
jmaphttp feature, url crate with serde featureProvides the JMAP backend
nntptls featureProvides the NNTP (Usenet) backend
smtptls featureIntegrated async SMTP client
sqlite3rusqlite crate with bundled-full featureUsed in caches
sqlite3-staticrusqlite crate with bundled-full featureSame as sqlite3 feature but provided for consistency and in case sqlite3 feature stops bundling libsqlite3 statically in the future.
gpgmeGPG use by dynamically loading libgpgme.so
httpisahc crateUsed for HTTP client needs, notably JMAP`
tlsnative-tls crate
http-staticisahc crate with static-curl featureLinks with curl statically
tls-staticnative-tls crate with vendored featureLinks with OpenSSL statically where it’s used
imap-traceimap featureConnection trace logs on the trace logging level
jmap-tracejmap featureConnection trace logs on the trace logging level
nntp-tracenntp featureConnection trace logs on the trace logging level
smtp-tracesmtp featureConnection trace logs on the trace logging level

Though not a feature, the presence of the environment variable UNICODE_REGENERATE_TABLES at compile-time of the melib crate will force the regeneration of Unicode tables from the crate’s build.rs script. Otherwise the tables are already included with the source code, and there’s no real reason to regenerate them unless you intend to modify the code or update to a new Unicode version.

§Example: Parsing bytes into an Envelope

An Envelope represents the information you can get from an email’s headers and body structure. Addresses in To, From fields etc are parsed into Address types.

use melib::{email::attachment_types::Text, Attachment, Envelope};

let raw_mail = r#"From: "some name" <some@example.com>
To: "me" <myself@example.com>
Cc:
Subject: =?utf-8?Q?gratuitously_encoded_subject?=
Message-ID: <h2g7f.z0gy2pgaen5m@example.com>
MIME-Version: 1.0
Content-Type: multipart/mixed; charset="utf-8";
 boundary="bzz_bzz__bzz__"

This is a MIME formatted message with attachments. Use a MIME-compliant client to view it properly.
--bzz_bzz__bzz__

hello world.
--bzz_bzz__bzz__
Content-Type: image/gif; name="test_image.gif"; charset="utf-8"
Content-Disposition: attachment
Content-Transfer-Encoding: base64

R0lGODdhKAAXAOfZAAABzAADzQAEzgQFtBEAxAAGxBcAxwALvRcFwAAPwBcLugATuQEUuxoNuxYQ
sxwOvAYVvBsStSAVtx8YsRUcuhwhth4iuCQsyDAwuDc1vTc3uDg4uT85rkc9ukJBvENCvURGukdF
wUVKt0hLuUxPvVZSvFlYu1hbt2BZuFxdul5joGhqlnNuf3FvlnBvwXJyt3Jxw3N0oXx1gH12gV99
z317f3N7spFxwHp5wH99gYB+goF/g25+26tziIOBhWqD3oiBjICAuudkjIN+zHeC2n6Bzc1vh4eF
iYaBw8F0kImHi4KFxYyHmIWIvI2Lj4uIvYaJyY+IuJGMi5iJl4qKxZSMmIuLxpONnpGPk42NvI2M
1LKGl46OvZePm5ORlZiQnJqSnpaUmLyJnJuTn5iVmZyUoJGVyZ2VoZSVw5iXoZmWrO18rJiUyp6W
opuYnKaVnZ+Xo5yZncaMoaCYpJiaqo+Z2Z2annuf5qGZpa2WoJybpZmayZ2Z0KCZypydrZ6dp6Cd
oZ6a0aGay5ucy5+eqKGeouWMgp+b0qKbzKCfqdqPnp2ezaGgqqOgpKafqrScpp+gz6ajqKujr62j
qayksKmmq62lsaiosqqorOyWnaqqtKeqzLGptaurta2rr7Kqtq+ssLOrt6+uuLGusuqhfbWtubCv
ubKvs7GwurOwtPSazbevu+ali7SxtbiwvOykjLOyvLWytuCmqOankrSzvbazuLmyvrW0vre0uba1
wLi1ury0wLm2u721wbe3wbq3vMC2vLi4wr+3w7m5w8C4xLi6yry6vsG5xbu7xcC6zMK6xry8xry+
u8O7x729x8C9wb++yMG+wsO+vMK/w8a+y8e/zMnBzcXH18nL2///////////////////////////
////////////////////////////////////////////////////////////////////////////
/////////////////////////////////////////////////////ywAAAAAKAAXAAAI/gBP4Cjh
IYMLEh0w4EgBgsMLEyFGFBEB5cOFABgzatS4AVssZAOsLOHCxooVMzCyoNmzaBOkJlS0VEDyZMjG
mxk3XOMF60CDBgsoPABK9KcDCRImPCiQYAECAgQCRMU4VSrGCjFarBgUSJCgQ10FBTrkNRCfPnz4
dA3UNa1btnDZqgU7Ntqzu3ej2X2mFy9eaHuhNRtMGJrhwYYN930G2K7eaNIY34U2mfJkwpgzI9Yr
GBqwR2KSvAlMOXHnw5pTNzPdLNoWIWtU9XjGjDEYS8LAlFm1SrVvzIKj5TH0KpORSZOryPgCZgqL
Ob+jG0YVRBErUrOiiGJ8KxgtYsh27xWL/tswnTtEbsiRVYdJNMHk4yOGhswGjR88UKjQ9Ey+/8TL
XKKGGn7Akph/8XX2WDTTcAYfguVt9hhrEPqmzIOJ3VUheb48WJiHG6amC4i+WVJKKCimqGIoYxyj
WWK8kKjaJ9bA18sxvXjYhourmbbMMrjI+OIn1QymDCVXANGFK4S1gQw0PxozzC+33FLLKUJq9gk1
gyWDhyNwrMLkYGUEM4wvuLRiCiieXIJJJVlmJskcZ9TZRht1lnFGGmTMkMoonVQSSSOFAGJHHI0w
ouiijDaaCCGQRgrpH3q4QYYXWDihxBE+7KCDDjnUIEVAADs=
--bzz_bzz__bzz__--"#;

let envelope = Envelope::from_bytes(raw_mail.as_bytes(), None).expect("Could not parse mail");
assert_eq!(envelope.subject().as_ref(), "gratuitously encoded subject");
assert_eq!(envelope.message_id(), "h2g7f.z0gy2pgaen5m@example.com");
assert_eq!(&envelope.message_id().display_brackets().to_string(), "<h2g7f.z0gy2pgaen5m@example.com>");

let body = envelope.body_bytes(raw_mail.as_bytes());
assert_eq!(body.content_type().to_string().as_str(), "multipart/mixed");

let body_text = body.text(Text::Plain);
assert_eq!(body_text.as_str(), "hello world.");

let subattachments: Vec<Attachment> = body.attachments();
assert_eq!(subattachments.len(), 3);
assert_eq!(
    subattachments[2].content_type().name().unwrap(),
    "test_image.gif"
);

§Description

A crate that performs mail client operations such as

  • Hold an Envelope with methods convenient for mail client use. (see module email)
  • Abstract through mail storages through the MailBackend trait, and handle read/writes/updates through it. (see module backends)
  • Decode attachments (see module email::attachments)
  • Create new mail (see email::Draft)
  • Send mail with an SMTP client (see module smtp)
  • Manage contacts (see module contacts)
  • Build thread structures out of a list of mail via their In-Reply-To and References header values (see module thread)

Other exports are

  • Basic mail account configuration to use with backends (see module conf)
  • A debug macro that works like std::dbg but for multiple threads. (see debug macro)

Re-exports§

Modules§

Macros§

Structs§

Type Aliases§