mikel/mail
This is a Ruby email library providing a comprehensive toolset for composing, parsing, and sending emails. It includes an SMTP client for delivering outgoing messages and a MIME parser for decomposing complex multipart email structures.
The project features an IMAP and POP3 mail fetcher for synchronizing messages from remote servers, alongside a specialized framework for testing email logic through mock delivery methods and matchers.
The library covers a broad range of email operations, including the generation of nested multipart messages, the management of attachments, and the translation of content encoding. It also provides utilities for incoming email processing and the analysis of bounce reports to extract diagnostic codes and error statuses.
Features
- Message Composition - Provides a domain-specific language for the programmatic construction of email bodies, headers, and attachments.
- Email Libraries - A comprehensive Ruby library providing a full toolset for composing, parsing, and sending emails.
- Message Construction - Provides a programmatic way to assemble email headers, recipients, and bodies using a domain-specific language.
- SMTP Clients - Provides a client for interacting with SMTP mail servers to deliver outgoing electronic messages.
- Email Content Parsing - Decomposes raw email files or streams into structured objects for easy access to headers and body content.
- Email Delivery Integrations - Provides mechanisms for delivering outgoing emails via standard SMTP protocols or local logging for tests.
- Incoming Email Processors - Implements systems for receiving raw email streams and extracting structured headers, bodies, and attachments.
- IMAP, POP3, and SMTP Implementations - Implements client-side support for IMAP and POP3 protocols to synchronize messages from remote servers.
- Remote Mail Retrieval Services - Ships a capability for polling and fetching messages from remote mail accounts using standard retrieval protocols.
- MIME Structure Parsers - Decomposes complex multipart email structures into structured objects with full support for attachments.
- Multipart MIME Structures - Uses a recursive tree structure to manage complex emails containing both HTML and plain-text versions.
- Protocol-Agnostic Interfaces - Offers a uniform interface for fetching emails that abstracts the differences between IMAP and POP3 protocols.
- Stream-Based Email Parsers - Provides memory-efficient email parsing by processing raw data as streams rather than loading full messages into memory.
- Email Attachments - Provides utilities for adding files to outgoing emails and extracting attachments from received messages.
- Bounce Report Analysis - Provides tools to analyze delivery failure reports and extract diagnostic error codes from bounce emails.
- Bounce Report Analysis - Processes delivery failure reports to identify why a message bounced and extracts the diagnostic error codes.
- Multipart Email Formatters - Includes utilities for constructing complex multipart messages with simultaneous HTML and plain-text alternatives.
- Delivery Method Routing - Implements the ability to route outgoing emails either to a remote SMTP server or to local logs for development.
- Email Transfer-Encoding - Handles the conversion of email components between raw transfer-encoded formats and plain strings for non-ASCII characters.
- Transfer-Encoding Decoders - Converts raw wire-format email components into decoded plain-text strings using standard character encoding rules.
- Email Delivery Testing - Includes a specialized framework for verifying the construction and recipients of emails using matchers without sending real messages.
- Email Testing Tools - Includes a suite of mock delivery methods and matchers to verify email logic without sending actual messages.
- Ruby Frameworks and Tools - Library for handling email.
- Email - Provide a comprehensive library for email handling.
