Implement getFirstMessage()

Closes #29, #24

README.md

@@ -42,6 +42,10 @@ $app->get('/bar', function ($req, $res, $args) {
     // Get flash messages from previous request
     $messages = $this->flash->getMessages();
     print_r($messages);
+
+    // Get the first message from a specific key
+    $test = $this->flash->getFirstMessage('Test');
+    print_r($test);
 });
 
 $app->run();

src/Messages.php

@@ -143,6 +143,23 @@ public function getMessage($key)
         return (isset($messages[$key])) ? $messages[$key] : null;
     }
 
+    /**
+     * Get the first Flash message
+     *
+     * @param  string $key The key to get the message from
+     * @param  string $default Default value if key doesn't exist
+     * @return mixed Returns the message
+     */
+    public function getFirstMessage($key, $default = null)
+    {
+        $messages = self::getMessage($key);
+        if (is_array($messages) && count($messages) > 0) {
+            return $messages[0];
+        }
+
+        return $default;
+    }
+
     /**
      * Has Flash Message
      *

tests/MessagesTest.php

@@ -194,6 +194,24 @@ public function testGetMessageFromKey()
         $this->assertEquals(['Test', 'Test2'], $flash->getMessage('Test'));
     }
 
+    //Test getting the first message from the key
+    public function testGetFirstMessageFromKey()
+    {
+        $storage = ['slimFlash' => [ 'Test' => ['Test', 'Test2']]];
+        $flash = new Messages($storage);
+
+        $this->assertEquals('Test', $flash->getFirstMessage('Test'));
+    }
+
+    //Test getting the default message if the key doesn't exist
+    public function testDefaultFromGetFirstMessageFromKeyIfKeyDoesntExist()
+    {
+        $storage = ['slimFlash' => []];
+        $flash = new Messages($storage);
+
+        $this->assertEquals('This', $flash->getFirstMessage('Test', 'This'));
+    }
+
     //Test getting the message from the key
     public function testGetMessageFromKeyIncludingCurrent()
     {