2
// This file is part of Moodle - http://moodle.org/
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.
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/>.
18
* Unit tests for the update checker.
22
* @copyright 2012 David Mudrak <david@moodle.com>
23
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
26
defined('MOODLE_INTERNAL') || die();
29
require_once(__DIR__.'/update_deployer_test.php');
33
* Tests of the basic API of the available update checker.
35
class core_update_checker_testcase extends advanced_testcase {
37
public function test_core_available_update() {
38
$provider = testable_available_update_checker::instance();
39
$this->assertInstanceOf('\core\update\checker', $provider);
41
$provider->fake_current_environment(2012060102.00, '2.3.2 (Build: 20121012)', '2.3', array());
42
$updates = $provider->get_update_info('core');
43
$this->assertCount(2, $updates);
45
$provider->fake_current_environment(2012060103.00, '2.3.3 (Build: 20121212)', '2.3', array());
46
$updates = $provider->get_update_info('core');
47
$this->assertCount(1, $updates);
49
$provider->fake_current_environment(2012060103.00, '2.3.3 (Build: 20121212)', '2.3', array());
50
$updates = $provider->get_update_info('core', array('minmaturity' => MATURITY_STABLE));
51
$this->assertNull($updates);
55
* If there are no fetched data yet, the first cron should fetch them.
57
public function test_cron_initial_fetch() {
58
$provider = testable_available_update_checker::instance();
59
$provider->fakerecentfetch = null;
60
$provider->fakecurrenttimestamp = -1;
61
$this->setExpectedException('testable_available_update_checker_cron_executed');
66
* If there is a fresh fetch available, no cron execution is expected.
68
public function test_cron_has_fresh_fetch() {
69
$provider = testable_available_update_checker::instance();
70
$provider->fakerecentfetch = time() - 23 * HOURSECS; // Fetched 23 hours ago.
71
$provider->fakecurrenttimestamp = -1;
73
$this->assertTrue(true); // We should get here with no exception thrown.
77
* If there is an outdated fetch, the cron execution is expected.
79
public function test_cron_has_outdated_fetch() {
80
$provider = testable_available_update_checker::instance();
81
$provider->fakerecentfetch = time() - 49 * HOURSECS; // Fetched 49 hours ago.
82
$provider->fakecurrenttimestamp = -1;
83
$this->setExpectedException('testable_available_update_checker_cron_executed');
88
* The first cron after 01:42 AM today should fetch the data.
90
* @see testable_available_update_checker::cron_execution_offset()
92
public function test_cron_offset_execution_not_yet() {
93
$provider = testable_available_update_checker::instance();
94
$provider->fakecurrenttimestamp = mktime(1, 40, 02); // 01:40:02 AM today
95
$provider->fakerecentfetch = $provider->fakecurrenttimestamp - 24 * HOURSECS;
97
$this->assertTrue(true); // We should get here with no exception thrown.
101
* The first cron after 01:42 AM today should fetch the data and then
102
* it is supposed to wait next 24 hours.
104
* @see testable_available_update_checker::cron_execution_offset()
106
public function test_cron_offset_execution() {
107
$provider = testable_available_update_checker::instance();
109
// The cron at 01:45 should fetch the data.
110
$provider->fakecurrenttimestamp = mktime(1, 45, 02); // 01:45:02 AM today
111
$provider->fakerecentfetch = $provider->fakecurrenttimestamp - 24 * HOURSECS - 1;
115
} catch (testable_available_update_checker_cron_executed $e) {
118
$this->assertTrue($executed, 'Cron should be executed at 01:45:02 but it was not.');
120
// Another cron at 06:45 should still consider data as fresh enough.
121
$provider->fakerecentfetch = $provider->fakecurrenttimestamp;
122
$provider->fakecurrenttimestamp = mktime(6, 45, 03); // 06:45:03 AM
126
} catch (testable_available_update_checker_cron_executed $e) {
129
$this->assertFalse($executed, 'Cron should not be executed at 06:45:03 but it was.');
131
// The next scheduled execution should happen the next day.
132
$provider->fakecurrenttimestamp = $provider->fakerecentfetch + 24 * HOURSECS + 1;
136
} catch (testable_available_update_checker_cron_executed $e) {
139
$this->assertTrue($executed, 'Cron should be executed the next night but it was not.');
142
public function test_compare_responses_both_empty() {
143
$provider = testable_available_update_checker::instance();
146
$cmp = $provider->compare_responses($old, $new);
147
$this->assertInternalType('array', $cmp);
148
$this->assertEmpty($cmp);
151
public function test_compare_responses_old_empty() {
152
$provider = testable_available_update_checker::instance();
158
'version' => 2012060103
163
$cmp = $provider->compare_responses($old, $new);
164
$this->assertInternalType('array', $cmp);
165
$this->assertNotEmpty($cmp);
166
$this->assertTrue(isset($cmp['core'][0]['version']));
167
$this->assertEquals(2012060103, $cmp['core'][0]['version']);
170
public function test_compare_responses_no_change() {
171
$provider = testable_available_update_checker::instance();
176
'version' => 2012060104
179
'version' => 2012120100
184
'version' => 2011010101
189
$cmp = $provider->compare_responses($old, $new);
190
$this->assertInternalType('array', $cmp);
191
$this->assertEmpty($cmp);
194
public function test_compare_responses_new_and_missing_update() {
195
$provider = testable_available_update_checker::instance();
200
'version' => 2012060104
205
'version' => 2011010101
214
'version' => 2012060104
217
'version' => 2012120100
222
$cmp = $provider->compare_responses($old, $new);
223
$this->assertInternalType('array', $cmp);
224
$this->assertNotEmpty($cmp);
225
$this->assertCount(1, $cmp);
226
$this->assertCount(1, $cmp['core']);
227
$this->assertEquals(2012120100, $cmp['core'][0]['version']);
230
public function test_compare_responses_modified_update() {
231
$provider = testable_available_update_checker::instance();
236
'version' => 2011010101
245
'version' => 2011010102
250
$cmp = $provider->compare_responses($old, $new);
251
$this->assertInternalType('array', $cmp);
252
$this->assertNotEmpty($cmp);
253
$this->assertCount(1, $cmp);
254
$this->assertCount(1, $cmp['mod_foo']);
255
$this->assertEquals(2011010102, $cmp['mod_foo'][0]['version']);
258
public function test_compare_responses_invalid_format() {
259
$provider = testable_available_update_checker::instance();
261
'status' => 'ERROR' // No 'updates' key here.
263
$this->setExpectedException('\core\update\checker_exception');
264
$cmp = $provider->compare_responses($broken, $broken);
267
public function test_is_same_release_explicit() {
268
$provider = testable_available_update_checker::instance();
269
$this->assertTrue($provider->is_same_release('2.3dev (Build: 20120323)', '2.3dev (Build: 20120323)'));
270
$this->assertTrue($provider->is_same_release('2.3dev (Build: 20120323)', '2.3dev (Build: 20120330)'));
271
$this->assertFalse($provider->is_same_release('2.3dev (Build: 20120529)', '2.3 (Build: 20120601)'));
272
$this->assertFalse($provider->is_same_release('2.3dev', '2.3 dev'));
273
$this->assertFalse($provider->is_same_release('2.3.1', '2.3'));
274
$this->assertFalse($provider->is_same_release('2.3.1', '2.3.2'));
275
$this->assertTrue($provider->is_same_release('2.3.2+', '2.3.2')); // Yes, really!
276
$this->assertTrue($provider->is_same_release('2.3.2 (Build: 123456)', '2.3.2+ (Build: 123457)'));
277
$this->assertFalse($provider->is_same_release('3.0 Community Edition', '3.0 Enterprise Edition'));
278
$this->assertTrue($provider->is_same_release('3.0 Community Edition', '3.0 Community Edition (Build: 20290101)'));
281
public function test_is_same_release_implicit() {
282
$provider = testable_available_update_checker::instance();
283
$provider->fake_current_environment(2012060102.00, '2.3.2 (Build: 20121012)', '2.3', array());
284
$this->assertTrue($provider->is_same_release('2.3.2'));
285
$this->assertTrue($provider->is_same_release('2.3.2+'));
286
$this->assertTrue($provider->is_same_release('2.3.2+ (Build: 20121013)'));
287
$this->assertFalse($provider->is_same_release('2.4dev (Build: 20121012)'));