MDL-68200 core: Fix phpdoc for the external return functions
[moodle.git] / search / tests / area_category_test.php
blob9aa25625aa19bd1b98dd6e810d830e3a3761bcc3
1 <?php
2 // This file is part of Moodle - http://moodle.org/
3 //
4 // Moodle is free software: you can redistribute it and/or modify
5 // it under the terms of the GNU General Public License as published by
6 // the Free Software Foundation, either version 3 of the License, or
7 // (at your option) any later version.
8 //
9 // Moodle is distributed in the hope that it will be useful,
10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 // GNU General Public License for more details.
14 // You should have received a copy of the GNU General Public License
15 // along with Moodle. If not, see <http://www.gnu.org/licenses/>.
17 /**
18 * Area category unit tests.
20 * @package core_search
21 * @copyright 2018 Dmitrii Metelkin <dmitriim@catalyst-au.net>
22 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
25 defined('MOODLE_INTERNAL') || die();
27 /**
28 * Area category unit tests.
30 * @package core_search
31 * @copyright 2018 Dmitrii Metelkin <dmitriim@catalyst-au.net>
32 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
34 class search_area_category_testcase extends advanced_testcase {
36 /**
37 * A helper function to get a mocked search area.
38 * @param string $areaid
40 * @return \PHPUnit\Framework\MockObject\MockObject
42 protected function get_mocked_area($areaid) {
43 $builder = $this->getMockBuilder('\core_search\base');
44 $builder->disableOriginalConstructor();
45 $builder->setMethods(array('get_area_id'));
46 $area = $builder->getMockForAbstractClass();
47 $area->method('get_area_id')->willReturn($areaid);
49 return $area;
52 /**
53 * A helper function to get a list of search areas.
55 * @return array
57 protected function get_areas() {
58 $areas = [];
59 $areas[] = $this->get_mocked_area('area1');
60 $areas[] = 'String';
61 $areas[] = 1;
62 $areas[] = '12';
63 $areas[] = true;
64 $areas[] = false;
65 $areas[] = null;
66 $areas[] = [$this->get_mocked_area('area2')];
67 $areas[] = $this;
68 $areas[] = new stdClass();
69 $areas[] = $this->get_mocked_area('area3');
70 $areas[] = $this->get_mocked_area('area4');
72 return $areas;
75 /**
76 * Test default values.
78 public function test_default_values() {
79 $category = new \core_search\area_category('test_name', 'test_visiblename');
81 $this->assertEquals('test_name', $category->get_name());
82 $this->assertEquals('test_visiblename', $category->get_visiblename());
83 $this->assertEquals(0, $category->get_order());
84 $this->assertEquals([], $category->get_areas());
87 /**
88 * Test that all get functions work as expected.
90 public function test_getters() {
91 $category = new \core_search\area_category('test_name', 'test_visiblename', 4, $this->get_areas());
93 $this->assertEquals('test_name', $category->get_name());
94 $this->assertEquals('test_visiblename', $category->get_visiblename());
95 $this->assertEquals(4, $category->get_order());
97 $this->assertTrue(is_array($category->get_areas()));
98 $this->assertCount(3, $category->get_areas());
99 $this->assertTrue(key_exists('area1', $category->get_areas()));
100 $this->assertTrue(key_exists('area3', $category->get_areas()));
101 $this->assertTrue(key_exists('area4', $category->get_areas()));
105 * Test that a list of areas could be set correctly.
107 public function test_list_of_areas_could_be_set() {
108 $category = new \core_search\area_category('test_name', 'test_visiblename');
109 $this->assertEquals([], $category->get_areas());
111 $category->set_areas($this->get_areas());
113 $this->assertTrue(is_array($category->get_areas()));
114 $this->assertCount(3, $category->get_areas());
115 $this->assertTrue(key_exists('area1', $category->get_areas()));
116 $this->assertTrue(key_exists('area3', $category->get_areas()));
117 $this->assertTrue(key_exists('area4', $category->get_areas()));