cakephp/tests/TestCase/View/CellTest.php

<?php
/**
 * CakePHP(tm) Tests <http://book.cakephp.org/2.0/en/development/testing.html>
 * Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
 *
 * Licensed under The MIT License
 * For full copyright and license information, please see the LICENSE.txt
 * Redistributions of files must retain the above copyright notice
 *
 * @copyright     Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
 * @link          http://book.cakephp.org/2.0/en/development/testing.html CakePHP(tm) Tests
 * @since         3.0.0
 * @license       http://www.opensource.org/licenses/mit-license.php MIT License
 */
namespace Cake\Test\TestCase\View;

use Cake\Controller\Controller;
use Cake\Core\Configure;
use Cake\Core\Plugin;
use Cake\Event\EventManager;
use Cake\TestSuite\TestCase;
use Cake\View\Cell;
use Cake\View\CellTrait;
use TestApp\View\CustomJsonView;

/**
 * CellTest class.
 *
 * For testing both View\Cell & Utility\CellTrait
 */
class CellTest extends TestCase {

/**
 * setUp method
 *
 * @return void
 */
	public function setUp() {
		parent::setUp();
		Configure::write('App.namespace', 'TestApp');
		Plugin::load(['TestPlugin', 'TestTheme']);
		$request = $this->getMock('Cake\Network\Request');
		$response = $this->getMock('Cake\Network\Response');
		$this->View = new \Cake\View\View($request, $response);
	}

/**
 * tearDown method
 *
 * @return void
 */
	public function tearDown() {
		parent::tearDown();
		Plugin::unload('TestPlugin');
		Plugin::unload('TestTheme');
		unset($this->View);
	}

/**
 * Tests basic cell rendering.
 *
 * @return void
 */
	public function testCellRender() {
		$cell = $this->View->cell('Articles::teaserList');
		$render = "{$cell}";

		$this->assertEquals('teaser_list', $cell->template);
		$this->assertContains('<h2>Lorem ipsum</h2>', $render);
		$this->assertContains('<h2>Usectetur adipiscing eli</h2>', $render);
		$this->assertContains('<h2>Topis semper blandit eu non</h2>', $render);
		$this->assertContains('<h2>Suspendisse gravida neque</h2>', $render);
	}

/**
 * Test __toString() hitting an error when rendering views.
 *
 * @return void
 */
	public function testCellImplictRenderWithError() {
		$capture = function ($errno, $msg) {
			restore_error_handler();
			$this->assertEquals(E_USER_WARNING, $errno);
			$this->assertContains('Could not render cell - Cell view file', $msg);
		};
		set_error_handler($capture);

		$cell = $this->View->cell('Articles::teaserList');
		$cell->template = 'nope';
		$result = "{$cell}";
	}

/**
 * Tests that we are able pass multiple arguments to cell methods.
 *
 * This test sets its own error handler, as PHPUnit won't convert
 * errors into exceptions when the caller is a __toString() method.
 *
 * @return void
 */
	public function testCellWithArguments() {
		$cell = $this->View->cell('Articles::doEcho', ['msg1' => 'dummy', 'msg2' => ' message']);
		$render = "{$cell}";
		$this->assertContains('dummy message', $render);
	}

/**
 * Tests that cell runs default action when none is provided.
 *
 * @return void
 */
	public function testDefaultCellAction() {
		$appCell = $this->View->cell('Articles');

		$this->assertEquals('display', $appCell->template);
		$this->assertContains('dummy', "{$appCell}");

		$pluginCell = $this->View->cell('TestPlugin.Dummy');
		$this->assertContains('dummy', "{$pluginCell}");
		$this->assertEquals('display', $pluginCell->template);
	}

/**
 * Tests manual render() invocation.
 *
 * @return void
 */
	public function testCellManualRender() {
		$cell = $this->View->cell('Articles::doEcho', ['msg1' => 'dummy', 'msg2' => ' message']);
		$this->assertContains('dummy message', $cell->render());

		$cell->teaserList();
		$this->assertContains('<h2>Lorem ipsum</h2>', $cell->render('teaser_list'));
	}

/**
 * Tests manual render() invocation with error
 *
 * @expectedException \Cake\View\Exception\MissingCellViewException
 * @return void
 */
	public function testCellManualRenderError() {
		$cell = $this->View->cell('Articles');
		$cell->render('derp');
	}

/**
 * Test rendering a cell with a theme.
 *
 * @return void
 */
	public function testCellRenderThemed() {
		$this->View->theme = 'TestTheme';
		$cell = $this->View->cell('Articles', ['msg' => 'hello world!']);

		$this->assertEquals($this->View->theme, $cell->theme);
		$this->assertContains('Themed cell content.', $cell->render());
		$this->assertEquals($cell->View->theme, $cell->theme);
	}

/**
 * Tests that using plugin's cells works.
 *
 * @return void
 */
	public function testPluginCell() {
		$cell = $this->View->cell('TestPlugin.Dummy::echoThis', ['msg' => 'hello world!']);
		$this->assertContains('hello world!', "{$cell}");
	}

/**
 * Test that plugin cells can render other view templates.
 *
 * @return void
 */
	public function testPluginCellAlternateTemplate() {
		$cell = $this->View->cell('TestPlugin.Dummy::echoThis', ['msg' => 'hello world!']);
		$cell->template = '../../Element/translate';
		$this->assertContains('This is a translatable string', "{$cell}");
	}

/**
 * Test that plugin cells can render other view templates.
 *
 * @return void
 */
	public function testPluginCellAlternateTemplateRenderParam() {
		$cell = $this->View->cell('TestPlugin.Dummy::echoThis', ['msg' => 'hello world!']);
		$result = $cell->render('../../Element/translate');
		$this->assertContains('This is a translatable string', $result);
	}

/**
 * Tests that using an unexisting cell throws an exception.
 *
 * @expectedException \Cake\View\Exception\MissingCellException
 * @return void
 */
	public function testUnexistingCell() {
		$cell = $this->View->cell('TestPlugin.Void::echoThis', ['arg1' => 'v1']);
		$cell = $this->View->cell('Void::echoThis', ['arg1' => 'v1', 'arg2' => 'v2']);
	}

/**
 * Tests missing method errors
 *
 * @expectedException \BadMethodCallException
 * @expectedExceptionMessage Class TestApp\View\Cell\ArticlesCell does not have a "nope" method.
 * @return void
 */
	public function testCellMissingMethod() {
		$this->View->cell('Articles::nope');
	}

/**
 * Test that cell options are passed on.
 *
 * @return void
 */
	public function testCellOptions() {
		$cell = $this->View->cell('Articles', [], ['limit' => 10, 'nope' => 'nope']);
		$this->assertEquals(10, $cell->limit);
		$this->assertFalse(property_exists('nope', $cell), 'Not a valid option');
	}

/**
 * Test that cells get the helper configuration from the view that created them.
 *
 * @return void
 */
	public function testCellInheritsHelperConfig() {
		$this->View->helpers = ['Url', 'Form', 'Banana'];
		$cell = $this->View->cell('Articles');
		$this->assertSame($this->View->helpers, $cell->helpers);
	}

/**
 * Test that cells the view class name of a custom view passed on.
 *
 * @return void
 */
	public function testCellInheritsCustomViewClass() {
		$request = $this->getMock('Cake\Network\Request');
		$response = $this->getMock('Cake\Network\Response');
		$view = new CustomJsonView($request, $response);
		$cell = $view->cell('Articles');
		$this->assertSame('TestApp\View\CustomJsonView', $cell->viewClass);
	}

}