EnumerationTest.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Core\Tests\Unit\Type;

/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */

use TYPO3\CMS\Core\Tests\Unit\Type\Fixture\Enumeration;
use TYPO3\CMS\Core\Type\Exception\InvalidEnumerationDefinitionException;
use TYPO3\CMS\Core\Type\Exception\InvalidEnumerationValueException;

class EnumerationTest extends \TYPO3\TestingFramework\Core\Unit\UnitTestCase
{
    public function constructorThrowsExceptionIfNoConstantsAreDefined()
    {
        $this->expectException(InvalidEnumerationValueException::class);
        $this->expectExceptionCode(1381512753);

        new Enumeration\MissingConstantsEnumeration();
    }

    public function constructorThrowsExceptionIfInvalidValueIsRequested()
    {
        $this->expectException(InvalidEnumerationValueException::class);
        $this->expectExceptionCode(1381512761);

        new Enumeration\CompleteEnumeration('bar');
    }

    public function loadValuesThrowsExceptionIfGivenValueIsNotAvailableInEnumeration()
    {
        $this->expectException(InvalidEnumerationValueException::class);
        $this->expectExceptionCode(1381512807);

        new Enumeration\MissingConstantsEnumeration(2);
    }

    public function loadValuesThrowsExceptionIfDisallowedTypeIsDefinedAsConstant()
    {
        $this->expectException(InvalidEnumerationDefinitionException::class);
        $this->expectExceptionCode(1381512797);

        new Enumeration\InvalidConstantEnumeration(1);
    }

    public function loadValuesThrowsExceptionIfNoDefaultConstantIsDefinedAndNoValueIsGiven()
    {
        $this->expectException(InvalidEnumerationValueException::class);
        $this->expectExceptionCode(1381512753);

        new Enumeration\MissingDefaultEnumeration();
    }

    public function loadValuesThrowsExceptionIfValueIsDefinedMultipleTimes()
    {
        $this->expectException(InvalidEnumerationDefinitionException::class);
        $this->expectExceptionCode(1381512859);

        new Enumeration\DuplicateConstantValueEnumeration(1);
    }

    public function loadValuesSetsStaticEnumConstants()
    {
        $enumeration = $this->getAccessibleMock(
            \TYPO3\CMS\Core\Tests\Unit\Type\Fixture\Enumeration\CompleteEnumeration::class,
            ['dummy']
        );

        $enumClassName = get_class($enumeration);

        $expectedValue = [
            'INTEGER_VALUE' => 1,
            'STRING_VALUE' => 'foo',
             '__default' => 1
        ];

        $result = $enumeration->_getStatic('enumConstants');
        $this->assertArrayHasKey($enumClassName, $result);
        $this->assertSame($expectedValue, $result[$enumClassName]);
    }

    public function constructorSetsValue()
    {
        $enumeration = $this->getAccessibleMock(
            \TYPO3\CMS\Core\Tests\Unit\Type\Fixture\Enumeration\CompleteEnumeration::class,
            ['dummy'],
            [1]
        );
        $this->assertEquals(1, $enumeration->_get('value'));
    }

    public function setValueSetsValue()
    {
        $enumeration = $this->getAccessibleMock(
            \TYPO3\CMS\Core\Tests\Unit\Type\Fixture\Enumeration\CompleteEnumeration::class,
            ['dummy'],
            [1]
        );
        $enumeration->_call('setValue', 'foo');
        $this->assertEquals('foo', $enumeration->_get('value'));
    }

    public function setValueToAnInvalidValueThrowsException()
    {
        $this->expectException(InvalidEnumerationValueException::class);
        $this->expectExceptionCode(1381615295);

        $enumeration = $this->getAccessibleMock(
            \TYPO3\CMS\Core\Tests\Unit\Type\Fixture\Enumeration\CompleteEnumeration::class,
            ['dummy'],
            [1]
        );
        $enumeration->_call('setValue', 2);
        $this->assertEquals(2, $enumeration->_get('value'));
    }

    public function isValidComparisonExpectations()
    {
        return [
            [
                1,
                1,
                true
            ],
            [
                1,
                '1',
                true
            ],
            [
                '1',
                1,
                true
            ],
            [
                'a1',
                1,
                false
            ],
            [
                1,
                'a1',
                false
            ],
            [
                '1a',
                1,
                false
            ],
            [
                1,
                '1a',
                false
            ],
            [
                'foo',
                'foo',
                true
            ],
            [
                'foo',
                'bar',
                false
            ],
            [
                'foo',
                'foobar',
                false
            ]
        ];
    }

    public function isValidDoesTypeLooseComparison($enumerationValue, $testValue, $expectation)
    {
        $mockName = $this->getUniqueId('CompleteEnumerationMock');
        $enumeration = $this->getAccessibleMock(
            \TYPO3\CMS\Core\Tests\Unit\Type\Fixture\Enumeration\CompleteEnumeration::class,
            ['dummy'],
            [],
            $mockName,
            false
        );
        $enumeration->_setStatic('enumConstants', [$mockName => ['CONSTANT_NAME' => $enumerationValue]]);
        $enumeration->_set('value', $enumerationValue);
        $this->assertSame($expectation, $enumeration->_call('isValid', $testValue));
    }

    public function getConstantsReturnsArrayOfPossibleValuesWithoutDefault()
    {
        $this->assertEquals(['INTEGER_VALUE' => 1, 'STRING_VALUE' => 'foo'], Enumeration\CompleteEnumeration::getConstants());
    }

