From b7e284c68c7f34e23ab30ffe95d364f22b6ced4e Mon Sep 17 00:00:00 2001
From: tjp <tjp@ctrl-c.club>
Date: Sun, 2 Jun 2024 20:04:57 -0600
Subject: initial commit

[Not]Equal checks in `assert` and `must` packages
---
 must/must.go | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 must/must.go

(limited to 'must/must.go')

diff --git a/must/must.go b/must/must.go
new file mode 100644
index 0000000..67a58dd
--- /dev/null
+++ b/must/must.go
@@ -0,0 +1,30 @@
+// package must contains functions for checking values in unit tests.
+//
+// The functions in this package handle check failures by logging a message
+// containing the relevant values, and aborting the test immediately as failed.
+//
+// For analogues which allow the remainder of the test to run, see package
+// assert.
+package must
+
+import (
+	"testing"
+
+	"git.tjp.lol/assert"
+)
+
+// Equal asserts that two values compare as equal.
+func Equal(t testing.TB, actual, expect any) {
+	t.Helper()
+	if !assert.Equal(t, actual, expect) {
+		t.FailNow()
+	}
+}
+
+// NotEqual asserts that two values compare as unequal.
+func NotEqual(t testing.TB, actual, expect any) {
+	t.Helper()
+	if !assert.NotEqual(t, actual, expect) {
+		t.FailNow()
+	}
+}
-- 
cgit v1.2.3