PHPackages                             atoum/sfatoumplugin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. atoum/sfatoumplugin

ActiveSymfony1-plugin

atoum/sfatoumplugin
===================

03.2k1PHP

Since Nov 30Pushed 13y ago1 watchersCompare

[ Source](https://github.com/agallou/sfAtoumPlugin)[ Packagist](https://packagist.org/packages/atoum/sfatoumplugin)[ RSS](/packages/atoum-sfatoumplugin/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

*sfAtoumPlugin*
===============

[](#sfatoumplugin)

\##Install

### Using composer

[](#using-composer)

Add this to you dependencies in your composer.json ([example](https://gist.github.com/3006430)) :

```
  "require"     : {
    "atoum/sfAtoumPlugin": "*"
  },

```

After a

`php composer.phar update`

The plugin should be in the plugin folder and atoum in the vendor folder.

Then in your ProjectConfiguration file you have to activate the plugin and define the atoum path.

```
  sfConfig::set('sf_atoum_path', dirname(__FILE__) . '/../vendor/atoum/atoum');

  if (sfConfig::get('sf_environment') != 'prod')
  {
    $this->enablePlugins('sfAtoumPlugin');
  }
```

### Using a git submodule

[](#using-a-git-submodule)

Install atoum as a submodule

`git submodule add git://github.com/atoum/atoum.git lib/vendor/atoum`

Install sfAtoumPlugin as a git submodule

`git submodule add git://github.com/agallou/sfAtoumPlugin.git plugins/sfAtoumPlugin`

Add the plugin in your ProjectConfiguration file

```
  if (sfConfig::get('sf_environment') != 'prod')
  {
    $this->enablePlugins('sfAtoumPlugin');
  }
```

\##Launch tests

`php symfony atoum:test`

You can pass a configuration file (see here for how to write the configuration file :  ) via the -c option :

`php symfony atoum:test -c config/atoum/hudson.php`

All atoum options are available :

```
 ./symfony help atoum:test

Usage:
 symfony atoum:test [-p|--php[="..."]] [--default-report-title[="..."]] [-c|--configurations[="..."]] [--score-file[="..."]] [--max-children-number[="..."]] [--no-code-coverage] [--no-code-coverage-in-directories[="..."]] [--no-code-coverage-for-namespaces[="..."]] [--no-code-coverage-for-classes[="..."]] [-f|--files[="..."]] [-d|--directories[="..."]] [--test-file-extensions[="..."]] [-g|--glob[="..."]] [--tags[="..."]] [-m|--methods[="..."]] [--namespaces[="..."]] [-l|--loop] [--test-it[="..."]] [--test-all[="..."]] [--force-terminal[="..."]] [--bootstrap-file[="..."]] [--use-light-report[="..."]] [--debug[="..."]]

Arguments:
 test-file-or-dir        path to test files or folders

Options:
 --php                              (-p) Path to PHP binary which must be used to run tests (default: Array(    [0] => /usr/bin/php5)) (multiple values allowed)
 --default-report-title             Define default report title with  (multiple values allowed)
 --configurations                   (-c) Use all configuration files  (multiple values allowed)
 --score-file                       Save score in file  (multiple values allowed)
 --max-children-number              Maximum number of sub-processus which will be run simultaneously (multiple values allowed)
 --no-code-coverage                 Disable code coverage
 --no-code-coverage-in-directories  Disable code coverage in directories  (multiple values allowed)
 --no-code-coverage-for-namespaces  Disable code coverage for namespaces  (multiple values allowed)
 --no-code-coverage-for-classes     Disable code coverage for classes  (multiple values allowed)
 --files                            (-f) Execute all unit test files  (multiple values allowed)
 --directories                      (-d) Execute unit test files in all  (default: Array(    [0] => /var/www/ereservation/test/unit/)) (multiple values allowed)
 --test-file-extensions             Execute unit test files with one of extensions  (multiple values allowed)
 --glob                             (-g) Execute unit test files which match  (multiple values allowed)
 --tags                             Execute only unit test with tags  (multiple values allowed)
 --methods                          (-m) Execute all , * may be used as wildcard for class name or method name (multiple values allowed)
 --namespaces                       Execute all classes in all namespaces  (multiple values allowed)
 --loop                             (-l) Execute tests in an infinite loop
 --test-it                          Execute atoum unit tests (multiple values allowed)
 --test-all                         Execute unit tests in directories defined via $script->addTestAllDirectory('path/to/directory') in a configuration file (multiple values allowed)
 --force-terminal                   Force output as in terminal (multiple values allowed)
 --bootstrap-file                   Include  before executing each test method (multiple values allowed)
 --use-light-report                 Use "light" CLI report (multiple values allowed)
 --debug                            Enable debug mode (multiple values allowed)

```

\##Write tests

tests must include the bootstrap

```
require_once __DIR__ . '/../../../../plugins/sfAtoumPlugin/bootstrap/unit.php';
```

\##Atoum

Atoum repository and documentation are available here :

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 93.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/fa2f1549d1da71962df7d2d4f4abcfddfa864b984198eb4c465c6948579d035a?d=identicon)[agallou](/maintainers/agallou)

---

Top Contributors

[![agallou](https://avatars.githubusercontent.com/u/320372?v=4)](https://github.com/agallou "agallou (31 commits)")[![startupz](https://avatars.githubusercontent.com/u/310652?v=4)](https://github.com/startupz "startupz (2 commits)")

### Embed Badge

![Health badge](/badges/atoum-sfatoumplugin/health.svg)

```
[![Health](https://phpackages.com/badges/atoum-sfatoumplugin/health.svg)](https://phpackages.com/packages/atoum-sfatoumplugin)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
