wordpress-develop/tests/phpunit/tests/admin/plugin-dependencies/hasCircularDependency.php

<?php
/**
 * Tests for the WP_Plugin_Dependencies::has_circular_dependency() method.
 *
 * @package WordPress
 */

require_once __DIR__ . '/base.php';

/**
 * @group admin
 * @group plugins
 *
 * @covers WP_Plugin_Dependencies::has_circular_dependency
 * @covers WP_Plugin_Dependencies::get_circular_dependencies
 * @covers WP_Plugin_Dependencies::check_for_circular_dependencies
 */
class Tests_Admin_WPPluginDependencies_HasCircularDependency extends WP_PluginDependencies_UnitTestCase {

	/**
	 * Tests that a plugin with a circular dependency will return true.
	 *
	 * @ticket 22316
	 *
	 * @dataProvider data_circular_dependencies
	 *
	 * @param string  $plugin_to_check The plugin file of the plugin to check.
	 * @param array[] $plugins         An array of plugins.
	 */
	public function test_should_return_true_when_a_plugin_has_circular_dependency( $plugin_to_check, $plugins ) {
		$this->set_property_value( 'plugins', $plugins );
		self::$instance::initialize();

		$this->assertTrue( self::$instance::has_circular_dependency( $plugin_to_check ) );
	}

	/**
	 * Data provider.
	 *
	 * @return array[]
	 */
	public function data_circular_dependencies() {
		return array(
			'a plugin that depends on itself' => array(
				'plugin_to_check' => 'dependency/dependency.php',
				'plugins'         => array(
					'dependency/dependency.php' => array(
						'Name'            => 'Dependency 1',
						'RequiresPlugins' => 'dependency',
					),
				),
			),
			'two plugins'                     => array(
				'plugin_to_check' => 'dependency/dependency.php',
				'plugins'         => array(
					'dependency/dependency.php'   => array(
						'Name'            => 'Dependency 1',
						'RequiresPlugins' => 'dependency2',
					),
					'dependency2/dependency2.php' => array(
						'Name'            => 'Dependency 2',
						'RequiresPlugins' => 'dependency',
					),
				),
			),
			'three plugins'                   => array(
				'plugin_to_check' => 'dependency/dependency.php',
				'plugins'         => array(
					'dependency/dependency.php'   => array(
						'Name'            => 'Dependency 1',
						'RequiresPlugins' => 'dependency2',
					),
					'dependency2/dependency2.php' => array(
						'Name'            => 'Dependency 2',
						'RequiresPlugins' => 'dependency3',
					),
					'dependency3/dependency3.php' => array(
						'Name'            => 'Dependency 3',
						'RequiresPlugins' => 'dependency',
					),
				),
			),
			'four plugins'                    => array(
				'plugin_to_check' => 'dependency/dependency.php',
				'plugins'         => array(
					'dependency/dependency.php'   => array(
						'Name'            => 'Dependency 1',
						'RequiresPlugins' => 'dependency4',
					),
					'dependency2/dependency2.php' => array(
						'Name'            => 'Dependency 2',
						'RequiresPlugins' => 'dependency3',
					),
					'dependency3/dependency3.php' => array(
						'Name'            => 'Dependency 3',
						'RequiresPlugins' => 'dependency',
					),
					'dependency4/dependency4.php' => array(
						'Name'            => 'Dependency 4',
						'RequiresPlugins' => 'dependency2',
					),
				),
			),
		);
	}

	/**
	 * Tests that a plugin with no circular dependencies will return false.
	 *
	 * @ticket 22316
	 */
	public function test_should_return_false_when_a_plugin_has_no_circular_dependency() {
		$this->set_property_value(
			'plugins',
			array(
				'dependency/dependency.php' => array(
					'Name'            => 'Dependency 1',
					'RequiresPlugins' => 'dependency2',
				),
			)
		);

		self::$instance::initialize();

		$this->assertFalse( self::$instance::has_circular_dependency( 'dependent/dependent.php' ) );
	}
}