test: add Panic and NotPanic

examples_test.go

@@ -990,6 +990,16 @@ func ExampleUnreachable() {
 	// Output:
 }
 
+func ExamplePanic() {
+	Panic(t, func() { panic("hi mom") })
+	// Output:
+}
+
+func ExampleNotPanic() {
+	NotPanic(t, func() {})
+	// Output:
+}
+
 func ExampleValidJSON() {
 	js := `{"key": ["v1", "v2"]}`
 	ValidJSON(t, js)

internal/assertions/assertions.go

@@ -142,6 +142,26 @@ func Unreachable() (s string) {
 	return
 }
 
+func Panic(f func()) (s string) {
+	defer func() {
+		if r := recover(); r == nil {
+			s = "expected panic; did not panic"
+		}
+	}()
+	f()
+	return
+}
+
+func NotPanic(f func()) (s string) {
+	defer func() {
+		if r := recover(); r != nil {
+			s = fmt.Sprintf("expected not to panic; panicked: %v", r)
+		}
+	}()
+	f()
+	return
+}
+
 func Error(err error) (s string) {
 	if err == nil {
 		s = "expected non-nil error; got nil\n"

test.go

@@ -49,6 +49,18 @@ func Unreachable(t T, settings ...Setting) {
 	invoke(t, assertions.Unreachable(), settings...)
 }
 
+// Panic asserts func f panics.
+func Panic(t T, f func(), settings ...Setting) {
+	t.Helper()
+	invoke(t, assertions.Panic(f), settings...)
+}
+
+// NotPanic asserts func f does not panic.
+func NotPanic(t T, f func(), settings ...Setting) {
+	t.Helper()
+	invoke(t, assertions.NotPanic(f), settings...)
+}
+
 // Error asserts err is a non-nil error.
 func Error(t T, err error, settings ...Setting) {
 	t.Helper()