Proyectos de Subversion Moodle

<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.

namespace tool_usertours;

defined('MOODLE_INTERNAL') || die();

global $CFG;
require_once($CFG->libdir . '/formslib.php');

/**
 * Tests for step.
 *
 * @package    tool_usertours
 * @copyright  2016 Andrew Nicols <andrew@nicols.co.uk>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 * @covers \tool_usertours\step
 */
class step_test extends \advanced_testcase {
    /**
     * @var moodle_database
     */
    protected $db;

    /**
     * Setup to store the DB reference.
     */
    public function setUp(): void {
        global $DB;

        $this->db = $DB;
    }

    /**
     * Tear down to restore the original DB reference.
     */
    public function tearDown(): void {
        global $DB;

        $DB = $this->db;
    }

    /**
     * Helper to mock the database.
     *
     * @return moodle_database
     */
    public function mock_database() {
        global $DB;

        $DB = $this->getMockBuilder('moodle_database')
            ->getMock();

        return $DB;
    }

    /**
     * Data provider for the dirty value tester.
     *
     * @return array
     */
    public static function dirty_value_provider(): array {
        return
            [
                'tourid' => [
                    'tourid',
                    [1],
                ],
                'title' => [
                    'title',
                    ['Lorem'],
                ],
                'content' => [
                    'content',
                    ['Lorem'],
                ],
                'targettype' => [
                    'targettype',
                    ['Lorem'],
                ],
                'targetvalue' => [
                    'targetvalue',
                    ['Lorem'],
                ],
                'sortorder' => [
                    'sortorder',
                    [1],
                ],
                'config' => [
                    'config',
                    ['key', 'value'],
                ],
            ];
    }

    /**
     * Test the fetch function.
     */
    public function test_fetch(): void {
        $step = $this->getMockBuilder(\tool_usertours\step::class)
            ->onlyMethods(['reload_from_record'])
            ->getMock();

        $idretval = rand(1, 100);
        $DB = $this->mock_database();
        $DB->method('get_record')
            ->willReturn($idretval);

        $retval = rand(1, 100);
        $step->expects($this->once())
            ->method('reload_from_record')
            ->with($this->equalTo($idretval))
            ->wilLReturn($retval);

        $rc = new \ReflectionClass(\tool_usertours\step::class);
        $rcm = $rc->getMethod('fetch');

        $id = rand(1, 100);
        $this->assertEquals($retval, $rcm->invoke($step, 'fetch', $id));
    }

    /**
     * Test that setters mark things as dirty.
     *
     * @dataProvider dirty_value_provider
     * @param   string  $name       The key to update
     * @param   string  $value      The value to set
     */
    public function test_dirty_values($name, $value): void {
        $step = new \tool_usertours\step();
        $method = 'set_' . $name;
        call_user_func_array([$step, $method], $value);

        $rc = new \ReflectionClass(\tool_usertours\step::class);
        $rcp = $rc->getProperty('dirty');

        $this->assertTrue($rcp->getValue($step));
    }

    /**
     * Provider for is_first_step.
     *
     * @return array
     */
    public static function step_sortorder_provider(): array {
        return [
            [0, 5, true, false],
            [1, 5, false, false],
            [4, 5, false, true],
        ];
    }

    /**
     * Test is_first_step.
     *
     * @dataProvider step_sortorder_provider
     * @param   int     $sortorder      The sortorder to check
     * @param   int     $count          Unused in this function
     * @param   bool    $isfirst        Whether this is the first step
     * @param   bool    $islast         Whether this is the last step
     */
    public function test_is_first_step($sortorder, $count, $isfirst, $islast): void {
        $step = $this->getMockBuilder(\tool_usertours\step::class)
            ->onlyMethods(['get_sortorder'])
            ->getMock();

        $step->expects($this->once())
            ->method('get_sortorder')
            ->willReturn($sortorder);

        $this->assertEquals($isfirst, $step->is_first_step());
    }

