Skip to main content

Running Apex Tests Locally

The SquireX Apex runtime executes your Apex unit tests entirely offline — no org, no deploy, no scratch org spin-up.

Initialize​

cd my-salesforce-project
squirex init

Creates .squirex.json:

{
  "version": "1.0",
  "interpreter": "go",
  "sourceDirectory": "force-app/main/default/classes",
  "testPattern": "**/*Test.cls"
}

Run All Tests​

squirex run -d force-app/main/default/classes

Run a Single Test Method​

squirex run --method AccountTest.testInsert

Run with Coverage​

squirex run -d force-app/main/default/classes --coverage

Sample output:

CODE COVERAGE:
  AccountController              12/15    80% ████████████░░░
  OpportunityHandler             18/20    90% ██████████████████░░
  TOTAL                          30/35    86%

JUnit XML (for CI)​

squirex run -d force-app/main/default/classes --junit results.xml

Parallel Execution​

squirex run -d force-app/main/default/classes --parallel
warning

Parallel mode uses goroutine-based test isolation. Tests that rely on static class state may produce different results than sequential mode.

Supported Apex Features​

FeatureStatus
DML: insert, update, upsert, delete, merge✅
SOQL: WHERE, ORDER BY, LIMIT, OFFSET✅
SOQL: GROUP BY, aggregates (COUNT, SUM, AVG)✅
Governor limit tracking✅
try-catch-finally✅
Cross-class method calls✅
Inner classes✅
Method overload resolution✅
Interfaces✅
SOQL subqueries⚠️ Not yet
SOSL⚠️ Not yet
Async (@future, Batch, Queueable)⚠️ Runs synchronously

Example Test Class​

// examples/AccountUtilsTest.cls
@isTest
private class AccountUtilsTest {
    @isTest
    static void testInsert() {
        Account a = new Account(Name = 'Test Corp', Industry = 'Technology');
        insert a;

        Account fetched = [SELECT Id, Name FROM Account WHERE Name = 'Test Corp' LIMIT 1];
        System.assertEquals('Test Corp', fetched.Name);
    }
}

Run it:

squirex run --method AccountUtilsTest.testInsert