php-phpbb/tests/extension/metadata_manager_test.php

<?php
/**
*
* @package testing
* @copyright (c) 2011 phpBB Group
* @license http://opensource.org/licenses/gpl-2.0.php GNU General Public License v2
*
*/

class metadata_manager_test extends phpbb_database_test_case
{
	protected $class_loader;
	protected $extension_manager;
	protected $phpbb_root_path;

	public function getDataSet()
	{
		return $this->createXMLDataSet(dirname(__FILE__) . '/fixtures/extensions.xml');
	}

	protected function setUp()
	{
		parent::setUp();

		$this->phpbb_root_path = dirname(__FILE__) . '/';

		$this->extension_manager = new phpbb_extension_manager(
			$this->new_dbal(),
			new phpbb_config(array()),
			'phpbb_ext',
			$this->phpbb_root_path,
			'.php',
			new phpbb_mock_cache
		);
	}

	// Should fail from missing composer.json
	public function test_bar()
	{
		$ext_name = 'bar';

		$manager = new phpbb_extension_metadata_manager_test(
			$ext_name,
			$this->new_dbal(),
			$this->extension_manager,
			$this->phpbb_root_path,
			'.php',
			new phpbb_template(
				$this->phpbb_root_path,
				'.php',
				new phpbb_config(array()),
				new phpbb_user(),
				new phpbb_style_resource_locator()
			),
			new phpbb_config(array())
		);

		try
		{
			$manager->get_metadata();
		}
		catch(phpbb_extension_exception $e){}

		$this->assertEquals((string) $e, 'The required file does not exist: ' . $this->phpbb_root_path . $this->extension_manager->get_extension_path($ext_name) . 'composer.json');
	}

	// Should be the same as a direct json_decode of the composer.json file
	public function test_foo()
	{
		$ext_name = 'foo';

		$manager = new phpbb_extension_metadata_manager_test(
			$ext_name,
			$this->new_dbal(),
			$this->extension_manager,
			$this->phpbb_root_path,
			'.php',
			new phpbb_template(
				$this->phpbb_root_path,
				'.php',
				new phpbb_config(array()),
				new phpbb_user(),
				new phpbb_style_resource_locator()
			),
			new phpbb_config(array())
		);

		try
		{
			$metadata = $manager->get_metadata();
		}
		catch(phpbb_extension_exception $e)
		{
			$this->fail($e);
		}

		$json = json_decode(file_get_contents($this->phpbb_root_path . 'ext/foo/composer.json'), true);

		$this->assertEquals($metadata, $json);
	}

