Question 1

How do I create a custom matcher in Luassert?

Accepted Answer

Define a function that returns a predicate, then register it with `assert:register('matcher', 'name', function)`. The README shows an example with `is_even` matcher for checking even numbers.

Question 2

Luassert vs Lua's native assert: which should I use?

Accepted Answer

Use Luassert for complex tests needing expressive syntax, custom assertions, or state management. Native assert is fine for simple checks, but Luassert reduces boilerplate and enhances test clarity with its extended features.

Question 3

Can I use Luassert with testing frameworks other than Busted?

Accepted Answer

Yes, Luassert is a standalone library and can integrate with any Lua testing framework or be used independently. However, it's commonly paired with Busted, which provides extended examples and integration.

Question 4

How to format table output in Luassert for debugging?

Accepted Answer

Set the `TableFormatLevel` parameter to control depth display, or add custom formatters with `assert:add_formatter()`. The README includes examples with binary string formatting and table depth limits.

Question 5

What are snapshots in Luassert and how do I use them?

Accepted Answer

Snapshots capture test state like spies and stubs for isolation. Create a snapshot with `assert:snapshot()` and revert with `snapshot:revert()` to undo changes between tests, as shown in the describe block example.

Question 6

Is Luassert good for mocking and spying in Lua tests?

Accepted Answer

Yes, Luassert includes spy and stub utilities with argument matching, making it suitable for mocking. Use `spy.new()` or `spy.on()` with matchers to verify calls, as demonstrated in the matchers section.

Luassert

What is Luassert?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions