1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
//! RFC822/MIME wire parsing and rendering for `email-message`.
//!
//! This crate focuses on wire format concerns and keeps `email-message` focused on
//! outbound message representation.
//!
//! ```rust
//! use email_message_wire::{parse_rfc822, render_rfc822};
//!
//! let raw = b"From: from@example.com\r\nTo: to@example.com\r\n\r\nHello";
//! let message = parse_rfc822(raw).unwrap();
//! let _bytes = render_rfc822(&message).unwrap();
//! ```
//!
//! Current rendering support:
//! - Structured body rendering for text, html, text+html, and MIME trees.
//! - `Message::attachments` rendered as MIME parts with multipart nesting, base64 transfer
//! encoding, Content-Disposition, and optional Content-ID.
//! - RFC2231 `filename*=` parameter emitted for non-ASCII attachment filenames.
//! - Attachment references are model-level values and must be resolved to bytes before
//! rendering.
//!
//! # Feature interaction with `email-message`
//!
//! Depending on `email-message-wire` enables `email-message`'s `mime`
//! feature for the calling crate as a side effect, `MimePart` becomes
//! visible in `email_message`. The wire crate genuinely needs `mime`
//! for full MIME-tree rendering, so this is unavoidable; downstream
//! crates that want `MimePart` access have an alternative path through
//! the wire dependency.
//!
//! # Parser semantics
//!
//! See [`parse_rfc822`] for the full decoding contract. Highlights:
//! - Body charsets outside `utf-8`/`us-ascii`/`iso-8859-1`/`latin1` are
//! decoded with `String::from_utf8_lossy`, invalid bytes become
//! `U+FFFD` rather than producing an error.
//! - Encoded words in unsupported charsets pass through as the raw
//! `=?…?=` literal.
//! - Duplicate `To:`/`Cc:`/`Bcc:`/`Reply-To:` lines are merged.
//! - RFC 6532 (SMTPUTF8) inbound is not supported; non-ASCII header
//! lines fail.
//! - The returned `Message` has not been validated for outbound
//! delivery, wrap via `OutboundMessage::new` if you intend to send
//! it through a `Transport`.
pub use ;