LinuxCommandLibrary

atoum

Modern PHP unit testing framework

TLDR

Run tests

$ atoum -f [tests/units/MyTest.php]
copy
Run all tests in directory
$ atoum -d [tests/units]
copy
Run with code coverage
$ atoum -d [tests/] -c
copy
Generate HTML coverage report
$ atoum -d [tests/] --coverage-html [coverage/]
copy
Run tests in debug mode
$ atoum -d [tests/] --debug
copy

SYNOPSIS

atoum [-f file] [-d directory] [-c] [options]

DESCRIPTION

atoum is a modern PHP unit testing framework emphasizing simplicity and clarity. It provides an intuitive API for writing tests with minimal boilerplate, featuring mocking, code coverage, and parallel execution.
The framework uses a natural, fluent assertion syntax and includes tools for test isolation and dependency injection.

PARAMETERS

-f file

Run specific test file
-d directory
Run all tests in directory
-c, --coverage
Generate code coverage
--coverage-html dir
HTML coverage report
--coverage-xml file
XML coverage report
--debug
Debug mode
-l, --loop
Run tests in continuous mode
-p n, --max-children-number n
Parallel test execution
--fail-if-void-methods
Fail if test methods are empty

CONFIGURATION

.atoum.php

Project-level configuration file for test runners, reports, and coverage settings.

CAVEATS

Requires PHP 5.6+. Less widely adopted than PHPUnit. Some IDE integrations may be limited. Documentation primarily in French.

HISTORY

atoum was created by Frédéric Hardy and first released in 2011 as a modern alternative to PHPUnit, emphasizing developer experience and test clarity.

SEE ALSO

phpunit(1), phpspec(1), behat(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community