    /**
     * Test is_last_step.
     *
     * @dataProvider step_sortorder_provider
     * @param   int     $sortorder      The sortorder to check
     * @param   int     $count          Total number of steps for this test
     * @param   bool    $isfirst        Whether this is the first step
     * @param   bool    $islast         Whether this is the last step
     */
    public function test_is_last_step($sortorder, $count, $isfirst, $islast): void {
        $step = $this->getMockBuilder(\tool_usertours\step::class)
            ->onlyMethods(['get_sortorder', 'get_tour'])
            ->getMock();

        $tour = $this->getMockBuilder(\tool_usertours\tour::class)
            ->onlyMethods(['count_steps'])
            ->getMock();

        $step->expects($this->once())
            ->method('get_tour')
            ->willReturn($tour);

        $tour->expects($this->once())
            ->method('count_steps')
            ->willReturn($count);

        $step->expects($this->once())
            ->method('get_sortorder')
            ->willReturn($sortorder);

        $this->assertEquals($islast, $step->is_last_step());
    }

    /**
     * Test get_config with no keys provided.
     */
    public function test_get_config_no_keys(): void {
        $step = new \tool_usertours\step();

        $rc = new \ReflectionClass(\tool_usertours\step::class);
        $rcp = $rc->getProperty('config');

        $allvalues = (object) [
            'some' => 'value',
            'another' => 42,
            'key' => [
                'somethingelse',
            ],
        ];

        $rcp->setValue($step, $allvalues);

        $this->assertEquals($allvalues, $step->get_config());
    }

    /**
     * Data provider for get_config.
     *
     * @return array
     */
    public static function get_config_provider(): array {
        $allvalues = (object) [
            'some' => 'value',
            'another' => 42,
            'key' => [
                'somethingelse',
            ],
        ];

        $tourconfig = rand(1, 100);
        $forcedconfig = rand(1, 100);

        return [
            'No initial config' => [
                null,
                null,
                null,
                $tourconfig,
                false,
                $forcedconfig,
                (object) [],
            ],
            'All values' => [
                $allvalues,
                null,
                null,
                $tourconfig,
                false,
                $forcedconfig,
                $allvalues,
            ],
            'Valid string value' => [
                $allvalues,
                'some',
                null,
                $tourconfig,
                false,
                $forcedconfig,
                'value',
            ],
            'Valid array value' => [
                $allvalues,
                'key',
                null,
                $tourconfig,
                false,
                $forcedconfig,
                ['somethingelse'],
            ],
            'Invalid value' => [
                $allvalues,
                'notavalue',
                null,
                $tourconfig,
                false,
                $forcedconfig,
                $tourconfig,
            ],
            'Configuration value' => [
                $allvalues,
                'placement',
                null,
                $tourconfig,
                false,
                $forcedconfig,
                $tourconfig,
            ],
            'Invalid value with default' => [
                $allvalues,
                'notavalue',
                'somedefault',
                $tourconfig,
                false,
                $forcedconfig,
                'somedefault',
            ],
            'Value forced at target' => [
                $allvalues,
                'somevalue',
                'somedefault',
                $tourconfig,
                true,
                $forcedconfig,
                $forcedconfig,
            ],
        ];
    }

