views_handler_field.test

<?php


/**
 * @file
 * Definition of ViewsHandlerFieldTest.
 */

/**
 * Tests the generic field handler.
 *
 * @see views_handler_field
 */
class ViewsHandlerFieldTest extends ViewsSqlTest {
    
    /**
     *
     */
    public static function getInfo() {
        return array(
            'name' => 'Field',
            'description' => 'Test the core views_handler_field handler.',
            'group' => 'Views Handlers',
        );
    }
    
    /**
     * {@inheritdoc}
     */
    public function setUp(array $modules = array()) {
        parent::setUp($modules);
        $this->column_map = array(
            'views_test_name' => 'name',
        );
    }
    
    /**
     * Tests the hide if empty functionality.
     *
     * This tests alters the result to get easier and less coupled results.
     */
    public function testHideIfEmpty() {
        $view = $this->getBasicView();
        $view->init_display();
        $this->executeView($view);
        $column_map_reversed = array_flip($this->column_map);
        $view->row_index = 0;
        $random_name = $this->randomName();
        $random_value = $this->randomName();
        // Test when results are not rewritten and empty values are not hidden.
        $view->field['name']->options['hide_alter_empty'] = FALSE;
        $view->field['name']->options['hide_empty'] = FALSE;
        $view->field['name']->options['empty_zero'] = FALSE;
        // Test a valid string.
        $view->result[0]->{$column_map_reversed['name']} = $random_name;
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, $random_name, 'By default, a string should not be treated as empty.');
        // Test an empty string.
        $view->result[0]->{$column_map_reversed['name']} = "";
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, "", 'By default, "" should not be treated as empty.');
        // Test zero as an integer.
        $view->result[0]->{$column_map_reversed['name']} = 0;
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, '0', 'By default, 0 should not be treated as empty.');
        // Test zero as a string.
        $view->result[0]->{$column_map_reversed['name']} = "0";
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, "0", 'By default, "0" should not be treated as empty.');
        // Test when results are not rewritten and non-zero empty values are hidden.
        $view->field['name']->options['hide_alter_empty'] = TRUE;
        $view->field['name']->options['hide_empty'] = TRUE;
        $view->field['name']->options['empty_zero'] = FALSE;
        // Test a valid string.
        $view->result[0]->{$column_map_reversed['name']} = $random_name;
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, $random_name, 'If hide_empty is checked, a string should not be treated as empty.');
        // Test an empty string.
        $view->result[0]->{$column_map_reversed['name']} = "";
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, "", 'If hide_empty is checked, "" should be treated as empty.');
        // Test zero as an integer.
        $view->result[0]->{$column_map_reversed['name']} = 0;
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, '0', 'If hide_empty is checked, but not empty_zero, 0 should not be treated as empty.');
        // Test zero as a string.
        $view->result[0]->{$column_map_reversed['name']} = "0";
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, "0", 'If hide_empty is checked, but not empty_zero, "0" should not be treated as empty.');
        // Test when results are not rewritten and all empty values are hidden.
        $view->field['name']->options['hide_alter_empty'] = TRUE;
        $view->field['name']->options['hide_empty'] = TRUE;
        $view->field['name']->options['empty_zero'] = TRUE;
        // Test zero as an integer.
        $view->result[0]->{$column_map_reversed['name']} = 0;
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, "", 'If hide_empty and empty_zero are checked, 0 should be treated as empty.');
        // Test zero as a string.
        $view->result[0]->{$column_map_reversed['name']} = "0";
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, "", 'If hide_empty and empty_zero are checked, "0" should be treated as empty.');
        // Test when results are rewritten to a valid string and non-zero empty
        // results are hidden.
        $view->field['name']->options['hide_alter_empty'] = FALSE;
        $view->field['name']->options['hide_empty'] = TRUE;
        $view->field['name']->options['empty_zero'] = FALSE;
        $view->field['name']->options['alter']['alter_text'] = TRUE;
        $view->field['name']->options['alter']['text'] = $random_name;
        // Test a valid string.
        $view->result[0]->{$column_map_reversed['name']} = $random_value;
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, $random_name, 'If the rewritten string is not empty, it should not be treated as empty.');
        // Test an empty string.
        $view->result[0]->{$column_map_reversed['name']} = "";
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, $random_name, 'If the rewritten string is not empty, "" should not be treated as empty.');
        // Test zero as an integer.
        $view->result[0]->{$column_map_reversed['name']} = 0;
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, $random_name, 'If the rewritten string is not empty, 0 should not be treated as empty.');
        // Test zero as a string.
        $view->result[0]->{$column_map_reversed['name']} = "0";
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, $random_name, 'If the rewritten string is not empty, "0" should not be treated as empty.');
        // Test when results are rewritten to an empty string and non-zero empty
        // results are hidden.
        $view->field['name']->options['hide_alter_empty'] = TRUE;
        $view->field['name']->options['hide_empty'] = TRUE;
        $view->field['name']->options['empty_zero'] = FALSE;
        $view->field['name']->options['alter']['alter_text'] = TRUE;
        $view->field['name']->options['alter']['text'] = "";
        // Test a valid string.
        $view->result[0]->{$column_map_reversed['name']} = $random_name;
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, $random_name, 'If the rewritten string is empty, it should not be treated as empty.');
        // Test an empty string.
        $view->result[0]->{$column_map_reversed['name']} = "";
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, "", 'If the rewritten string is empty, "" should be treated as empty.');
        // Test zero as an integer.
        $view->result[0]->{$column_map_reversed['name']} = 0;
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, '0', 'If the rewritten string is empty, 0 should not be treated as empty.');
        // Test zero as a string.
        $view->result[0]->{$column_map_reversed['name']} = "0";
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, "0", 'If the rewritten string is empty, "0" should not be treated as empty.');
        // Test when results are rewritten to zero as a string and non-zero empty
        // results are hidden.
        $view->field['name']->options['hide_alter_empty'] = FALSE;
        $view->field['name']->options['hide_empty'] = TRUE;
        $view->field['name']->options['empty_zero'] = FALSE;
        $view->field['name']->options['alter']['alter_text'] = TRUE;
        $view->field['name']->options['alter']['text'] = "0";
        // Test a valid string.
        $view->result[0]->{$column_map_reversed['name']} = $random_name;
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, "0", 'If the rewritten string is zero and empty_zero is not checked, the string rewritten as 0 should not be treated as empty.');
        // Test an empty string.
        $view->result[0]->{$column_map_reversed['name']} = "";
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, "0", 'If the rewritten string is zero and empty_zero is not checked, "" rewritten as 0 should not be treated as empty.');
        // Test zero as an integer.
        $view->result[0]->{$column_map_reversed['name']} = 0;
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, "0", 'If the rewritten string is zero and empty_zero is not checked, 0 should not be treated as empty.');
        // Test zero as a string.
        $view->result[0]->{$column_map_reversed['name']} = "0";
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, "0", 'If the rewritten string is zero and empty_zero is not checked, "0" should not be treated as empty.');
        // Test when results are rewritten to a valid string and non-zero empty
        // results are hidden.
        $view->field['name']->options['hide_alter_empty'] = TRUE;
        $view->field['name']->options['hide_empty'] = TRUE;
        $view->field['name']->options['empty_zero'] = FALSE;
        $view->field['name']->options['alter']['alter_text'] = TRUE;
        $view->field['name']->options['alter']['text'] = $random_value;
        // Test a valid string.
        $view->result[0]->{$column_map_reversed['name']} = $random_name;
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, $random_value, 'If the original and rewritten strings are valid, it should not be treated as empty.');
        // Test an empty string.
        $view->result[0]->{$column_map_reversed['name']} = "";
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, "", 'If either the original or rewritten string is invalid, "" should be treated as empty.');
        // Test zero as an integer.
        $view->result[0]->{$column_map_reversed['name']} = 0;
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, $random_value, 'If the original and rewritten strings are valid, 0 should not be treated as empty.');
        // Test zero as a string.
        $view->result[0]->{$column_map_reversed['name']} = "0";
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, $random_value, 'If the original and rewritten strings are valid, "0" should not be treated as empty.');
        // Test when results are rewritten to zero as a string and all empty
        // original values and results are hidden.
        $view->field['name']->options['hide_alter_empty'] = TRUE;
        $view->field['name']->options['hide_empty'] = TRUE;
        $view->field['name']->options['empty_zero'] = TRUE;
        $view->field['name']->options['alter']['alter_text'] = TRUE;
        $view->field['name']->options['alter']['text'] = "0";
        // Test a valid string.
        $view->result[0]->{$column_map_reversed['name']} = $random_name;
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, "", 'If the rewritten string is zero, it should be treated as empty.');
        // Test an empty string.
        $view->result[0]->{$column_map_reversed['name']} = "";
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, "", 'If the rewritten string is zero, "" should be treated as empty.');
        // Test zero as an integer.
        $view->result[0]->{$column_map_reversed['name']} = 0;
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, "", 'If the rewritten string is zero, 0 should not be treated as empty.');
        // Test zero as a string.
        $view->result[0]->{$column_map_reversed['name']} = "0";
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, "", 'If the rewritten string is zero, "0" should not be treated as empty.');
    }
    
    /**
     * Tests the usage of the empty text.
     */
    public function testEmptyText() {
        $view = $this->getBasicView();
        $view->init_display();
        $this->executeView($view);
        $column_map_reversed = array_flip($this->column_map);
        $view->row_index = 0;
        $empty_text = $view->field['name']->options['empty'] = $this->randomName();
        $view->result[0]->{$column_map_reversed['name']} = "";
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, $empty_text, 'If a field is empty, the empty text should be used for the output.');
        $view->result[0]->{$column_map_reversed['name']} = "0";
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, "0", 'If a field is 0 and empty_zero is not checked, the empty text should not be used for the output.');
        $view->result[0]->{$column_map_reversed['name']} = "0";
        $view->field['name']->options['empty_zero'] = TRUE;
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, $empty_text, 'If a field is 0 and empty_zero is checked, the empty text should be used for the output.');
        $view->result[0]->{$column_map_reversed['name']} = "";
        $view->field['name']->options['alter']['alter_text'] = TRUE;
        $alter_text = $view->field['name']->options['alter']['text'] = $this->randomName();
        $view->field['name']->options['hide_alter_empty'] = FALSE;
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, $alter_text, 'If a field is empty, some rewrite text exists, but hide_alter_empty is not checked, render the rewrite text.');
        $view->field['name']->options['hide_alter_empty'] = TRUE;
        $render = $view->field['name']
            ->advanced_render($view->result[0]);
        $this->assertIdentical($render, $empty_text, 'If a field is empty, some rewrite text exists, and hide_alter_empty is checked, use the empty text.');
    }
    
    /**
     * Tests views_handler_field::is_value_empty().
     */
    public function testIsValueEmpty() {
        $view = $this->getBasicView();
        $view->init_display();
        $view->init_handlers();
        $field = $view->field['name'];
        $this->assertFalse($field->is_value_empty("not empty", TRUE), 'A normal string is not empty.');
        $this->assertTrue($field->is_value_empty("not empty", TRUE, FALSE), 'A normal string which skips empty() can be seen as empty.');
        $this->assertTrue($field->is_value_empty("", TRUE), '"" is considered as empty.');
        $this->assertTrue($field->is_value_empty('0', TRUE), '"0" is considered as empty if empty_zero is TRUE.');
        $this->assertTrue($field->is_value_empty(0, TRUE), '0 is considered as empty if empty_zero is TRUE.');
        $this->assertFalse($field->is_value_empty('0', FALSE), '"0" is considered not as empty if empty_zero is FALSE.');
        $this->assertFalse($field->is_value_empty(0, FALSE), '0 is considered not as empty if empty_zero is FALSE.');
        $this->assertTrue($field->is_value_empty(NULL, TRUE, TRUE), 'Null should be always seen as empty, regardless of no_skip_empty.');
        $this->assertTrue($field->is_value_empty(NULL, TRUE, FALSE), 'Null should be always seen as empty, regardless of no_skip_empty.');
    }

}