- docs(mail_intake/__init__.py): document module-based public API and usage patterns - docs(mail_intake/ingestion/reader.py): document high-level ingestion orchestration - docs(mail_intake/adapters/base.py): document adapter contract for mail providers - docs(mail_intake/adapters/gmail.py): document Gmail adapter implementation and constraints - docs(mail_intake/auth/base.py): document authentication provider contract - docs(mail_intake/auth/google.py): document Google OAuth authentication provider - docs(mail_intake/models/message.py): document canonical email message model - docs(mail_intake/models/thread.py): document canonical email thread model - docs(mail_intake/parsers/body.py): document message body extraction logic - docs(mail_intake/parsers/headers.py): document message header normalization utilities - docs(mail_intake/parsers/subject.py): document subject normalization utilities - docs(mail_intake/config.py): document global configuration model - docs(mail_intake/exceptions.py): document library exception hierarchy
25 lines
721 B
Python
25 lines
721 B
Python
"""
|
|
Mail ingestion orchestration for Mail Intake.
|
|
|
|
This package contains **high-level ingestion components** responsible for
|
|
coordinating mail retrieval, parsing, normalization, and model construction.
|
|
|
|
It represents the **top of the ingestion pipeline** and is intended to be the
|
|
primary interaction surface for library consumers.
|
|
|
|
Components in this package:
|
|
- Are provider-agnostic
|
|
- Depend only on adapter and parser contracts
|
|
- Contain no provider-specific API logic
|
|
- Expose read-only ingestion workflows
|
|
|
|
Consumers are expected to construct a mail adapter and pass it to the
|
|
ingestion layer to begin processing messages and threads.
|
|
"""
|
|
|
|
from .reader import MailIntakeReader
|
|
|
|
__all__ = [
|
|
"MailIntakeReader",
|
|
]
|