    /**
     * Test get_config with valid keys provided.
     *
     * @dataProvider get_config_provider
     * @param   object  $values     The config values
     * @param   string  $key        The key
     * @param   mixed   $default    The default value
     * @param   mixed   $tourconfig The tour config
     * @param   bool    $isforced   Whether the setting is forced
     * @param   mixed   $forcedvalue    The example value
     * @param   mixed   $expected   The expected value
     */
    public function test_get_config_valid_keys($values, $key, $default, $tourconfig, $isforced, $forcedvalue, $expected): void {
        $step = $this->getMockBuilder(\tool_usertours\step::class)
            ->onlyMethods(['get_target', 'get_targettype', 'get_tour'])
            ->getMock();

        $rc = new \ReflectionClass(\tool_usertours\step::class);
        $rcp = $rc->getProperty('config');
        $rcp->setValue($step, $values);

        $target = $this->getMockBuilder(\tool_usertours\local\target\base::class)
            ->disableOriginalConstructor()
            ->getMock();

        $target->expects($this->any())
            ->method('is_setting_forced')
            ->willReturn($isforced);

        $target->expects($this->any())
            ->method('get_forced_setting_value')
            ->with($this->equalTo($key))
            ->willReturn($forcedvalue);

        $step->expects($this->any())
            ->method('get_targettype')
            ->willReturn('type');

        $step->expects($this->any())
            ->method('get_target')
            ->willReturn($target);

        $tour = $this->getMockBuilder(\tool_usertours\tour::class)
            ->getMock();

        $tour->expects($this->any())
            ->method('get_config')
            ->willReturn($tourconfig);

        $step->expects($this->any())
            ->method('get_tour')
            ->willReturn($tour);

        $this->assertEquals($expected, $step->get_config($key, $default));
    }

    /**
     * Data provider for set_config.
     */
    public static function set_config_provider(): array {
        $allvalues = (object) [
            'some' => 'value',
            'another' => 42,
            'key' => [
                'somethingelse',
            ],
        ];

        $randvalue = rand(1, 100);

        $provider = [];

        $newvalues = $allvalues;
        $newvalues->some = 'unset';
        $provider['Unset an existing value'] = [
            $allvalues,
            'some',
            null,
            $newvalues,
        ];

        $newvalues = $allvalues;
        $newvalues->some = $randvalue;
        $provider['Set an existing value'] = [
            $allvalues,
            'some',
            $randvalue,
            $newvalues,
        ];

        $provider['Set a new value'] = [
            $allvalues,
            'newkey',
            $randvalue,
            (object) array_merge((array) $allvalues, ['newkey' => $randvalue]),
        ];

        return $provider;
    }

    /**
     * Test that set_config works in the anticipated fashion.
     *
     * @dataProvider set_config_provider
     * @param   mixed   $initialvalues  The inital value to set
     * @param   string  $key        The key to test
     * @param   mixed   $newvalue   The new value to set
     * @param   mixed   $expected   The expected value
     */
    public function test_set_config($initialvalues, $key, $newvalue, $expected): void {
        $step = new \tool_usertours\step();

        $rc = new \ReflectionClass(\tool_usertours\step::class);
        $rcp = $rc->getProperty('config');
        $rcp->setValue($step, $initialvalues);

        $target = $this->getMockBuilder(\tool_usertours\local\target\base::class)
            ->disableOriginalConstructor()
            ->getMock();

        $target->expects($this->any())
            ->method('is_setting_forced')
            ->willReturn(false);

        $step->set_config($key, $newvalue);

        $this->assertEquals($expected, $rcp->getValue($step));
    }

    /**
     * Ensure that non-dirty tours are not persisted.
     */
    public function test_persist_non_dirty(): void {
        $step = $this->getMockBuilder(\tool_usertours\step::class)
            ->onlyMethods([
                'to_record',
                'reload',
            ])
            ->getMock();

        $step->expects($this->never())
            ->method('to_record');

        $step->expects($this->never())
            ->method('reload');

        $this->assertSame($step, $step->persist());
    }

    /**
     * Ensure that new dirty steps are persisted.
     */
    public function test_persist_dirty_new(): void {
        // Mock the database.
        $DB = $this->mock_database();
        $DB->expects($this->once())
            ->method('insert_record')
            ->willReturn(42);

        // Mock the tour.
        $step = $this->getMockBuilder(\tool_usertours\step::class)
            ->onlyMethods([
                'to_record',
                'calculate_sortorder',
                'reload',
            ])
            ->getMock();

        $step->expects($this->once())
            ->method('to_record')
            ->willReturn((object)['id' => 42]);

        $step->expects($this->once())
            ->method('calculate_sortorder');

        $step->expects($this->once())
            ->method('reload');

        $rc = new \ReflectionClass(\tool_usertours\step::class);
        $rcp = $rc->getProperty('dirty');
        $rcp->setValue($step, true);

        $tour = $this->createMock(\tool_usertours\tour::class);
        $rcp = $rc->getProperty('tour');
        $rcp->setValue($step, $tour);

        $this->assertSame($step, $step->persist());
    }

