atoum / atoum-bundle
Bundle around atoum unit testing framework
Installs: 353 883
Dependents: 11
Suggesters: 0
Security: 0
Stars: 45
Watchers: 19
Forks: 25
Open Issues: 14
Type:symfony-bundle
Requires
- php: >=5.3.3
- atoum/atoum: ^3.1.1
- fzaninotto/faker: 1.*
- symfony/console: >=2.3.0|^3.0
- symfony/css-selector: >=2.3.0|^3.0
- symfony/dom-crawler: >=2.3.0|^3.0
- symfony/finder: >=2.3.0|^3.0
- symfony/framework-bundle: >=2.3.0|^3.0
Requires (Dev)
- symfony/form: 2.*
This package is auto-updated.
Last update: 2024-10-28 18:53:23 UTC
README
This bundle provides a (very) simple integration of atoum, the simple, modern and intuitive unit testing framework for PHP, from mageekguy into Symfony2.
Installation
1 - With composer
{ "require": { "atoum/atoum-bundle": "^1.4" } }
In most of the cases you don't need AtoumBundle in your production environment.
{ "require-dev": { "atoum/atoum-bundle": "^1.4" } }
2 - Command
AtoumBundle is provided with a Symfony command. You can launch atoum tests on specific bundles.
2-a Registering in the kernel
You have to define AtoumBundle on AppKernel
if (in_array($this->getEnvironment(), array('dev', 'test'))) { //..... $bundles[] = new atoum\AtoumBundle\AtoumAtoumBundle(); }
2-b Configuration
Define your bundles on configuration (if you want to use it only in test environment, in config_test.yml
only):
atoum: bundles: # note that the full name, including vendor, is required AcmeFooBundle: ~ # FooBundle is defined with directories Tests/Units, Tests/Controller MeBarBundle: directories: [Tests/Units, Tests/Functional, ...]
2-c Command-line usage
Then you can use:
$ php app/console atoum FooBundle --env=test # launch tests of FooBundle $ php app/console atoum FooBundle BarBundle --env=test # launch tests of FooBundle and BarBundle $ php app/console atoum acme_foo --env=test # launch tests of bundle where alias is acme_foo $ php app/console atoum --env=test # launch tests from configuration.
Simple Usage
Make your test class extend the atoum\AtoumBundle\Test\Units\Test
class of the bundle.
Don't forget to load this class with your favorite method (require, autoload, ...) if you don't use composer.
<?php // src/Acme/MyBundle/Tests/Units/Entity/HelloWorld.php namespace Acme\MyBundle\Tests\Units\Entity; // if you don't use a bootstrap file, (or composer) you need to require the application autoload //require __DIR__ . '/../../../../../../app/autoload.php'; // use path of the atoum.phar as bellow if you don't want to use atoum via composer //require_once __DIR__ . '/../../../../../vendor/mageekguy.atoum.phar'; use atoum\AtoumBundle\Test\Units; class helloWorld extends Units\Test { }
Web test case
You can easily create a kernel environment:
<?php require __DIR__ . '/../../../../../../../app/autoload.php'; use atoum\AtoumBundle\Test\Units; class helloWorld extends Units\WebTestCase { public function testMyTralala() { $client = $this->createClient(); } }
Command test case
You can also easily test a command:
<?php namespace My\Bundle\FoobarBundle\Tests\Units\Command; use atoum\AtoumBundle\Test\Units as AtoumBundle; use mageekguy\atoum; use Symfony\Bundle\FrameworkBundle\Console\Application; use Symfony\Component\Console\Tester\CommandTester; // Assuming that this command will display "Success" if succes, and returns a boolean use My\Bundle\FoobarBundle\Command\FoobarCommand as Base; class FoobarCommand extends AtoumBundle\CommandTestCase { public function testExecute() { $this ->given( $command = new Base() ) ->if($commandTester = $this->createCommandTester($command)) ->then ->boolean($commandTester->execute()) ->isTrue() ->string($commandTester->getDisplay()) ->contains("Success") ; } }
Known issues
- The path of the AppKernel cannot be found, override the method
getKernelDirectory
and add the path to yourapp
directory.
Test a controller
You can test your controller with the ControllerTest
class (it extends WebTestCase
- each file must correspond to a Symfony2 controller):
<?php namespace vendor\FooBundle\Tests\Controller; use atoum\AtoumBundle\Test\Units\WebTestCase; use atoum\AtoumBundle\Test\Controller\ControllerTest; class BarController extends ControllerTest { public function testGet() { $this ->request(array('debug' => true)) ->GET('/demo/' . uniqid()) ->hasStatus(404) ->hasCharset('UTF-8') ->hasVersion('1.1') ->POST('/demo/contact') ->hasStatus(200) ->hasHeader('Content-Type', 'text/html; charset=UTF-8') ->crawler ->hasElement('#contact_form') ->hasChild('input')->exactly(3)->end() ->hasChild('input') ->withAttribute('type', 'email') ->withAttribute('name', 'contact[email]') ->end() ->hasChild('input[type=submit]') ->withAttribute('value', 'Send') ->end() ->hasChild('textarea')->end() ->end() ->hasElement('li') ->withContent('The CSRF token is invalid. Please try to resubmit the form.') ->exactly(1) ->end() ->hasElement('title') ->hasNoChild() ->end() ->hasElement('meta') ->hasNoContent() ->end() ->hasElement('link') ->isEmpty() ->end() ; } }
Test a form type
You can test your form types with the FormTestCase
class as the official symfony 2 documentation shows it.
But as the official documentation fits the PHPUnit testing framework, here comes this documentation
first example atoum-translated :
<?php namespace Acme\DemoBundle\Tests\Form; use Acme\DemoBundle\Entity\TestEntity; use atoum\AtoumBundle\Test\Form; use Acme\DemoBundle\Form\TestEntityType as MyTypeToTest; class TestEntityType extends Form\FormTestCase{ public function testToutCourt() { $formData = array( 'texte1' => 'test 1', 'texte2' => 'test 2', ); $type = new MyTypeToTest(); $form = $this->factory->create($type); $object = new TestEntity(); $object->fromArray($formData); // submit the data to the form directly $form->submit($formData); $this->boolean($form->isSynchronized())->isTrue(); $this->variable($object)->isEqualTo($form->getData()); $view = $form->createView(); $children = $view->children; foreach (array_keys($formData) as $key) { $this->array($formData)->hasKey($key); } } }
Faker data
AtoumBundle integrates with Faker library.
In your tests classes, you have access to a Faker\Generator
instance with the faker
asserter.
public function testMyAmazingFeature() { //..... $randomName = $this->faker->name; $dateTimeBetweenYesterdayAndNow = $this->faker->dateTimeBetween('-1 day', 'now'); //..... }
See Faker's documentation about its usage.