    public function getConstantsReturnsArrayOfPossibleValuesWithDefaultIfRequested()
    {
        $this->assertEquals(['INTEGER_VALUE' => 1, 'STRING_VALUE' => 'foo', '__default' => 1], Enumeration\CompleteEnumeration::getConstants(true));
    }

    public function getConstantsCanBeCalledOnInstances()
    {
        $enumeration = new Enumeration\CompleteEnumeration();
        $this->assertEquals(['INTEGER_VALUE' => 1, 'STRING_VALUE' => 'foo'], $enumeration->getConstants());
    }

    public function toStringReturnsValueAsString()
    {
        $enumeration = new Enumeration\CompleteEnumeration();
        $this->assertSame('1', $enumeration->__toString());
    }

    public function castReturnsObjectOfEnumerationTypeIfSimpleValueIsGiven()
    {
        $enumeration = Enumeration\CompleteEnumeration::cast(1);
        $this->assertInstanceOf(\TYPO3\CMS\Core\Tests\Unit\Type\Fixture\Enumeration\CompleteEnumeration::class, $enumeration);
    }

    public function castReturnsObjectOfCalledEnumerationTypeIfCalledWithValueOfDifferentType()
    {
        $initialEnumeration = new Enumeration\MissingDefaultEnumeration(1);
        $enumeration = Enumeration\CompleteEnumeration::cast($initialEnumeration);
        $this->assertInstanceOf(\TYPO3\CMS\Core\Tests\Unit\Type\Fixture\Enumeration\CompleteEnumeration::class, $enumeration);
    }

    public function castReturnsGivenObjectIfCalledWithValueOfSameType()
    {
        $initialEnumeration = new Enumeration\CompleteEnumeration(1);
        $enumeration = Enumeration\CompleteEnumeration::cast($initialEnumeration);
        $this->assertSame($initialEnumeration, $enumeration);
    }

    public function castCastsStringToEnumerationWithCorrespondingValue()
    {
        $enumeration = $this->getAccessibleMock(
            \TYPO3\CMS\Core\Tests\Unit\Type\Fixture\Enumeration\CompleteEnumeration::class,
            ['dummy'],
            ['1']
        );
        $this->assertSame(1, $enumeration->_get('value'));
    }

    public function castCastsIntegerToEnumerationWithCorrespondingValue()
    {
        $enumeration = $this->getAccessibleMock(
            \TYPO3\CMS\Core\Tests\Unit\Type\Fixture\Enumeration\CompleteEnumeration::class,
            ['dummy'],
            [1]
        );
        $this->assertSame(1, $enumeration->_get('value'));
    }

    public function equalsReturnsTrueIfIntegerIsGivenThatEqualsEnumerationsIntegerValue()
    {
        $enumeration = new Enumeration\CompleteEnumeration(1);
        $this->assertTrue($enumeration->equals(1));
    }

    public function equalsReturnsTrueIfStringIsGivenThatEqualsEnumerationsIntegerValue()
    {
        $enumeration = new Enumeration\CompleteEnumeration(1);
        $this->assertTrue($enumeration->equals('1'));
    }

    public function equalsReturnsTrueIfEqualEnumerationIsGiven()
    {
        $enumerationFoo = new Enumeration\CompleteEnumeration(1);
        $enumerationBar = new Enumeration\CompleteEnumeration(1);
        $this->assertTrue($enumerationFoo->equals($enumerationBar));
    }

    public function equalsReturnsTrueIfDifferentEnumerationWithSameValueIsGiven()
    {
        $enumerationFoo = new Enumeration\CompleteEnumeration(1);
        $enumerationBar = new Enumeration\MissingDefaultEnumeration(1);
        $this->assertTrue($enumerationFoo->equals($enumerationBar));
    }

    public function equalsReturnsFalseIfDifferentEnumerationWithDifferentValueIsGiven()
    {
        $enumerationFoo = new Enumeration\CompleteEnumeration('foo');
        $enumerationBar = new Enumeration\MissingDefaultEnumeration(1);
        $this->assertFalse($enumerationFoo->equals($enumerationBar));
    }

    public function equalsReturnsFalseIfEnumerationOfSameTypeWithDifferentValueIsGiven()
    {
        $enumerationFoo = new Enumeration\CompleteEnumeration(1);
        $enumerationBar = new Enumeration\CompleteEnumeration('foo');
        $this->assertFalse($enumerationFoo->equals($enumerationBar));
    }

    public function getNameProvidesNameForAvailableConstant()
    {
        $result = Enumeration\CompleteEnumeration::getName(Enumeration\CompleteEnumeration::INTEGER_VALUE);
        $this->assertSame('INTEGER_VALUE', $result);
    }

    public function getNameReturnsEmptyStringForNotAvailableConstant()
    {
        $result = Enumeration\CompleteEnumeration::getName(42);
        $this->assertSame('', $result);
    }

    public function getHumanReadableNameProvidesNameForAvailableConstant()
    {
        $result = Enumeration\CompleteEnumeration::getHumanReadableName(Enumeration\CompleteEnumeration::INTEGER_VALUE);
        $this->assertSame('Integer Value', $result);
    }

    public function getHumanReadableNameReturnsEmptyStringForNotAvailableConstant()
    {
        $result = Enumeration\CompleteEnumeration::getName(42);
        $this->assertSame('', $result);
    }
}