Run a mock round

The test pyramid is a guideline for balancing automated tests by level.

      /\        E2E (few, slow, brittle)
     /  \
    /----\      Integration (some)
   /------\
  /--------\    Unit (many, fast, cheap)

The base is unit tests: numerous, fast, isolated, checking small pieces. The middle is integration or service tests, verifying that components work together, including databases and HTTP boundaries. The top is end-to-end tests through the UI, which give the most confidence that the whole system works but are slow, flaky and expensive to maintain.

The shape matters because tests have different costs and failure signals. A pyramid catches most bugs cheaply, while an inverted shape, the ice cream cone of many E2E tests, leads to slow pipelines and painful maintenance.

The model is a heuristic, not a law. For a data pipeline, integration tests may dominate. Some teams prefer a testing trophy that emphasises integration tests as the best confidence-to-cost ratio.

Test-driven development is a short cycle that drives design from tests.

1. Red: write a failing test for the smallest next behaviour. It must fail, otherwise it proves nothing.
2. Green: write the simplest code that makes it pass, without worrying about elegance.
3. Refactor: improve the code and tests, removing duplication and clarifying names, while keeping the suite green.

red -> green -> refactor -> repeat

Because tests come first, the code is testable by construction, interfaces are designed from the caller's perspective, and each requirement has a test. The tight feedback loop encourages small steps and prevents scope creep.

Criticisms are real: it does not suit exploratory or UI-heavy work well, it can produce fragmented designs if driven mechanically, and it demands discipline. Variants exist, such as behaviour-driven development with Given-When-Then scenarios, and test-first is also common without the strict refactor step. The lasting value is the safety net and incremental design.

Unit tests exercise a single function, class or module in isolation, with dependencies replaced by fakes. They run in milliseconds, pinpoint failures and are cheap to write. Their weakness is that they say nothing about how pieces fit together.

Integration tests verify that two or more real components work together: a repository against a real or containerised database, a service against an HTTP client, a queue producer and consumer. They catch wiring, serialisation, transaction and configuration bugs, and are slower but still fast enough for CI.

End-to-end tests drive the whole system through its real interfaces, often via a browser with a tool like Playwright, covering the user journey. They give the strongest confidence that the product works, but they are the slowest and most brittle, and failures are harder to diagnose.

unit < integration < e2e    (speed and count)
unit > integration > e2e    (confidence scope, reversed)

Use all three, with most investment near the bottom.

A good unit test is fast, deterministic, isolated and focused on behaviour.

Characteristics:

• Tests one behaviour, with a clear name such as rejects_negative_amount, so a failure tells you what broke.
• Follows Arrange-Act-Assert, keeping setup, action and verification distinct.
• Has no dependence on execution order, shared mutable state, the clock, the network or random values; inject these as dependencies.
• Asserts on observable outcomes rather than internal implementation, so refactoring does not break it.
• Has a single logical assertion concept; multiple asserts are fine if they describe one behaviour.
• Fails with a message that shows expected versus actual.
• Runs in milliseconds, so the suite can run on every save.

@Test void rejectsNegativeAmount() {
    assertThrows(IllegalArgumentException.class,
        () -> account.deposit(-1));
}

Avoid over-mocking, which couples tests to implementation. A test that never fails, or one that fails for unrelated reasons, costs more than it protects.

Testing a distributed system needs a layered strategy, because full end-to-end coverage does not scale.

• Unit tests per service for domain logic, run on every commit.
• Component tests that start one service with its dependencies faked, to test its API and data layer.
• Contract tests, using consumer-driven contracts such as Pact, to verify that a provider still satisfies what consumers expect. This catches integration breaks without a full environment.
• Integration tests against real infrastructure for databases, queues and external gateways, ideally with testcontainers.
• A small number of end-to-end journeys, run against staging, for critical flows.
• Non-functional tests: load, resilience and chaos, to check behaviour under failure.

unit -> component -> contract -> integration -> e2e

Support this with test data management, environment parity, observability in CI and fast feedback. Prefer testing at the lowest layer that can catch a given bug, and make failures easy to localise, because debugging a red pipeline across ten services is the real cost.

Code coverage measures which lines, branches or paths tests execute. It is useful for finding untested code and spotting dead code, and it prevents coverage from silently dropping.

Its limits are important. Coverage says nothing about whether assertions are meaningful. A test can execute every line and assert nothing. It does not prove all input partitions or boundary cases are covered, and high coverage can coexist with serious bugs, including security and concurrency defects. Chasing a number also encourages trivial tests that touch code without checking behaviour.

coverage: did we execute it?
tests:    did we verify it?

Use coverage as a diagnostic and a trend, not a target. A common approach is a modest gate, for example 70 to 80 percent on changed code, plus review of whether critical paths and branches are genuinely tested. Branch and mutation coverage give stronger quality signals, and some code such as generated files should be excluded.

Most bugs hide at the edges of valid ranges, because off-by-one and comparison mistakes concentrate there. Boundary value analysis tests just inside, on and just outside each boundary.

For a valid range of 1 to 100, test 0, 1, 2, 99, 100 and 101. Equivalence partitioning complements it by dividing the input domain into classes expected to behave the same, then testing one representative from each: any number below 1, any in range, any above 100.

partition: (-inf,0] [1,100] [101,inf)
boundary:     0  1 ... 100  101

Boundaries also apply to collections: empty, one element, many and maximum. And to types: zero, negative, very large, null and empty string. For date logic, test month ends, leap years, year boundaries and time zones.

Combine the two techniques: partitions decide what to test, boundaries decide exactly where. This gives strong coverage with few cases.

Legacy code is often defined as code without tests, which makes changing it risky. The core technique is to introduce a seam, a place where behaviour can be substituted without editing the code under test.

Michael Feathers' approach:

1. Identify a change point and find the smallest behaviour to pin down.
2. Break dependencies by extracting interfaces, wrapping static or global calls, and injecting collaborators through constructors or parameters.
3. Write characterisation tests that capture current behaviour, even if it looks wrong, so you know when you change it.
4. Refactor under that safety net in small steps, then add tests for the new behaviour.

class Report {
    Report(Clock clock, Mailer mailer) { ... } // seams injected
}

Tools help: approval or golden-master tests capture output for comparison, and dependency-breaking tools can substitute calls at link time. The risk is over-mocking, so prefer real fakes where feasible. Do not aim for full coverage first; cover the areas you are about to change.

Test doubles stand in for real collaborators. The common kinds differ in what they verify.

• Dummy: passed but never used, just to satisfy a signature.
• Stub: returns canned answers, for example a repository returning a fixed user.
• Spy: a stub that also records how it was called.
• Mock: pre-programmed with expectations and verified, so it asserts interaction.
• Fake: a working but lightweight implementation, such as an in-memory database.

when(repo.find(1)).thenReturn(new User("a")); // stub
verify(email).send(any());                    // mock, checks interaction

Stubbing is about supplying indirect inputs; mocking is about verifying indirect outputs. Prefer stubs and fakes for state-based tests, because asserting on every call couples tests to implementation and makes refactoring painful. Use mocks when the interaction itself is the contract, such as an event being published exactly once. Overusing mocks produces tests that pass while the real integration is broken.