upd

Cargo.lock

@@ -266,24 +266,6 @@ version = "1.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "b9e0384b61958566e926dc50660321d12159025e767c18e043daf26b70104c39"
 
-[[package]]
-name = "imap"
-version = "0.1.0"
-dependencies = [
- "anyhow",
- "async-trait",
- "bitflags",
- "bytes",
- "derive_builder",
- "futures",
- "log",
- "nom",
- "tokio",
- "tokio-rustls",
- "tokio-util",
- "webpki-roots",
-]
-
 [[package]]
 name = "instant"
 version = "0.1.10"
@@ -411,6 +393,24 @@ version = "1.8.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "692fcb63b64b1758029e0a96ee63e049ce8c5948587f2f7208df04625e5f6b56"
 
+[[package]]
+name = "panorama-imap"
+version = "0.0.2"
+dependencies = [
+ "anyhow",
+ "async-trait",
+ "bitflags",
+ "bytes",
+ "derive_builder",
+ "futures",
+ "log",
+ "nom",
+ "tokio",
+ "tokio-rustls",
+ "tokio-util",
+ "webpki-roots",
+]
+
 [[package]]
 name = "parking_lot"
 version = "0.11.1"

imap/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
-name = "imap"
-version = "0.1.0"
+name = "panorama-imap"
+version = "0.0.2"
 edition = "2018"
 
 [[bin]]

imap/bin/greenmail_test.rs

@@ -1,5 +1,5 @@
 use anyhow::Result;
-use imap::client::ConfigBuilder;
+use panorama_imap::client::ConfigBuilder;
 
 #[tokio::main]
 async fn main() -> Result<()> {

imap/src/proto/parsers.rs

@@ -5,6 +5,11 @@ use nom::{
     Err, IResult, InputIter, Needed, Parser, Slice,
 };
 
+/// `sep_list!(t, d)` represents `t *(d t)` and automatically collapses it into `Vec<T>`.
+///
+/// Also `sep_list!(?t, d)` represents `[t *(d t)]` and will default to an empty vec.
+///
+/// If `d` is not passed then it defaults to `SP`.
 macro_rules! sep_list {
     ($t:expr) => {
         map(
@@ -44,8 +49,10 @@ macro_rules! sep_list {
     };
 }
 
+/// Always fails, used as a no-op.
 pub fn never<I, O>(i: I) -> IResult<I, O> { Err(Err::Error(Error::new(i, ErrorKind::Not))) }
 
+/// Skip the part of the input matched by the given parser.
 pub fn skip<E, F, I, O>(mut f: F) -> impl FnMut(I) -> IResult<I, (), E>
 where
     I: Clone,
@@ -57,6 +64,7 @@ where
     }
 }
 
+/// Same as nom satisfy, but operates on `&[u8]` instead of `&str`.
 pub fn satisfy<F, I, E, T>(f: F) -> impl Fn(I) -> IResult<I, T, E>
 where
     I: Slice<RangeFrom<usize>> + InputIter<Item = T>,
@@ -71,6 +79,7 @@ where
     }
 }
 
+/// Match a single byte exactly.
 pub fn byte<I, E: ParseError<I>>(b: u8) -> impl Fn(I) -> IResult<I, u8, E>
 where
     I: Slice<RangeFrom<usize>> + InputIter<Item = u8>,

imap/src/proto/rfc2177.rs

@@ -1 +1 @@
-//! Grammar from https://datatracker.ietf.org/doc/html/rfc2177#section-4
+//! Grammar from <https://datatracker.ietf.org/doc/html/rfc2177#section-4>

imap/src/proto/rfc2234.rs

@@ -1,4 +1,4 @@
-//! Grammar from https://tools.ietf.org/html/rfc2234#section-6.1
+//! Grammar from <https://tools.ietf.org/html/rfc2234#section-6.1>
 
 use nom::{branch::alt, character::streaming::anychar, multi::many0, sequence::pair};
 

imap/src/proto/rfc3501.rs

@@ -1,4 +1,4 @@
-//! Grammar from https://datatracker.ietf.org/doc/html/rfc3501#section-9
+//! Grammar from <https://datatracker.ietf.org/doc/html/rfc3501#section-9>
 
 use std::borrow::Cow;