Php unit the-mostunknownparts

The most unknown parts of PHPUnit

Bastian Feder
lapistano@php.net 19th September 2010

Agenda

● PHPUnit on the command line
● Assertions
● Annotations
● Special tests

… on the command line

● -- testdox[-(html|text)]
generates a especially styled test report.
● -- filter <pattern>
filters which testsuite to run.

$ phpunit --filter Handler --testdox .
PHPUnit 3.4.15 by Sebastian Bergmann.

FluentDOMCore
[x] Get handler

FluentDOMHandler
[x] Insert nodes after
[x] Insert nodes before
[x] Append children
[x] Insert children before

… on the command line (continiued)

● -- stop-on-failure
stops the testrun on the first recognized failure.
● -- coverage-(html|source|clover) <(dir|file)>
generates a report on how many lines of the code has how
often been executed.
● -- group <groupname [, groupname]>
runs only the named group(s).
● -- d key[=value]
alter ini-settings (e.g. memory_limit, max_execution_time)

Assertions

„In computer programming, an assertion is a
predicate (for example a true–false statement)
placed in a program to indicate that the
developer thinks that the predicate is always
true at that place. [...]
It may be used to verify that an assumption
made by the programmer during the
implementation of the program remains valid
when the program is executed.. [...]“

(Wikipedia, http://en.wikipedia.org/w/index.php?title=Assertion_(computing)&oldid=382473744)

Assertions (continiued)

assertContains(), assertContainsOnly()

● Cameleon within the asserts, handles
– Strings ( like strpos() )
– Arrays ( like in_array() )

$this->assertContains('baz', 'foobar');

$this->assertContainsOnly('string', array('1', '2', 3));


● assertXMLFileEqualsXMLFile()
● assertXMLStringEqualsXMLFile()
● assertXMLStringEqualsXMLString()

$this->assertXMLFileEqualsXMLFile(
'/path/to/Expected.xml',
'/path/to/Fixture.xml'
);


$ phpunit XmlFileEqualsXmlFileTest.php
PHPUnit 3.4.15 by Sebastian Bergmann.
[…]
1) XmlFileEqualsXmlFileTest::testFailure
Failed asserting that two strings are
equal.
--- Expected
+++ Actual
@@ -1,4 +1,4 @@
<?xml version="1.0"?>
<foo>
- <bar/>
+ <baz/>
</foo>

/dev/tests/XmlFileEqualsXmlFileTest.php:7


assertObjectHasAttribute()
assertClassHasAttribute()

● Overcomes visibilty by using Reflection-API
● Testifies the existance of a property,
not its' content

$this->assertObjectHasAttribute(
'myPrivateAttribute', new stdClass() );

$this->assertObjectHasAttribute(
'myPrivateAttribute', 'stdClass' );


assertAttribute*()

● Asserts the content of a class attribute
regardless its' visibility

[…]
private $collection = array( 1, 2, '3' );
private $name = 'Jakob';
[…]

$this->assertAttributeContainsOnly(
'integer', 'collection', new FluentDOM );

$this->assertAttributeContains(
'ko', 'name', new FluentDOM );


assertType()

// TYPE_OBJECT
$this->assertType( 'FluentDOM', new FluentDOM );

$this->assertInstanceOf( 'FluentDOM', new FluentDOM );

// TYPE_STRING
$this->assertType( 'string', '4221' );

// TYPE_INTEGER
$this->assertType( 'integer', 4221 );

// TYPE_RESSOURCE
$this->assertType( 'resource', fopen('/file.txt', 'r' );


assertSelectEquals(), assertSelectCount()

● Assert the presence, absence, or count of
elements in a document.
● Uses CSS selectors to select DOMNodes
● Handles XML and HTML

$this->assertSelectEquals(
'#myElement', 'myContent', 3, $xml );

$this->assertSelectCount( '#myElement', false, $xml );


assertSelectRegExp()

$xml = = '
<items version="1.0">
<persons>
<person class="firstname">Thomas</person>
<person class="firstname">Jakob</person>
<person class="firstname">Bastian</person>
</persons>
</items>
';

$this->assertSelectRegExp(
'person[class*="name"]','(Jakob|Bastian)', 2, $xml);


assertThat()

● Evaluates constraints to build complex
assertions.

$this->assertThat(
$expected,
$ths->logicalAnd(
$this->isInstanceOf('tire'),
$this->logicalNot(
$this->identicalTo($myFrontTire)
)
)
);

Inverted Assertions

Mostly every assertion has an inverted sibling.
● assertNotContains()
● assertNotThat()
● assertAttributeNotSame()
● […]

Annotations

„In software programming, annotations are
used mainly for the purpose of expanding code
documentation and comments. They are
typically ignored when the code is compiled or
executed.“
( Wikipedia: http://en.wikipedia.org/w/index.php?title=Annotation&oldid=385076084 )

Annotations (continiued)

@covers, @group

/**
* @covers myClass:run
* @group exceptions
* @group Trac-123
*/
public function testInvalidArgumentException() {

$obj = new myClass();
try{
$obj->run( 'invalidArgument' );
$this->fail('Expected exception not thrown.');
} catch ( InvalidArgumentException $e ) {
}
}

Annotations (continiued)

@depends

public function testIsApcAvailable() {

if ( ! extension_loaded( 'apc' ) ) {
$this->markTestSkipped( 'Required APC not available' );
}
}

/**
* @depend testIsApcAvailable
*/
public function testGetFileFromAPC () {

}

Special tests

Testing exceptions
– @expectedException

/**
* @expectedException InvalidArgumentException
*/

$obj->run('invalidArgument');

}

Special tests (continued)

Testing exceptions
– SetExpectedException( 'Exception' )


$this->setExpectedException('InvalidArgumentException ')
$obj->run('invalidArgument');

}

Special tests (continued)

Testing exceptions
– try/catch


try{
$obj->run( 'invalidArgument' );
$this->fail('Expected exception not thrown.');
} catch ( InvalidArgumentException $e ) {
}
}

Special Tests (continiued)

returnCallback()

public function callbackGetObject($name, $className = '')
{
retrun (strtolower($name) == 'Jakob')?: false;
}

[…]

$application = $this->getMock('FluentDOM');
$application
->expects($this->any())
->method('getObject')
->will(
$this->returnCallback(
array($this, 'callbackGetObject')
)
);
[…]


onConsecutiveCalls()

[…]

$application = $this->getMock('FluentDOM');
$application
->expects($this->any())
->method('getObject')
->will(
$this->onConsecutiveCalls(
array($this, 'callbackGetObject',
$this->returnValue(true),
$this->returnValue(false),
$this->equalTo($expected)
)
);

[…]


implecit integration tests

public function testGet() {

$mock = $this->getMock(
'myAbstraction',
array( 'method' )
);

$mock
->expected( $this->once() )
->method( 'methoSd' )
->will( $this->returnValue( 'return' );
}

Slides'n contact

● Please comment the talk on joind.in
http://joind.in/1901
● Slides
http://slideshare.net/lapistano
● Email:
lapistano@php.net

License

 This set of slides and the source code included
in the download package is licensed under the

Creative Commons Attribution-
Noncommercial-Share Alike 2.0 Generic
License

http://creativecommons.org/licenses/by-nc-sa/2.0/deed.en

Php unit the-mostunknownparts

Recommended

More Related Content

What's hot (20)

Similar to Php unit the-mostunknownparts (20)

More from Bastian Feder (15)

Recently uploaded (20)

Php unit the-mostunknownparts