adding a static timer method; you can quickly time an arbitrary block…

… of code (using a lambda for example)

src/main/java/com/google/code/tempusfugit/temporal/StopWatch.java

@@ -16,6 +16,12 @@
 
 package com.google.code.tempusfugit.temporal;
 
+import com.google.code.tempusfugit.Factory;
+import com.google.code.tempusfugit.concurrency.Callable;
+
+import java.util.function.Function;
+import java.util.function.Supplier;
+
 /**
  * Stop watch implementations should time the difference between construction (or a call to {@link #reset}) and a call to
  * {@link #lap}. They should allow for multiple calls to {@link #lap} but may preserve a class invariant that {@link #lap}

src/main/java/com/google/code/tempusfugit/temporal/Timer.java

@@ -17,10 +17,12 @@
 package com.google.code.tempusfugit.temporal;
 
 import com.google.code.tempusfugit.ClassInvariantViolation;
+import com.google.code.tempusfugit.concurrency.Callable;
 import com.google.code.tempusfugit.concurrency.annotations.Not;
 import com.google.code.tempusfugit.concurrency.annotations.ThreadSafe;
 
 import java.util.Date;
+import java.util.function.Function;
 
 import static com.google.code.tempusfugit.temporal.Duration.millis;
 
@@ -32,6 +34,16 @@ public final class Timer implements StopWatch {
     private Date started;
     private Date stopped;
 
+    public static Duration time(Runnable timed) {
+        Timer timer = new Timer(new RealClock());
+        try {
+            timed.run();
+        } finally {
+            timer.lap();
+        }
+        return timer.elapsedTime();
+    }
+
     /**
      * Constructs and starts a stop watch.
      * @since 1.2

src/test/java/com/google/code/tempusfugit/temporal/TimerTest.java

@@ -17,12 +17,21 @@
 package com.google.code.tempusfugit.temporal;
 
 import com.google.code.tempusfugit.ClassInvariantViolation;
+import com.google.code.tempusfugit.concurrency.ThreadUtils;
 import org.junit.Test;
 
+import java.util.function.Function;
+import java.util.function.Supplier;
+
+import static com.google.code.tempusfugit.concurrency.ThreadUtils.sleep;
 import static com.google.code.tempusfugit.temporal.Duration.millis;
+import static com.google.code.tempusfugit.temporal.Duration.seconds;
 import static org.hamcrest.MatcherAssert.assertThat;
+import static org.hamcrest.Matchers.both;
+import static org.hamcrest.Matchers.lessThan;
 import static org.hamcrest.core.Is.is;
 import static org.hamcrest.core.IsEqual.equalTo;
+import static org.hamcrest.number.OrderingComparison.greaterThan;
 
 public class TimerTest {
 
@@ -88,4 +97,10 @@ public void shouldRecordElapsedTimeBetweenStartAndStop() {
         assertThat(timer.elapsedTime(), is(millis(20)));
     }
 
+    @Test
+    public void timeSomething() {
+        Duration duration = Timer.time(() -> sleep(millis(25)));
+        assertThat(duration, is(both(greaterThan(millis(25))).and(lessThan(millis(45)))));
+    }
+
 }