#mail-api #internal

mail-core

[mail/core] provides the Mail type for the mail crate (inkl. multipart mime bodies, builder and resource type)

3 releases

0.6.2 Mar 26, 2019
0.6.1 Jan 7, 2019
0.6.0 Nov 23, 2018

#23 in Email

Download history 2/week @ 2019-01-23 16/week @ 2019-01-30 8/week @ 2019-02-06 21/week @ 2019-02-13 6/week @ 2019-02-20 29/week @ 2019-02-27 17/week @ 2019-03-06 9/week @ 2019-03-13 30/week @ 2019-03-20 31/week @ 2019-03-27 11/week @ 2019-04-03 8/week @ 2019-04-10 4/week @ 2019-04-17 18/week @ 2019-04-24 22/week @ 2019-05-01

71 downloads per month
Used in 4 crates

MIT/Apache

139KB
2.5K SLoC

mail-core

Provides the core mail type Mail for the mail crate.


This crate provides the type called mail as well as ways to create it. It also provides the builder context interface and the Resource type, which is used to represent mail bodies. Especially such which are attachments or embedded images.

Example

extern crate futures;
// Note that the `mail` crate provides a facade re-exporting
// all relevant parts.
extern crate mail_core;
extern crate mail_internals;
#[macro_use]
extern crate mail_headers;

use std::str;
use futures::Future;

use mail_internals::MailType;

// In the facade this is the `headers` module.
use mail_headers::{
    headers::*,
    header_components::Domain
};

// In the facade this types (and the default_impl module)
// are also exposed at top level
use mail_core::{
    Mail,
    default_impl::simple_context,
    error::MailError
};

fn print_some_mail() -> Result<(), MailError> {
    // Domain will implement `from_str` in the future,
    // currently it doesn't have a validator/parser.
    // So this will become `"example.com".parse()`
    let domain = Domain::from_unchecked("example.com".to_owned());
    // Normally you create this _once per application_.
    let ctx = simple_context::new(domain, "xqi93".parse().expect("we know it's ascii"))
        .expect("this is basically: failed to get cwd from env");

    let mut mail = Mail::plain_text("Hy there! 😁");
    mail.insert_headers(headers! {
        _From: [("I'm Awesome 😁", "bla@examle.com")],
        _To: ["unknow@example.com"],
        Subject: "Hy there message 😁"
    }?);

    // We don't added any think which needs loading but we could have
    // and all of it would have been loaded concurrent and async.
    let encoded = mail.into_encodable_mail(ctx.clone())
        .wait()?
        .encode_into_bytes(MailType::Ascii)?;

    let mail_str = str::from_utf8(&encoded).unwrap();
    println!("{}", mail_str);
    Ok(())
}

fn main() {
    print_some_mail().unwrap()
}

Documentation can be viewed on docs.rs (once it is published).

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~5.5MB
~101K SLoC