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 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163
// ### 2.3.2. Flags Message Attribute
use std::io::Write;
#[cfg(feature = "arbitrary")]
use arbitrary::Arbitrary;
#[cfg(feature = "serdex")]
use serde::{Deserialize, Serialize};
use crate::{codec::Encode, types::core::Atom};
/// A list of zero or more named tokens associated with the message. A
/// flag is set by its addition to this list, and is cleared by its
/// removal. There are two types of flags in IMAP4rev1. A flag of either
/// type can be permanent or session-only.
/// FIXME: this struct is not very usable currently...
#[cfg_attr(feature = "arbitrary", derive(Arbitrary))]
#[cfg_attr(feature = "serdex", derive(Serialize, Deserialize))]
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub enum Flag {
// ----- System -----
//
// A system flag is a flag name that is pre-defined in this
// specification. All system flags begin with "\". Certain system
// flags (\Deleted and \Seen) have special semantics described elsewhere.
/// Message has been read (`\Seen`)
Seen,
/// Message has been answered (`\Answered`)
Answered,
/// Message is "flagged" for urgent/special attention (`\Flagged`)
Flagged,
/// Message is "deleted" for removal by later EXPUNGE (`\Deleted`)
Deleted,
/// Message has not completed composition (marked as a draft). (`\Draft`)
Draft,
// ----- Fetch -----
/// Message is "recently" arrived in this mailbox. (`\Recent`)
///
/// This session is the first session to have been notified about this
/// message; if the session is read-write, subsequent sessions
/// will not see \Recent set for this message. This flag can not
/// be altered by the client.
Recent,
// ----- Selectability -----
NameAttribute(FlagNameAttribute),
// ----- Keyword -----
/// Indicates that it is possible to create new keywords by
/// attempting to store those flags in the mailbox. (`\*`)
Permanent,
/// A keyword is defined by the server implementation. Keywords do not
/// begin with "\". Servers MAY permit the client to define new keywords
/// in the mailbox (see the description of the PERMANENTFLAGS response
/// code for more information).
Keyword(Atom),
// ----- Others -----
Extension(Atom), // FIXME(misuse): How to treat Extension(Atom("Recent"))
}
impl std::fmt::Display for Flag {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> Result<(), std::fmt::Error> {
match self {
// ----- System -----
Flag::Seen => write!(f, "\\Seen"),
Flag::Answered => write!(f, "\\Answered"),
Flag::Flagged => write!(f, "\\Flagged"),
Flag::Deleted => write!(f, "\\Deleted"),
Flag::Draft => write!(f, "\\Draft"),
// ----- Fetch -----
Flag::Recent => write!(f, "\\Recent"),
// ----- Selectability -----
Flag::NameAttribute(flag) => write!(f, "{}", flag),
// ----- Keyword -----
Flag::Permanent => write!(f, "\\*"),
Flag::Keyword(atom) => write!(f, "{}", atom),
// ----- Others -----
Flag::Extension(atom) => write!(f, "\\{}", atom),
}
}
}
impl Encode for Flag {
fn encode(&self, writer: &mut impl Write) -> std::io::Result<()> {
write!(writer, "{}", self)
}
}
/// Four name attributes are defined.
#[cfg_attr(feature = "arbitrary", derive(Arbitrary))]
#[cfg_attr(feature = "serdex", derive(Serialize, Deserialize))]
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub enum FlagNameAttribute {
/// It is not possible for any child levels of hierarchy to exist
/// under this name; no child levels exist now and none can be
/// created in the future. (`\Noinferiors`)
Noinferiors,
/// It is not possible to use this name as a selectable mailbox. (`\Noselect`)
Noselect,
/// The mailbox has been marked "interesting" by the server; the
/// mailbox probably contains messages that have been added since
/// the last time the mailbox was selected. (`\Marked`)
Marked,
/// The mailbox does not contain any additional messages since the
/// last time the mailbox was selected. (`\Unmarked`)
Unmarked,
/// Note: extension flags must also be accepted here...
Extension(Atom),
}
impl FlagNameAttribute {
pub fn is_selectability(&self) -> bool {
matches!(
self,
FlagNameAttribute::Noselect | FlagNameAttribute::Marked | FlagNameAttribute::Unmarked
)
}
}
impl std::fmt::Display for FlagNameAttribute {
fn fmt(&self, f: &mut std::fmt::Formatter) -> Result<(), std::fmt::Error> {
match self {
Self::Noinferiors => write!(f, "\\Noinferiors"),
Self::Noselect => write!(f, "\\Noselect"),
Self::Marked => write!(f, "\\Marked"),
Self::Unmarked => write!(f, "\\Unmarked"),
Self::Extension(atom) => write!(f, "\\{}", atom),
}
}
}
impl Encode for FlagNameAttribute {
fn encode(&self, writer: &mut impl Write) -> std::io::Result<()> {
write!(writer, "{}", self)
}
}
#[cfg_attr(feature = "arbitrary", derive(Arbitrary))]
#[cfg_attr(feature = "serdex", derive(Serialize, Deserialize))]
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum StoreType {
Replace,
Add,
Remove,
}
#[cfg_attr(feature = "arbitrary", derive(Arbitrary))]
#[cfg_attr(feature = "serdex", derive(Serialize, Deserialize))]
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum StoreResponse {
Answer,
Silent,
}