$ show DockYard/elixir-mail
DockYard/elixir-mail is an Elixir library for building, parsing, and rendering email messages according to RFC 2822 and related MIME standards. It provides a composable API to create simple and multipart email messages, handle various transfer encodings (Base64, Quoted-Printable, 7bit, 8bit, binary), and parse incoming email into structured data. The library is structured around a core `Mail.Message` struct with separate modules for encoding, parsing, rendering, and MIME type lookup. It does not require any external runtime dependencies beyond the Erlang/OTP standard library.
The LLM identified 3 files worth highlighting for reuse:
The Mail.Encoder module dispatches to the appropriate encoding module based on encoding name. Each encoding module (Base64, Binary, EightBit, QuotedPrintable, SevenBit) implements encode/decode functions per RFC 2045, handling edge cases like line length limits and special character escaping. These modules are isolated, self-contained, and reusable in any project needing MIME-compliant content transfer encoding.
Mail.Proplist provides utility functions for manipulating property lists (lists of tuples or atoms) with features like merging duplicate keys, taking/dropping keys, and more. It is self-contained, has no dependencies on other mail modules, and implements non-obvious logic for maintaining order while deduplicating keys. This utility can be extracted and used in any Elixir project working with property lists or similar key-value list structures.
Mail.MIME provides a function to look up MIME type by file extension by compiling the included mime.types file into module functions at compile time. This approach is efficient and self-contained (the mime.types file is part of the component). The module has no dependencies on other mail modules and can be used in any project needing to map file extensions to MIME types, such as web servers or file upload handlers.