website/content/blog/writing-unit-tests-lean-4.md

title	date	draft	tags	math	medium_enabled
Writing Unit Tests in Lean 4	2024-08-05T20:43:52-07:00	false		false	false

When writing Lean code, it's easier to iterate with unit tests than to prove properties about the function off the bat.

I mean if the unit test doesn't even pass, why bother with the proof?

Luckily, Lean 4 let's us do unit tests with a cool command called #guard

#guard 1 = 1

This checks whether the following expression evaluates to true. Note that this does not provide a proof since this check is done using the untrusted evaluator.

What does need to be proven, however, is that the expression given is decidable.

One issue I faced is that I often use the Except type for error handling in my code.

inductive Except (ε : Type u) (α : Type v) where
  /-- A failure value of type `ε` -/
  | error : ε → Except ε α
  /-- A success value of type `α` -/
  | ok    : α → Except ε α

For a simple (somewhat silly) example, look at the following function

def gt_0 (n : Nat) : Except String Bool :=
  if n = 0 then .error s!"{n} is not greater than zero"
  else .ok true

We can evaluate our function on a given input:

#eval gt_0 1 -- Except.ok true

However, we can't guard against it without encountering an error. This is because we haven't shown that the equality is decidable.

To help with this, I wrote up a function that we can apply generically.

def Except.deq [DecidableEq α] [DecidableEq β] : DecidableEq (Except α β) := by
  unfold DecidableEq
  intro a b
  cases a <;> cases b <;>
  -- Get rid of obvious cases where .ok != .err
  try { apply isFalse ; intro h ; injection h }
  case error.error c d =>
    match decEq c d with
      | isTrue h => apply isTrue (by rw [h])
      | isFalse _ => apply isFalse (by intro h; injection h; contradiction)
  case ok.ok c d =>
    match decEq c d with
      | isTrue h => apply isTrue (by rw [h])
      | isFalse _ => apply isFalse (by intro h; injection h; contradiction)

We can then show that equality of Except String Bool is decidable, since Lean already knows that string and boolean equality is decidable.

instance: DecidableEq (Except String Bool) := Except.deq

From here, we can use #guard

#guard gt_0 1 = (Except.ok true)

When a #guard fails, it will throw an error during compilation. This is great for ensuring that our unit tests pass during compilation.