add example of beforeAll and afterAll

along with cautionary note
petergphillips · Dec 2, 2014 · 0fc3ed2 · 0fc3ed2
1 parent b7072a5
commit 0fc3ed2
Show file tree

Hide file tree

Showing 2 changed files with 73 additions and 0 deletions.
diff --git a/README.md b/README.md
@@ -95,6 +95,41 @@ public class ExampleSpec {{
 
     });
 
+    describe("A spec using beforeAll", () -> {
+
+        final List<Integer> numbers = new ArrayList<Integer>();
+
+        beforeAll(() -> {
+            numbers.add(1);
+        });
+
+        it("sets the initial state before any tests run", () -> {
+            assertThat(numbers, contains(1));
+            numbers.add(2);
+        });
+
+        describe("and afterAll", () -> {
+
+            afterAll(() -> {
+                numbers.clear();
+            });
+
+            it("does not reset anything between tests", () -> {
+                assertThat(numbers, contains(1, 2));
+                numbers.add(3);
+            });
+
+            it("so proceed with caution; this *will* leak shared state across tests", () -> {
+                assertThat(numbers, contains(1, 2, 3));
+            });
+        });
+
+        it("cleans up after running all tests in the describe block", () -> {
+            assertThat(numbers, is(empty()));
+        });
+
+    });
+
 }}
 ```
 

diff --git a/src/test/java/specs/ExampleSpec.java b/src/test/java/specs/ExampleSpec.java
@@ -1,11 +1,14 @@
 package specs;
 
+import static com.greghaskins.spectrum.Spectrum.afterAll;
 import static com.greghaskins.spectrum.Spectrum.afterEach;
+import static com.greghaskins.spectrum.Spectrum.beforeAll;
 import static com.greghaskins.spectrum.Spectrum.beforeEach;
 import static com.greghaskins.spectrum.Spectrum.describe;
 import static com.greghaskins.spectrum.Spectrum.it;
 import static org.hamcrest.MatcherAssert.assertThat;
 import static org.hamcrest.Matchers.contains;
+import static org.hamcrest.Matchers.empty;
 import static org.hamcrest.Matchers.equalTo;
 import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.not;
@@ -103,4 +106,39 @@ public void run() throws Throwable {
 
     });
 
+    describe("A spec using beforeAll", () -> {
+
+        final List<Integer> numbers = new ArrayList<Integer>();
+
+        beforeAll(() -> {
+            numbers.add(1);
+        });
+
+        it("sets the initial state before any tests run", () -> {
+            assertThat(numbers, contains(1));
+            numbers.add(2);
+        });
+
+        describe("and afterAll", () -> {
+
+            afterAll(() -> {
+                numbers.clear();
+            });
+
+            it("does not reset anything between tests", () -> {
+                assertThat(numbers, contains(1, 2));
+                numbers.add(3);
+            });
+
+            it("so proceed with caution; this *will* leak shared state across tests", () -> {
+                assertThat(numbers, contains(1, 2, 3));
+            });
+        });
+
+        it("cleans up after running all tests in the describe block", () -> {
+            assertThat(numbers, is(empty()));
+        });
+
+    });
+
 }}