Allow retrieving unstopped stopwatch events

jochenvdv · jochenvdv · commit 2efe461a46df · 2014-02-04T12:05:45.000+01:00
Section:
  - added method getEvent()

Stopwatch:
  - added method getEvent()

StopwatchTest:
  - modified testStart() to test for getEvent() method
  - added testUnknownEvent()
diff --git a/src/Symfony/Component/Stopwatch/Stopwatch.php b/src/Symfony/Component/Stopwatch/Stopwatch.php
@@ -125,6 +125,18 @@ public function lap($name)
         return end($this->activeSections)->stopEvent($name)->start();
     }
 
+    /**
+     * Returns a specific event by name
+     *
+     * @param string $name The event name
+     *
+     * @return StopwatchEvent A StopwatchEvent instance
+     */
+    public function getEvent($name)
+    {
+        return end($this->activeSections)->getEvent($name);
+    }
+
     /**
      * Gets all events for a given section.
      *
@@ -293,6 +305,24 @@ public function lap($name)
         return $this->stopEvent($name)->start();
     }
 
+    /**
+     * Returns a specific event by name
+     *
+     * @param string $name The event name
+     *
+     * @return StopwatchEvent The event
+     *
+     * @throws \LogicException When the event is not known
+     */
+    public function getEvent($name)
+    {
+        if (!isset($this->events[$name])) {
+            throw new \LogicException(sprintf('Event "%s" is not known.', $name));
+        }
+
+        return $this->events[$name];
+    }
+
     /**
      * Returns the events from this section.
      *
diff --git a/src/Symfony/Component/Stopwatch/Tests/StopwatchTest.php b/src/Symfony/Component/Stopwatch/Tests/StopwatchTest.php
@@ -29,6 +29,7 @@ public function testStart()
 
         $this->assertInstanceof('Symfony\Component\Stopwatch\StopwatchEvent', $event);
         $this->assertEquals('cat', $event->getCategory());
+        $this->assertSame($event, $stopwatch->getEvent('foo'));
     }
 
     public function testIsStarted()
@@ -92,6 +93,15 @@ public function testLap()
         $this->assertEquals(200, $event->getDuration(), null, self::DELTA);
     }
 
+    /**
+     * @expectedException \LogicException
+     */
+    public function testUnknownEvent()
+    {
+        $stopwatch = new Stopwatch();
+        $stopwatch->getEvent('foo');
+    }
+
     /**
      * @expectedException \LogicException
      */
