libraryTest.php

<?php

define('LIBRARY_FILE', __DIR__ . '/library.php');

require LIBRARY_FILE;

class PHPAssessmentTests extends PHPUnit_Framework_TestCase
{
    public function test_is_even()
    {
        $this->assertTrue(
            function_exists('isEven'),
            "Expected isEven() function to be present."
        );

        // ensure the funciton returns the correct data type
        $this->assertTrue(
            is_bool(isEven(3)),
            "Expected isEven() function to return a boolean."
        );

        $this->assertTrue(
            is_bool(isEven(4)),
            "Expected isEven() function to return a boolean."
        );

        $this->assertTrue(
            isEven(10),
            "Expected isEven(10) to return true."
        );

        $this->assertTrue(
            isEven('10'),
            "Expected isEven('10') to return true."
        );

        $this->assertFalse(
            isEven(5),
            "Expected isEven(5) to return false."
        );

        $this->assertFalse(
            isEven("Bob"),
            "Expected isEven('Bob') to return false."
        );
    }

    public function test_is_vowel()
    {
        $this->assertTrue(
            function_exists('isVowel'),
            "Expected isVowel() function to be present"
        );

        $this->assertFalse(
            isVowel([1, 2, 3]),
            "Expected isVowel([1, 2, 3]) to return false");

        $this->assertTrue(
            is_bool(isVowel('a')),
            "Expected isVowel() function to return a boolean."
        );

        $this->assertTrue(
            isVowel('a'),
            "Expected isVowel('a') to return true."
        );
        
        $this->assertTrue(
            isVowel('e'),
            "Expected isVowel('e') to return true."
        );

        $this->assertTrue(
            isVowel('I'),
            "Expected isVowel('I') to return true."
        );

        $this->assertTrue(
            isVowel('o'),
            "Expected isVowel('o') to return true."
        );

        $this->assertTrue(
            isVowel('U'),
            "Expected isVowel('U') to return true."
        );

        $this->assertFalse(
            isVowel('B'),
            "Expected isVowel('B') to return false."
        );

        $this->assertFalse(
            isVowel(5),
            "Expected isVowel(5) to return false."
        );
    }

    public function test_first()
    {
        // make sure the function exists
        $this->assertTrue(
            function_exists('first'),
            "Expected first() function to be defined."
        );
        
        // should return first character of a string.
        $this->assertEquals(
            "B", first('Bob'),
            "Expected first('Bob') to return 'B'."
        );
        
        // should return first element of an array.
        $this->assertEquals(
            1, first([1, 2, 3]),
            "Expected first([1, 2, 3]) to return 1."
        );

        // should return first character of a string.
        $this->assertEquals(
            'P', first('Programming'),
            "Expected first(Programming) to return 'P'."
        );

    }

    public function test_second()
    {
        $this->assertTrue(
            function_exists('second'),
            "Expected second() function to be defined."
        );
        
        $this->assertEquals(
            "o", second('Bob'),
            "Expected second('Bob') to return 'o'."
        );
        
        $this->assertEquals(
            2, second([1, 2, 3]),
            "Expected second([1, 2, 3]) to return 2."
        );

        $this->assertEquals(
            "r", second('Programming'),
            "Expected last('Programming') to return 'r'."
        );
    }

    public function test_last()
    {
        $this->assertTrue(
            function_exists('last'),
            "Expected last() function to be defined."
        );
        
        $this->assertEquals(
            "b", last('Bob'),
            "Expected last('Bob') to return 'b'."
        );

        $this->assertEquals(
            "g", last('Programming'),
            "Expected last('Programming') to return 'g'."
        );
        
        $this->assertEquals(
            3, last([1, 2, 3]),
            "Expected last([1, 2, 3]) to return 3."
        );
    }

    public function test_reverse()
    {
        $this->assertTrue(
            function_exists('reverse'),
            "Expected reverse() function to be defined."
        );
        
        $this->assertEquals(
            "boB", reverse('Bob'),
            "Expected reverse('Bob') to return 'boB'."
        );

        $this->assertEquals(
            "gnimmargorP", reverse('Programming'),
            "Expected reverse('Programming') to return 'gnimmargorP'."
        );
        
        $this->assertEquals(
            [3, 2, 1], reverse([1, 2, 3]),
            "Expected reverse([1, 2, 3]) to return [3, 2, 1]."
        );
    }

    public function test_random()
    {
        // The primary challenge to testing a random() function is that it lacks referential transparency.
        // See http://blog.agiledeveloper.com/2016/01/benefits-of-pure-functions-offer.html

        $this->assertTrue(
            function_exists('random'),
            "Expected random() function to be defined."
        );

        // expect a string when passed a string
        $this->assertTrue(
            is_string(random("Banana")),
            "Expected random() to return a random character represented as a string data type when provided a string."
        );

        // expect a number when passed an array of numbers
        $this->assertTrue(
            is_int(random([1, 2, 3])),
            "Expected random([1, 2, 3]) to return an integer since a random element of the array [1, 2, 3] is an integer."
        );

        $this->assertEquals(
            'a', random('aaaaaaaaaaaaaaaaaa'),
            "Expected random('aaaaaaaaaaaaaaaaaa') to return 'a'."
        );

        $this->assertEquals(
            4, random([4, 4, 4, 4, 4]),
            "Expected random([4, 4, 4, 4, 4]) to return 4."
        );

        $this->assertTrue(
            in_array(random([1, 2, 3, 4, 5]), [1, 2, 3, 4, 5]),
            "Expected random([1, 2, 3, 4, 5]) to return 1 or 2 or 3 or 4 or 5."
        );
    }
}