Skip to main content

Suites & Sub-suites

Organize your tests into structured suites and nested sub-suites with a simple and readable API.

Expressive Assertions

Write clear assertions with expect and a rich set of matchers. Invert any matcher with .never and add context with .withMessage.

Auto-discovery

Use runTests to automatically scan folders for .spec modules and run them all at once, no manual wiring needed.

Why Specium?

Testing in Roblox usually means scattered print statements or heavy dependencies like TestEZ. Specium is a lightweight alternative that gives you structured test suites, readable assertions, and detailed output — with no external dependencies.

Features

  • Suites & sub-suites: Organize tests with suite and describe.
  • Expressive assertions: expect with matchers like toBe, toEqual, toThrow, toContain and more.
  • Invertible matchers: Use .never to flip any assertion.
  • Custom failure messages: Chain .withMessage(msg) for clearer output.
  • Structured results: Get a full SpeciumRunResult to inspect programmatically.
  • Auto-discovery: Use runTests to scan folders for .spec modules automatically.