yeah, it's CRLF, not LF for MIME-messages. details ;-)

.gitignore

@@ -1,5 +1,5 @@
 /.idea
-/composer.json
+/composer.lock
 /vendor
 /tests/_output
 /tests/_support/_generated

README.md

@@ -0,0 +1,4 @@
+kodus/mail
+==========
+
+Simple services for sending e-mail.

codeception.dist.yml

@@ -0,0 +1,18 @@
+actor: Tester
+coverage:
+    enabled: true
+    include:
+        - src/*
+paths:
+    tests: tests
+    log: tests/_output
+    data: tests/_data
+    support: tests/_support
+    envs: tests/_envs
+settings:
+    bootstrap: _bootstrap.php
+    colors: false
+    memory_limit: 1024M
+extensions:
+    enabled:
+        - Codeception\Extension\RunFailed

composer.json

@@ -0,0 +1,21 @@
+{
+    "name": "kodus/mail",
+    "minimum-stability": "dev",
+    "prefer-stable": true,
+    "require": {
+        "psr/log": "^1"
+    },
+    "require-dev": {
+        "kodus/test": "^0.3"
+    },
+    "autoload": {
+        "psr-4": {
+            "Kodus\\Mail\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Kodus\\Mail\\Test\\Unit\\": "tests/unit/"
+        }
+    }
+}

src/MailService.php

@@ -2,7 +2,15 @@
 
 namespace Kodus\Mail;
 
+/**
+ * This simple interface permits us to abstract from how Messages are sent.
+ */
 interface MailService
 {
+    /**
+     * @param Message $message
+     *
+     * @return void
+     */
     public function send(Message $message);
 }

src/Message.php

@@ -2,6 +2,9 @@
 
 namespace Kodus\Mail;
 
+/**
+ * This class represents an e-mail Message.
+ */
 class Message
 {
     /**

tests/integration.suite.dist.yml

@@ -0,0 +1,7 @@
+class_name: IntegrationTester
+modules:
+    enabled:
+        - Asserts
+        - Helper\Unit:
+            smtp_host: localhost
+            smtp_port: 8090

tests/unit/MIMEWriterCest.php

@@ -8,20 +8,23 @@
 use UnitTester;
 
 /**
- * NOTE: all MIME messages have been linted/validated using this online validator:
+ * NOTE: running this test-suite will produce files in the `_output` folder named `mail.*.txt`,
+ *       e.g. one file for each successful test.
  *
- *     http://www.mimevalidator.net/index.html
+ *       All MIME messages have been linted/validated using this online validator:
+ *
+ *           http://www.mimevalidator.net/index.html
  *
  * I'd like to eventually automate MIME validation (and preferably locally) but haven't found the tool to do it.
  */
 class MIMEWriterCest
 {
     const TEXT_BODY                  = "It's me! Rasmus!\r\n\r\nI love danish characters, look: æøåÆØÅ! whoa!\r\n\r\nTake care, friend.";
     const TEXT_BODY_QUOTED_PRINTABLE = "It's me! Rasmus!\r\n\r\nI love danish characters, look: =C3=A6=C3=B8=C3=A5=C3=86=C3=98=C3=85! whoa!\r\n\r\nTake care, friend.";
-    const TEXT_BODY_BASE64           = "SXQncyBtZSEgUmFzbXVzIQoKSSBsb3ZlIGRhbmlzaCBjaGFyYWN0ZXJzLCBsb29rOiDDpsO4w6XD\r\nhsOYw4UhIHdob2EhCgpUYWtlIGNhcmUsIGZyaWVuZC4=";
+    const TEXT_BODY_BASE64           = "SXQncyBtZSEgUmFzbXVzIQ0KDQpJIGxvdmUgZGFuaXNoIGNoYXJhY3RlcnMsIGxvb2s6IMOmw7jD\r\npcOGw5jDhSEgd2hvYSENCg0KVGFrZSBjYXJlLCBmcmllbmQu";
 
-    const HTML_BODY                  = "<strong>It's me! Rasmus!</strong>\n\nI love danish characters, look: æøåÆØÅ! whoa!\n\nTake care, friend.";
-    const HTML_BODY_QUOTED_PRINTABLE = "<strong>It's me! Rasmus!</strong>\n\nI love danish characters, look: =C3=A6=C3=B8=C3=A5=C3=86=C3=98=C3=85! whoa!\n\nTake care, friend.";
+    const HTML_BODY                  = "<strong>It's me! Rasmus!</strong>\n\nI love danish characters, look: æøåÆØÅ! whoa!\r\n\r\nTake care, friend.";
+    const HTML_BODY_QUOTED_PRINTABLE = "<strong>It's me! Rasmus!</strong>=0A=0AI love danish characters, look: =C3=\r\n=A6=C3=B8=C3=A5=C3=86=C3=98=C3=85! whoa!\r\n\r\nTake care, friend.";
 
     private $last_mime;