initial commitmain

[Not]Equal checks in `assert` and `must` packages

1 files changed, 30 insertions, 0 deletions

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()
+	}
+}