Merge pull request #36 from cultuurnet/feature/III-2534

III-2534: Add method to get first detail from a list

lib/CultureFeed/Cdb/Data/DetailList.php

@@ -86,4 +86,16 @@ public function getDetailByLanguage($language_code)
             }
         }
     }
+
+    /**
+     * Get the first detail.
+     *
+     * @return CultureFeed_Cdb_Data_Detail|NULL
+     */
+    public function getFirst()
+    {
+        // Reset indices to 0, 1, 2, ... before trying to get the value for index 0.
+        $details = array_values($this->details);
+        return isset($details[0]) ? $details[0] : null;
+    }
 }

tests/CultureFeed/Cdb/Data/DetailListTest.php

@@ -0,0 +1,57 @@
+<?php
+
+class CultureFeed_Cdb_Data_DetailListTest extends PHPUnit_Framework_TestCase
+{
+    /**
+     * @var \CultureFeed_Cdb_Data_DetailList
+     */
+    private $details;
+
+    public function setUp()
+    {
+        $this->details = $this->getMockForAbstractClass('\CultureFeed_Cdb_Data_DetailList');
+    }
+
+    public function testGetFirstWithOneDetail()
+    {
+        $first = $this->createDetail();
+        $first->setTitle('Foo bar');
+
+        $this->details->add($first);
+
+        $this->assertEquals($first, $this->details->getFirst());
+    }
+
+    public function testGetFirstWithMultipleDetails()
+    {
+        $first = $this->createDetail();
+        $first->setTitle('Foo bar');
+
+        $second = $this->createDetail();
+        $second->setTitle('Lorem ipsum');
+
+        $third = $this->createDetail();
+        $third->setTitle('Acme');
+
+        $this->details->add($first);
+        $this->details->add($second);
+        $this->details->add($third);
+
+        $this->assertEquals($first, $this->details->getFirst());
+    }
+
+    public function testGetFirstWithNoDetails()
+    {
+        $this->assertNull($this->details->getFirst());
+    }
+
+    /**
+     * @return CultureFeed_Cdb_Data_Detail
+     */
+    private function createDetail()
+    {
+        /* @var CultureFeed_Cdb_Data_Detail $mock */
+        $mock = $this->getMockForAbstractClass('\CultureFeed_Cdb_Data_Detail');
+        return $mock;
+    }
+}