Skip to content

Test Lib

Easy test data creation in Apex.

API version

License

GitHub Repo starsGitHub Release

Documentation

You can find the full documentation at testlib.beyondthecloud.dev.

What Does It Solve?

  • Complex Test Data Creation - Every test method repeats the same record setup boilerplate.
  • Long-Running Unit Tests - Inserting records only to satisfy a required field slows down the whole test suite.
  • Hard-To-Mock Relationships - Parent lookups and child collections are read-only and cannot be assigned directly.

Why Test Lib?

  • Builder Pattern - Create real database records with buildAndInsert().
  • Mocker Pattern - Create in-memory records without DML operations.
  • Templates - Predefined configurations for common scenarios.
  • Randomizers - Generate unique values for bulk record creation.
  • Relationships - Mock parent lookups and child collections.
  • Fluent API - Readable, chainable test code that describes the scenario.

Quick Start

apex
// Builder - creates real records in database
Account acc = (Account) AccountTestModule.Builder()
    .enterprise()
    .buildAndInsert();

// Mocker - creates in-memory records (no DML)
Contact con = (Contact) ContactTestModule.Mocker()
    .setFakeId()
    .set('Account.Name', acc.Name)
    .build();

Documentation

Installation