    /**
     * Ensure that new non-dirty, forced steps are persisted.
     */
    public function test_persist_force_new(): void {
        global $DB;

        // Mock the database.
        $DB = $this->mock_database();
        $DB->expects($this->once())
            ->method('insert_record')
            ->willReturn(42);

        // Mock the tour.
        $step = $this->getMockBuilder(\tool_usertours\step::class)
            ->onlyMethods([
                'to_record',
                'calculate_sortorder',
                'reload',
            ])
            ->getMock();

        $step->expects($this->once())
            ->method('to_record')
            ->willReturn((object)['id' => 42]);

        $step->expects($this->once())
            ->method('calculate_sortorder');

        $step->expects($this->once())
            ->method('reload');

        $tour = $this->createMock(\tool_usertours\tour::class);
        $rc = new \ReflectionClass(\tool_usertours\step::class);
        $rcp = $rc->getProperty('tour');
        $rcp->setValue($step, $tour);

        $this->assertSame($step, $step->persist(true));
    }

    /**
     * Ensure that existing dirty steps are persisted.
     */
    public function test_persist_dirty_existing(): void {
        // Mock the database.
        $DB = $this->mock_database();
        $DB->expects($this->once())
            ->method('update_record');

        // Mock the tour.
        $step = $this->getMockBuilder(\tool_usertours\step::class)
            ->onlyMethods([
                'to_record',
                'calculate_sortorder',
                'reload',
            ])
            ->getMock();

        $step->expects($this->once())
            ->method('to_record')
            ->willReturn((object)['id' => 42]);

        $step->expects($this->never())
            ->method('calculate_sortorder');

        $step->expects($this->once())
            ->method('reload');

        $rc = new \ReflectionClass(\tool_usertours\step::class);
        $rcp = $rc->getProperty('id');
        $rcp->setValue($step, 42);

        $rcp = $rc->getProperty('dirty');
        $rcp->setValue($step, true);

        $tour = $this->createMock(\tool_usertours\tour::class);
        $rcp = $rc->getProperty('tour');
        $rcp->setValue($step, $tour);

        $this->assertSame($step, $step->persist());
    }

    /**
     * Ensure that existing non-dirty, forced steps are persisted.
     */
    public function test_persist_force_existing(): void {
        global $DB;

        // Mock the database.
        $DB = $this->mock_database();
        $DB->expects($this->once())
            ->method('update_record');

        // Mock the tour.
        $step = $this->getMockBuilder(\tool_usertours\step::class)
            ->onlyMethods([
                'to_record',
                'calculate_sortorder',
                'reload',
            ])
            ->getMock();

        $step->expects($this->once())
            ->method('to_record')
            ->willReturn((object) ['id' => 42]);

        $step->expects($this->never())
            ->method('calculate_sortorder');

        $step->expects($this->once())
            ->method('reload');

        $rc = new \ReflectionClass(\tool_usertours\step::class);
        $rcp = $rc->getProperty('id');
        $rcp->setValue($step, 42);

        $tour = $this->createMock(\tool_usertours\tour::class);
        $rcp = $rc->getProperty('tour');
        $rcp->setValue($step, $tour);

        $this->assertSame($step, $step->persist(true));
    }

    /**
     * Check that a tour which has never been persisted is removed correctly.
     */
    public function test_remove_non_persisted(): void {
        $step = $this->getMockBuilder(\tool_usertours\step::class)
            ->onlyMethods([])
            ->getMock();

        // Mock the database.
        $DB = $this->mock_database();
        $DB->expects($this->never())
            ->method('delete_records');

        $this->assertNull($step->remove());
    }