	public function test_validator()
	{
		$ext_name = 'validator';

		$manager = new phpbb_extension_metadata_manager_test(
			$ext_name,
			$this->new_dbal(),
			$this->extension_manager,
			$this->phpbb_root_path,
			'.php',
			new phpbb_template(
				$this->phpbb_root_path,
				'.php',
				new phpbb_config(array()),
				new phpbb_user(),
				new phpbb_style_resource_locator()
			),
			new phpbb_config(array(
				'version'		=> '3.1.0',
			))
		);

		// Non-existant data
		try
		{
			$manager->validate('name');
		}
		catch(phpbb_extension_exception $e) {}
		$this->assertEquals((string) $e, 'Required meta field \'name\' has not been set.');

		try
		{
			$manager->validate('type');
		}
		catch(phpbb_extension_exception $e) {}
		$this->assertEquals((string) $e, 'Required meta field \'type\' has not been set.');

		try
		{
			$manager->validate('licence');
		}
		catch(phpbb_extension_exception $e) {}
		$this->assertEquals((string) $e, 'Required meta field \'licence\' has not been set.');

		try
		{
			$manager->validate('version');
		}
		catch(phpbb_extension_exception $e) {}
		$this->assertEquals((string) $e, 'Required meta field \'version\' has not been set.');

		try
		{
			$manager->validate_authors();
		}
		catch(phpbb_extension_exception $e) {}
		$this->assertEquals((string) $e, 'Required meta field \'authors\' has not been set.');

		$manager->merge_metadata(array(
			'authors'	=> array(
				array(),
			),
		));

		try
		{
			$manager->validate_authors();
		}
		catch(phpbb_extension_exception $e) {}
		$this->assertEquals((string) $e, 'Required meta field \'author name\' has not been set.');


		// Invalid data
		$manager->set_metadata(array(
			'name'		=> 'asdf',
			'type'		=> 'asdf',
			'licence'	=> '',
			'version'	=> '',
		));

		try
		{
			$manager->validate('name');
		}
		catch(phpbb_extension_exception $e) {}
		$this->assertEquals((string) $e, 'Meta field \'name\' is invalid.');

		try
		{
			$manager->validate('type');
		}
		catch(phpbb_extension_exception $e) {}
		$this->assertEquals((string) $e, 'Meta field \'type\' is invalid.');

		try
		{
			$manager->validate('licence');
		}
		catch(phpbb_extension_exception $e) {}
		$this->assertEquals((string) $e, 'Meta field \'licence\' is invalid.');

		try
		{
			$manager->validate('version');
		}
		catch(phpbb_extension_exception $e) {}
		$this->assertEquals((string) $e, 'Meta field \'version\' is invalid.');


		// Valid data
		$manager->set_metadata(array(
			'name'		=> 'test/foo',
			'type'		=> 'phpbb3-extension',
			'licence'	=> 'GPL v2',
			'version'	=> '1.0.0',
		));

		try
		{
			$this->assertEquals(true, $manager->validate('enable'));
		}
		catch(phpbb_extension_exception $e)
		{
			$this->fail($e);
		}


		// Too high of requirements
		$manager->merge_metadata(array(
			'require'		=> array(
				'php'		=> '10.0.0',
				'phpbb'		=> '3.2.0', // config is set to 3.1.0
			),
		));

		try
		{
			$this->assertEquals(false, $manager->validate_require_php());
			$this->assertEquals(false, $manager->validate_require_phpbb());
		}
		catch(phpbb_extension_exception $e)
		{
			$this->fail($e);
		}


		// Too high of requirements
		$manager->merge_metadata(array(
			'require'		=> array(
				'php'		=> '5.3.0',
				'phpbb'		=> '3.1.0-beta', // config is set to 3.1.0
			),
		));

		try
		{
			$this->assertEquals(true, $manager->validate_require_php());
			$this->assertEquals(true, $manager->validate_require_phpbb());
		}
		catch(phpbb_extension_exception $e)
		{
			$this->fail($e);
		}


		// Too high of requirements
		$manager->merge_metadata(array(
			'require'		=> array(
				'php'		=> '>' . phpversion(),
				'phpbb'		=> '>3.1.0', // config is set to 3.1.0
			),
		));

		try
		{
			$this->assertEquals(false, $manager->validate_require_php());
			$this->assertEquals(false, $manager->validate_require_phpbb());
		}
		catch(phpbb_extension_exception $e)
		{
			$this->fail($e);
		}


		// Too high of current install
		$manager->merge_metadata(array(
			'require'		=> array(
				'php'		=> '<' . phpversion(),
				'phpbb'		=> '<3.1.0', // config is set to 3.1.0
			),
		));

		try
		{
			$this->assertEquals(false, $manager->validate_require_php());
			$this->assertEquals(false, $manager->validate_require_phpbb());
		}
		catch(phpbb_extension_exception $e)
		{
			$this->fail($e);
		}


		// Matching requirements
		$manager->merge_metadata(array(
			'require'		=> array(
				'php'		=> phpversion(),
				'phpbb'		=> '3.1.0', // config is set to 3.1.0
			),
		));

		try
		{
			$this->assertEquals(true, $manager->validate_require_php());
			$this->assertEquals(true, $manager->validate_require_phpbb());
		}
		catch(phpbb_extension_exception $e)
		{
			$this->fail($e);
		}


		// Matching requirements
		$manager->merge_metadata(array(
			'require'		=> array(
				'php'		=> '>=' . phpversion(),
				'phpbb'		=> '>=3.1.0', // config is set to 3.1.0
			),
		));

		try
		{
			$this->assertEquals(true, $manager->validate_require_php());
			$this->assertEquals(true, $manager->validate_require_phpbb());
		}
		catch(phpbb_extension_exception $e)
		{
			$this->fail($e);
		}


		// Matching requirements
		$manager->merge_metadata(array(
			'require'		=> array(
				'php'		=> '<=' . phpversion(),
				'phpbb'		=> '<=3.1.0', // config is set to 3.1.0
			),
		));

		try
		{
			$this->assertEquals(true, $manager->validate_require_php());
			$this->assertEquals(true, $manager->validate_require_phpbb());
		}
		catch(phpbb_extension_exception $e)
		{
			$this->fail($e);
		}
	}
}

class phpbb_extension_metadata_manager_test extends phpbb_extension_metadata_manager
{
	public function set_metadata($metadata)
	{
		$this->metadata = $metadata;
	}

	public function merge_metadata($metadata)
	{
		$this->metadata = array_merge($this->metadata, $metadata);
	}
}