Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.2.x will end 22 April 2024 (12 months).
  • Bug fixes for security issues in 4.2.x will end 7 October 2024 (18 months).
  • PHP version: minimum PHP 8.0.0 Note: minimum PHP version has increased since Moodle 4.1. PHP 8.1.x is supported too.
<?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/>.

/**
 * Unit tests for base entity
 *
 * @package     core_reportbuilder
 * @copyright   2021 David Matamoros <davidmc@moodle.com>
 * @license     http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

declare(strict_types=1);

namespace core_reportbuilder\local\entities;

use advanced_testcase;
use coding_exception;
use lang_string;
< use ReflectionClass;
use core_reportbuilder\local\filters\text; use core_reportbuilder\local\report\column; use core_reportbuilder\local\report\filter; defined('MOODLE_INTERNAL') || die(); /** * Unit tests for base entity * * @package core_reportbuilder * @covers \core_reportbuilder\local\entities\base * @copyright 2021 David Matamoros <davidmc@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class base_test extends advanced_testcase { /** * Test entity table alias */ public function test_get_table_alias(): void { $entity = new base_test_entity(); $this->assertEquals('m', $entity->get_table_alias('mytable')); } /** * Test for invalid get table alias */ public function test_get_table_alias_invalid(): void { $entity = new base_test_entity(); $this->expectException(coding_exception::class); $this->expectExceptionMessage('Coding error detected, it must be fixed by a programmer: ' . 'Invalid table name (nonexistingalias)'); $entity->get_table_alias('nonexistingalias'); } /** * Test setting table alias */ public function test_set_table_alias(): void { $entity = new base_test_entity(); $entity->set_table_alias('mytable', 'newalias'); $this->assertEquals('newalias', $entity->get_table_alias('mytable')); } /** * Test invalid entity set table alias */ public function test_set_table_alias_invalid(): void { $entity = new base_test_entity(); $this->expectException(coding_exception::class); $this->expectExceptionMessage('Coding error detected, it must be fixed by a programmer: Invalid table name (nonexistent)'); $entity->set_table_alias('nonexistent', 'newalias'); } /**
> * Test setting multiple table aliases * Test entity name > */ */ > public function test_set_table_aliases(): void { public function test_set_entity_name(): void { > $entity = new base_test_entity(); $entity = new base_test_entity(); > > $entity->set_table_aliases([ $this->assertEquals('base_test_entity', $entity->get_entity_name()); > 'mytable' => 'newalias', > 'myothertable' => 'newalias2', $entity->set_entity_name('newentityname'); > ]); $this->assertEquals('newentityname', $entity->get_entity_name()); > $this->assertEquals('newalias', $entity->get_table_alias('mytable')); } > $this->assertEquals('newalias2', $entity->get_table_alias('myothertable')); > } /** > * Test invalid entity name > /** */ > * Test setting multiple table aliases, containing an invalid table public function test_set_entity_name_invalid(): void { > */ $entity = new base_test_entity(); > public function test_set_table_aliases_invalid(): void { > $entity = new base_test_entity(); $this->expectException(coding_exception::class); > $this->expectExceptionMessage('Entity name must be comprised of alphanumeric character, underscore or dash'); > $this->expectException(coding_exception::class); $entity->set_entity_name(''); > $this->expectExceptionMessage('Coding error detected, it must be fixed by a programmer: Invalid table name (nonexistent)'); } > $entity->set_table_aliases([ > 'mytable' => 'newalias', /** > 'nonexistent' => 'newalias2', * Test entity title > ]); */ > } public function test_set_entity_title(): void { > $entity = new base_test_entity(); > /**
$this->assertEquals(new lang_string('yes'), $entity->get_entity_title()); $newtitle = new lang_string('fullname'); $entity->set_entity_title($newtitle); $this->assertEquals($newtitle, $entity->get_entity_title()); } /** * Test adding single join */ public function test_add_join(): void { $entity = new base_test_entity(); $tablejoin = "JOIN {course} c2 ON c2.id = c1.id"; $entity->add_join($tablejoin);
< $method = (new ReflectionClass(base_test_entity::class))->getMethod('get_joins'); < $method->setAccessible(true); < $this->assertEquals([$tablejoin], $method->invoke($entity));
> $this->assertEquals([$tablejoin], $entity->get_joins());
} /** * Test adding multiple joins */ public function test_add_joins(): void { $entity = new base_test_entity(); $tablejoins = [ "JOIN {course} c2 ON c2.id = c1.id", "JOIN {course} c3 ON c3.id = c1.id", ]; $entity->add_joins($tablejoins);
< $method = (new ReflectionClass(base_test_entity::class))->getMethod('get_joins'); < $method->setAccessible(true); < $this->assertEquals($tablejoins, $method->invoke($entity));
> $this->assertEquals($tablejoins, $entity->get_joins());
} /** * Test adding duplicate joins */ public function test_add_duplicate_joins(): void { $entity = new base_test_entity(); $tablejoins = [ "JOIN {course} c2 ON c2.id = c1.id", "JOIN {course} c3 ON c3.id = c1.id", ]; $entity ->add_joins($tablejoins) ->add_joins($tablejoins);
< $method = (new ReflectionClass(base_test_entity::class))->getMethod('get_joins'); < $method->setAccessible(true); < $this->assertEquals($tablejoins, $method->invoke($entity));
> $this->assertEquals($tablejoins, $entity->get_joins());
} /** * Test getting column */ public function test_get_column(): void { $entity = (new base_test_entity())->initialise(); $column = $entity->get_column('test'); $this->assertEquals('base_test_entity:test', $column->get_unique_identifier()); } /** * Test for invalid get column */ public function test_get_column_invalid(): void { $entity = (new base_test_entity())->initialise(); $this->expectException(coding_exception::class); $this->expectExceptionMessage('Coding error detected, it must be fixed by a programmer: ' . 'Invalid column name (nonexistingcolumn)'); $entity->get_column('nonexistingcolumn'); } /** * Test getting columns */ public function test_get_columns(): void { $entity = (new base_test_entity())->initialise(); $columns = $entity->get_columns(); $this->assertCount(1, $columns); $this->assertContainsOnlyInstancesOf(column::class, $columns); } /** * Test getting filter */ public function test_get_filter(): void { $entity = (new base_test_entity())->initialise(); $filter = $entity->get_filter('test'); $this->assertEquals('base_test_entity:test', $filter->get_unique_identifier()); } /** * Test for invalid get filter */ public function test_get_filter_invalid(): void { $entity = (new base_test_entity())->initialise(); $this->expectException(coding_exception::class); $this->expectExceptionMessage('Coding error detected, it must be fixed by a programmer: ' . 'Invalid filter name (nonexistingfilter)'); $entity->get_filter('nonexistingfilter'); } /** * Test getting filters */ public function test_get_filters(): void { $entity = (new base_test_entity())->initialise(); $filters = $entity->get_filters(); $this->assertCount(1, $filters); $this->assertContainsOnlyInstancesOf(filter::class, $filters); } /** * Test getting condition */ public function test_get_condition(): void { $entity = (new base_test_entity())->initialise(); $condition = $entity->get_condition('test'); $this->assertEquals('base_test_entity:test', $condition->get_unique_identifier()); } /** * Test for invalid get condition */ public function test_get_condition_invalid(): void { $entity = (new base_test_entity())->initialise(); $this->expectException(coding_exception::class); $this->expectExceptionMessage('Coding error detected, it must be fixed by a programmer: ' . 'Invalid condition name (nonexistingcondition)'); $entity->get_condition('nonexistingcondition'); } /** * Test getting conditions */ public function test_get_conditions(): void { $entity = (new base_test_entity())->initialise(); $conditions = $entity->get_conditions(); $this->assertCount(1, $conditions); $this->assertContainsOnlyInstancesOf(filter::class, $conditions); } } /** * Simple implementation of the base entity */ class base_test_entity extends base { /** * Table aliases * * @return array */ protected function get_default_table_aliases(): array { return [ 'mytable' => 'm', 'myothertable' => 'o', ]; } /** * Entity title * * @return lang_string */ protected function get_default_entity_title(): lang_string { return new lang_string('yes'); } /** * Initialise entity * * @return base */ public function initialise(): base { $column = (new column( 'test', new lang_string('no'), $this->get_entity_name() )) ->add_field('no'); $filter = (new filter( text::class, 'test', new lang_string('no'), $this->get_entity_name(), )) ->set_field_sql('no'); return $this ->add_column($column) ->add_filter($filter) ->add_condition($filter); } }