common_reports.emails.providers
Email backend adapters — effects only (the one place the outside world is allowed in).
base.py BaseProvider — the whole contract in three abstract methods
(send / list / watch + get_backend_info); thin, stateless per-call.
smtp.py SmtpProvider — smtplib send + imaplib read (stdlib, no extra deps).
graph.py GraphProvider — Microsoft 365 / Exchange Online send via the Graph
API, app-only OAuth2 (stdlib urllib, no extra deps; send-only).
gmail.py GmailProvider — Gmail API + service-account domain-wide delegation
(optional [gmail] extra; imported lazily).
Adapters do client creation + type conversion (our contracts <-> the SDK) + the raw call. They NEVER do context resolution, batching, retries, or param merging — that’s the engine above.