100 lines
2.9 KiB
Rust
100 lines
2.9 KiB
Rust
/*
|
|
* meli - backends module
|
|
*
|
|
* Copyright 2017 Manos Pitsidianakis
|
|
*
|
|
* This file is part of meli.
|
|
*
|
|
* meli is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* meli is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with meli. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
pub mod maildir;
|
|
|
|
use mailbox::email::Envelope;
|
|
use error::Result;
|
|
|
|
use std::fmt;
|
|
|
|
pub trait MailBackend {
|
|
fn get(&self) -> Result<Vec<Envelope>>;
|
|
}
|
|
|
|
|
|
/// A `BackendOp` manages common operations for the various mail backends. They only live for the
|
|
/// duration of the operation. They are generated by `BackendOpGenerator` on demand.
|
|
///
|
|
/// # Motivation
|
|
///
|
|
/// We need a way to do various operations on individual mails regardless of what backend they come
|
|
/// from (eg local or imap).
|
|
///
|
|
/// # Example
|
|
/// ```
|
|
/// use melib::mailbox::backends::{BackendOp, BackendOpGenerator};
|
|
/// use melib::error::Result;
|
|
///
|
|
/// #[derive(Debug)]
|
|
/// struct FooOp {}
|
|
///
|
|
/// impl BackendOp for FooOp {
|
|
/// fn description(&self) -> String {
|
|
/// "Foobar".to_string()
|
|
/// }
|
|
/// fn as_bytes(&mut self) -> Result<&[u8]> {
|
|
/// unimplemented!()
|
|
/// }
|
|
/// fn fetch_headers(&mut self) -> Result<&[u8]> {
|
|
/// unimplemented!()
|
|
/// }
|
|
/// fn fetch_body(&mut self) -> Result<&[u8]> {
|
|
/// unimplemented!()
|
|
/// }
|
|
/// }
|
|
///
|
|
/// let foogen = BackendOpGenerator::new(Box::new(|| Box::new(FooOp {})));
|
|
/// let operation = foogen.generate();
|
|
/// assert_eq!("Foobar", &operation.description());
|
|
///
|
|
/// ```
|
|
pub trait BackendOp: ::std::fmt::Debug + ::std::marker::Send {
|
|
fn description(&self) -> String;
|
|
fn as_bytes(&mut self) -> Result<&[u8]>;
|
|
//fn delete(&self) -> ();
|
|
//fn copy(&self
|
|
fn fetch_headers(&mut self) -> Result<&[u8]>;
|
|
fn fetch_body(&mut self) -> Result<&[u8]>;
|
|
}
|
|
|
|
/// `BackendOpGenerator` is a wrapper for a closure that returns a `BackendOp` object
|
|
/// See `BackendOp` for details.
|
|
/*
|
|
* I know this sucks, but that's the best way I found that rustc deems safe.
|
|
* */
|
|
pub struct BackendOpGenerator(Box<Fn() -> Box<BackendOp>>);
|
|
impl BackendOpGenerator {
|
|
pub fn new(b: Box<Fn() -> Box<BackendOp>>) -> Self {
|
|
BackendOpGenerator(b)
|
|
}
|
|
pub fn generate(&self) -> Box<BackendOp> {
|
|
self.0()
|
|
}
|
|
}
|
|
unsafe impl Send for BackendOpGenerator {}
|
|
unsafe impl Sync for BackendOpGenerator {}
|
|
impl fmt::Debug for BackendOpGenerator {
|
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
let op = self.generate();
|
|
write!(f, "BackendOpGenerator: {}", op.description())
|
|
}
|
|
}
|