pub struct Client<T: Read + Write> { /* fields omitted */ }
An (unauthenticated) handle to talk to an IMAP server. This is what you get when first
connecting. A succesfull call to Client::login
or Client::authenticate
will return a
Session
instance that provides the usual IMAP methods.
This will upgrade an IMAP client from using a regular TCP connection to use TLS.
The domain parameter is required to perform hostname verification.
Creates a new client over the given stream.
This method primarily exists for writing tests that mock the underlying transport, but can
also be used to support IMAP over custom tunnels.
Log in to the IMAP server. Upon success a Session
instance is
returned; on error the original Client
instance is returned in addition to the error.
This is because login
takes ownership of self
, so in order to try again (e.g. after
prompting the user for credetials), ownership of the original Client
needs to be
transferred back to the caller.
let client = imap::connect(
("imap.example.org", 993),
"imap.example.org",
&tls_connector).unwrap();
match client.login("user", "pass") {
Ok(s) => {
},
Err((e, orig_client)) => {
eprintln!("error logging in: {}", e);
return;
}
}
Authenticate with the server using the given custom authenticator
to handle the server's
challenge.
extern crate imap;
extern crate native_tls;
use native_tls::TlsConnector;
struct OAuth2 {
user: String,
access_token: String,
}
impl imap::Authenticator for OAuth2 {
type Response = String;
fn process(&self, _: &[u8]) -> Self::Response {
format!(
"user={}\x01auth=Bearer {}\x01\x01",
self.user, self.access_token
)
}
}
fn main() {
let auth = OAuth2 {
user: String::from("me@example.com"),
access_token: String::from("<access_token>"),
};
let domain = "imap.example.com";
let tls = TlsConnector::builder().build().unwrap();
let client = imap::connect((domain, 993), domain, &tls).unwrap();
match client.authenticate("XOAUTH2", &auth) {
Ok(session) => {
},
Err((e, orig_client)) => {
eprintln!("error authenticating: {}", e);
return;
}
};
}
Formats the value using the given formatter. Read more
type Target = Connection<T>
The resulting type after dereferencing.
Mutably dereferences the value.
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)
Immutably borrows from an owned value. Read more
🔬 This is a nightly-only experimental API. (get_type_id
)
this method will likely be replaced by an associated static
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)
Mutably borrows from an owned value. Read more