Testing

Starboard attempts to make the porting process as easy as possible. To that end, Starboard provides a compliance test suite, called NPLB (No Platform Left Behind), that porters can use to gauge their progress.

Current State

All of the APIs that Cobalt defines are at least called by NPLB, and most of those APIs are verified in one way or another. The APIs that are most likely to just be implemented by a single system call, such as the Starboard functions defined in string.h and memory.h are not exhaustively tested.

NPLB tests must work on all Starboard implementations, so they may make no assumptions about platform-specific details. Rather, they attempt to define a living contract for the APIs on all platforms.

Test Organization

NPLB tests can be found in the src/starboard/nplb/ directory and are broken out into files by Starboard module and function:

src/starboard/nplb/<module>_<function>_test.cc

Although each test may incidentally test other functions, there is an attempt to keep things as self-contained as possible within a function and module. At the same time, the tests also aim to avoid avoid testing behavior that is effectively tested as part of another test.

For example, the SbSocketSendTo and SbSocketReceiveFrom functions are tested together, ensuring that the API is self-consistent on both sides of a connection. Therefore, only one set of tests exist to cover those use cases, in src/starboard/nplb/socket_receive_from_test.cc.