    /**
     * Check that a tour which has been persisted is removed correctly.
     */
    public function test_remove_persisted(): void {
        $id = rand(1, 100);

        $tour = $this->getMockBuilder(\tool_usertours\tour::class)
            ->onlyMethods([
                'reset_step_sortorder',
            ])
            ->getMock();

        $tour->expects($this->once())
            ->method('reset_step_sortorder');

        $step = $this->getMockBuilder(\tool_usertours\step::class)
            ->onlyMethods([
                'get_tour',
            ])
            ->getMock();

        $step->expects($this->once())
            ->method('get_tour')
            ->willReturn($tour);

        // Mock the database.
        $DB = $this->mock_database();
        $DB->expects($this->once())
            ->method('delete_records')
            ->with($this->equalTo('tool_usertours_steps'), $this->equalTo(['id' => $id]));

        $rc = new \ReflectionClass(\tool_usertours\step::class);
        $rcp = $rc->getProperty('id');
        $rcp->setValue($step, $id);

        $this->assertEquals($id, $step->get_id());
        $this->assertNull($step->remove());
    }

    /**
     * Data provider for the get_ tests.
     *
     * @return array
     */
    public static function getter_provider(): array {
        return [
            'id' => [
                'id',
                rand(1, 100),
            ],
            'tourid' => [
                'tourid',
                rand(1, 100),
            ],
            'title' => [
                'title',
                'Lorem',
            ],
            'content' => [
                'content',
                'Lorem',
            ],
            'targettype' => [
                'targettype',
                'Lorem',
            ],
            'targetvalue' => [
                'targetvalue',
                'Lorem',
            ],
            'sortorder' => [
                'sortorder',
                rand(1, 100),
            ],
        ];
    }

    /**
     * Test that getters return the configured value.
     *
     * @dataProvider getter_provider
     * @param   string  $key        The key to test
     * @param   mixed   $value      The expected value
     */
    public function test_getters($key, $value): void {
        $step = new \tool_usertours\step();

        $rc = new \ReflectionClass(\tool_usertours\step::class);

        $rcp = $rc->getProperty($key);
        $rcp->setValue($step, $value);

        $getter = 'get_' . $key;

        $this->assertEquals($value, $step->$getter());
    }

    /**
     * Ensure that the get_step_image_from_input function replace PIXICON placeholder with the correct images correctly.
     */
    public function test_get_step_image_from_input(): void {
        // Test step content with single image.
        $stepcontent = '@@PIXICON::tour/tour_mycourses::tool_usertours@@<br>Test';
        $stepcontent = \tool_usertours\step::get_step_image_from_input($stepcontent);

        // If the format is correct, PIXICON placeholder will be replaced with the img tag.
        $this->assertStringStartsWith('<img', $stepcontent);
        $this->assertStringEndsWith('Test', $stepcontent);
        $this->assertStringNotContainsString('PIXICON', $stepcontent);

        // Test step content with multiple images.
        $stepcontent =
            '@@PIXICON::tour/tour_mycourses::tool_usertours@@<br>Test<br>@@PIXICON::tour/tour_myhomepage::tool_usertours@@';
        $stepcontent = \tool_usertours\step::get_step_image_from_input($stepcontent);
        // If the format is correct, PIXICON placeholder will be replaced with the img tag.
        $this->assertStringStartsWith('<img', $stepcontent);
        // We should have 2 img tags here.
        $this->assertEquals(2, substr_count($stepcontent, '<img'));
        $this->assertStringNotContainsString('PIXICON', $stepcontent);

        // Test step content with incorrect format.
        $stepcontent = '@@PIXICON::tour/tour_mycourses<br>Test';
        $stepcontent = \tool_usertours\step::get_step_image_from_input($stepcontent);

        // If the format is not correct, PIXICON placeholder will not be replaced with the img tag.
        $this->assertStringStartsNotWith('<img', $stepcontent);
        $this->assertStringStartsWith('@@PIXICON', $stepcontent);
        $this->assertStringEndsWith('Test', $stepcontent);
        $this->assertStringContainsString('PIXICON', $stepcontent);
    }
}