doc.go

// Package imap provides a simple, pragmatic IMAP client for Go.
//
// It focuses on the handful of operations most applications need:
//
//   - Connecting over TLS (STARTTLS not required)
//   - Authenticating with LOGIN or XOAUTH2 (OAuth 2.0)
//   - Selecting/Examining folders, searching (UID SEARCH), and fetching messages
//   - Moving, copying, and appending messages
//   - Creating, deleting, and renaming folders
//   - Setting flags, deleting + expunging
//   - Type-safe search builder (Search().From("x").Unseen().Since(date))
//   - IMAP IDLE with callbacks for EXISTS/EXPUNGE/FETCH
//   - Automatic reconnect with re-authentication and folder restore
//
// The API is intentionally small and easy to adopt without pulling in a full
// IMAP stack. See the README for end-to-end examples and guidance.
package imap