wordpress-develop/tests/phpunit/tests/includes/helpers.php
Sergey Biryukov cfc3b57488 Docs: Improve inline comments per the documentation standards.
Includes minor code layout fixes for better readability.

See #48303.

git-svn-id: https://develop.svn.wordpress.org/trunk@47122 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-29 00:43:23 +00:00

415 lines
7.7 KiB
PHP

<?php
/**
* @group phpunit
*/
class Tests_TestHelpers extends WP_UnitTestCase {
/**
* @ticket 30522
*/
function data_assertEqualSets() {
return array(
array(
array( 1, 2, 3 ), // Test expected.
array( 1, 2, 3 ), // Test actual.
false, // Exception expected.
),
array(
array( 1, 2, 3 ),
array( 2, 3, 1 ),
false,
),
array(
array( 1, 2, 3 ),
array( 1, 2, 3, 4 ),
true,
),
array(
array( 1, 2, 3, 4 ),
array( 1, 2, 3 ),
true,
),
array(
array( 1, 2, 3 ),
array( 3, 4, 2, 1 ),
true,
),
array(
array( 1, 2, 3 ),
array( 1, 2, 3, 3 ),
true,
),
array(
array( 1, 2, 3 ),
array( 2, 3, 1, 3 ),
true,
),
);
}
/**
* @dataProvider data_assertEqualSets
* @ticket 30522
*/
function test_assertEqualSets( $expected, $actual, $exception ) {
if ( $exception ) {
try {
$this->assertEqualSets( $expected, $actual );
} catch ( PHPUnit_Framework_ExpectationFailedException $ex ) {
return;
}
$this->fail();
} else {
$this->assertEqualSets( $expected, $actual );
}
}
/**
* @ticket 30522
*/
function data_assertEqualSetsWithIndex() {
return array(
array(
array( 1, 2, 3 ), // Test expected.
array( 1, 2, 3 ), // Test actual.
false, // Exception expected.
),
array(
array(
'a' => 1,
'b' => 2,
'c' => 3,
),
array(
'a' => 1,
'b' => 2,
'c' => 3,
),
false,
),
array(
array( 1, 2, 3 ),
array( 2, 3, 1 ),
true,
),
array(
array(
'a' => 1,
'b' => 2,
'c' => 3,
),
array(
'b' => 2,
'c' => 3,
'a' => 1,
),
false,
),
array(
array( 1, 2, 3 ),
array( 1, 2, 3, 4 ),
true,
),
array(
array( 1, 2, 3, 4 ),
array( 1, 2, 3 ),
true,
),
array(
array(
'a' => 1,
'b' => 2,
'c' => 3,
),
array(
'a' => 1,
'b' => 2,
'c' => 3,
'd' => 4,
),
true,
),
array(
array(
'a' => 1,
'b' => 2,
'c' => 3,
'd' => 4,
),
array(
'a' => 1,
'b' => 2,
'c' => 3,
),
true,
),
array(
array( 1, 2, 3 ),
array( 3, 4, 2, 1 ),
true,
),
array(
array(
'a' => 1,
'b' => 2,
'c' => 3,
),
array(
'c' => 3,
'b' => 2,
'd' => 4,
'a' => 1,
),
true,
),
array(
array( 1, 2, 3 ),
array( 1, 2, 3, 3 ),
true,
),
array(
array(
'a' => 1,
'b' => 2,
'c' => 3,
),
array(
'a' => 1,
'b' => 2,
'c' => 3,
'd' => 3,
),
true,
),
array(
array( 1, 2, 3 ),
array( 2, 3, 1, 3 ),
true,
),
array(
array(
'a' => 1,
'b' => 2,
'c' => 3,
),
array(
'c' => 3,
'b' => 2,
'd' => 3,
'a' => 1,
),
true,
),
);
}
/**
* @dataProvider data_assertEqualSetsWithIndex
* @ticket 30522
*/
function test_assertEqualSetsWithIndex( $expected, $actual, $exception ) {
if ( $exception ) {
try {
$this->assertEqualSetsWithIndex( $expected, $actual );
} catch ( PHPUnit_Framework_ExpectationFailedException $ex ) {
return;
}
$this->fail();
} else {
$this->assertEqualSetsWithIndex( $expected, $actual );
}
}
public function test__unregister_post_status() {
register_post_status( 'foo' );
_unregister_post_status( 'foo' );
$stati = get_post_stati();
$this->assertFalse( isset( $stati['foo'] ) );
}
/**
* @ticket 28486
*/
public function test_setExpectedDeprecated() {
$this->setExpectedDeprecated( 'Tests_TestHelpers::mock_deprecated' );
$this->assertTrue( $this->mock_deprecated() );
}
/**
* @ticket 28486
*/
public function test_setExpectedIncorrectUsage() {
$this->setExpectedIncorrectUsage( 'Tests_TestHelpers::mock_incorrect_usage' );
$this->assertTrue( $this->mock_incorrect_usage() );
}
/**
* @ticket 31417
*/
public function test_go_to_should_go_to_home_page_when_passing_the_untrailingslashed_home_url() {
$this->assertFalse( is_home() );
$home = untrailingslashit( get_option( 'home' ) );
$this->go_to( $home );
$this->assertTrue( is_home() );
}
protected function mock_deprecated() {
_deprecated_function( __METHOD__, '2.5' );
return true;
}
protected function mock_incorrect_usage() {
_doing_it_wrong( __METHOD__, __( 'Incorrect usage test' ), '2.5' );
return true;
}
/**
* @ticket 36166
* @expectedException WPDieException
*/
public function test_die_handler_should_handle_wp_error() {
wp_die( new WP_Error( 'test', 'test' ) );
}
/**
* @ticket 46813
* @expectedException WPDieException
*/
public function test_die_handler_should_not_cause_doing_it_wrong_notice_without_wp_query_set() {
unset( $GLOBALS['wp_query'] );
wp_die();
$this->assertEmpty( $this->caught_doing_it_wrong );
}
/**
* @ticket 45933
* @dataProvider data_die_process_input
*/
public function test_die_process_input( $input, $expected ) {
$defaults = array(
'message' => '',
'title' => '',
'args' => array(),
);
$input = wp_parse_args(
$input,
$defaults
);
$expected = wp_parse_args(
$expected,
$defaults
);
list( $message, $title, $args ) = _wp_die_process_input( $input['message'], $input['title'], $input['args'] );
$this->assertSame( $expected['message'], $message );
$this->assertSame( $expected['title'], $title );
// Only check arguments that are explicitly asked for.
$this->assertEqualSets( $expected['args'], array_intersect_key( $args, $expected['args'] ) );
}
public function data_die_process_input() {
return array(
array(
array(
'message' => 'Broken.',
),
array(
'message' => 'Broken.',
'title' => 'WordPress &rsaquo; Error',
'args' => array(
'response' => 500,
'code' => 'wp_die',
'text_direction' => 'ltr',
),
),
),
array(
array(
'message' => 'Broken.',
'title' => 'Fatal Error',
'args' => array(
'response' => null,
),
),
array(
'message' => 'Broken.',
'title' => 'Fatal Error',
'args' => array(
'response' => 500,
),
),
),
array(
array(
'message' => 'More breakage.',
'args' => array(
'response' => 400,
'code' => 'custom_code',
'text_direction' => 'rtl',
),
),
array(
'message' => 'More breakage.',
'title' => 'WordPress &rsaquo; Error',
'args' => array(
'response' => 400,
'code' => 'custom_code',
'text_direction' => 'rtl',
),
),
),
array(
array(
'message' => new WP_Error(
'no_access',
'You do not have access.',
array(
'status' => 403,
'title' => 'Permission Error',
)
),
),
array(
'message' => 'You do not have access.',
'title' => 'Permission Error',
'args' => array(
'response' => 403,
'code' => 'no_access',
),
),
),
);
}
/**
* This test is just a setup for the one that follows.
*
* @ticket 38196
*/
public function test_setup_postdata_globals_should_be_reset_on_teardown__setup() {
$post = self::factory()->post->create_and_get();
$GLOBALS['wp_query'] = new WP_Query();
$GLOBALS['wp_query']->setup_postdata( $post );
$this->assertNotEmpty( $post );
}
/**
* @ticket 38196
*/
public function test_setup_postdata_globals_should_be_reset_on_teardown() {
$globals = array( 'post', 'id', 'authordata', 'currentday', 'currentmonth', 'page', 'pages', 'multipage', 'more', 'numpages' );
foreach ( $globals as $global ) {
$this->assertTrue( ! isset( $GLOBALS[ $global ] ), $global );
}
}
}