Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 4.1.x will end 13 November 2023 (12 months).
  • Bug fixes for security issues in 4.1.x will end 10 November 2025 (36 months).
  • PHP version: minimum PHP 7.4.0 Note: minimum PHP version has increased since Moodle 4.0. PHP 8.0.x is supported too.

Differences Between: [Versions 310 and 401] [Versions 39 and 401] [Versions 401 and 402] [Versions 401 and 403]

   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.
  13  //
  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/>.
  16  
  17  namespace core;
  18  
  19  defined('MOODLE_INTERNAL') || die();
  20  
  21  global $CFG;
  22  require_once (__DIR__.'/fixtures/testable_update_api.php');
  23  
  24  /**
  25   * Tests for \core\update\api client.
  26   *
  27   * Please note many of these tests heavily depend on the behaviour of the
  28   * testable_api client. It is important to make sure that the behaviour of the
  29   * testable_api client perfectly matches the actual behaviour of the live
  30   * services on the given API version.
  31   *
  32   * @package   core
  33   * @category  test
  34   * @copyright 2015 David Mudrak <david@moodle.com>
  35   * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  36   */
  37  class update_api_test extends \advanced_testcase {
  38  
  39      /**
  40       * Make sure the $CFG->branch is mapped correctly to the format used by the API.
  41       */
  42      public function test_convert_branch_numbering_format() {
  43  
  44          $client = \core\update\testable_api::client();
  45  
  46          $this->assertSame('2.9', $client->convert_branch_numbering_format(29));
  47          $this->assertSame('3.0', $client->convert_branch_numbering_format('30'));
  48          $this->assertSame('3.1', $client->convert_branch_numbering_format(3.1));
  49          $this->assertSame('3.1', $client->convert_branch_numbering_format('3.1'));
  50          $this->assertSame('10.1', $client->convert_branch_numbering_format(101));
  51          $this->assertSame('10.2', $client->convert_branch_numbering_format('102'));
  52      }
  53  
  54      /**
  55       * Getting info about particular plugin version.
  56       */
  57      public function test_get_plugin_info() {
  58  
  59          $client = \core\update\testable_api::client();
  60  
  61          // The plugin is not found in the plugins directory.
  62          $this->assertFalse($client->get_plugin_info('non_existing', 2015093000));
  63  
  64          // The plugin is known but there is no such version.
  65          $info = $client->get_plugin_info('foo_bar', 2014010100);
  66          $this->assertInstanceOf('\core\update\remote_info', $info);
  67          $this->assertFalse($info->version);
  68  
  69          // Both plugin and the version are available.
  70          foreach (array(2015093000 => MATURITY_STABLE, 2015100400 => MATURITY_STABLE,
  71                  2015100500 => MATURITY_BETA) as $version => $maturity) {
  72              $info = $client->get_plugin_info('foo_bar', $version);
  73              $this->assertInstanceOf('\core\update\remote_info', $info);
  74              $this->assertNotEmpty($info->version);
  75              $this->assertEquals($maturity, $info->version->maturity);
  76          }
  77      }
  78  
  79      /**
  80       * Getting info about the most suitable plugin version for us.
  81       */
  82      public function test_find_plugin() {
  83  
  84          $client = \core\update\testable_api::client();
  85  
  86          // The plugin is not found in the plugins directory.
  87          $this->assertFalse($client->find_plugin('non_existing'));
  88  
  89          // The plugin is known but there is no sufficient version.
  90          $info = $client->find_plugin('foo_bar', 2016010100);
  91          $this->assertFalse($info->version);
  92  
  93          // Both plugin and the version are available. Of the two available
  94          // stable versions, the more recent one is returned.
  95          $info = $client->find_plugin('foo_bar', 2015093000);
  96          $this->assertInstanceOf('\core\update\remote_info', $info);
  97          $this->assertEquals(2015100400, $info->version->version);
  98  
  99          // If any version is required, the most recent most mature one is
 100          // returned.
 101          $info = $client->find_plugin('foo_bar', ANY_VERSION);
 102          $this->assertInstanceOf('\core\update\remote_info', $info);
 103          $this->assertEquals(2015100400, $info->version->version);
 104  
 105          // Less matured versions are returned if needed.
 106          $info = $client->find_plugin('foo_bar', 2015100500);
 107          $this->assertInstanceOf('\core\update\remote_info', $info);
 108          $this->assertEquals(2015100500, $info->version->version);
 109      }
 110  
 111      /**
 112       * Validating the pluginfo.php response data.
 113       */
 114      public function test_validate_pluginfo_format() {
 115  
 116          $client = \core\update\testable_api::client();
 117  
 118          $json = '{"id":127,"name":"Course contents","component":"block_course_contents","source":"https:\/\/github.com\/mudrd8mz\/moodle-block_course_contents","doc":"http:\/\/docs.moodle.org\/20\/en\/Course_contents_block","bugs":"https:\/\/github.com\/mudrd8mz\/moodle-block_course_contents\/issues","discussion":null,"version":{"id":8100,"version":"2015030300","release":"3.0","maturity":200,"downloadurl":"https:\/\/moodle.org\/plugins\/download.php\/8100\/block_course_contents_moodle29_2015030300.zip","downloadmd5":"8d8ae64822f38d278420776f8b42eaa5","vcssystem":"git","vcssystemother":null,"vcsrepositoryurl":"https:\/\/github.com\/mudrd8mz\/moodle-block_course_contents","vcsbranch":"master","vcstag":"v3.0","supportedmoodles":[{"version":2014041100,"release":"2.7"},{"version":2014101000,"release":"2.8"},{"version":2015041700,"release":"2.9"}]}}';
 119  
 120          $data = json_decode($json);
 121          $this->assertInstanceOf('\core\update\remote_info', $client->validate_pluginfo_format($data));
 122          $this->assertEquals(json_encode($data), json_encode($client->validate_pluginfo_format($data)));
 123  
 124          // All properties must be present.
 125          unset($data->version);
 126          $this->assertFalse($client->validate_pluginfo_format($data));
 127  
 128          $data->version = false;
 129          $this->assertEquals(json_encode($data), json_encode($client->validate_pluginfo_format($data)));
 130  
 131          // Some properties may be empty.
 132          $data = json_decode($json);
 133          $data->version->release = null;
 134          $this->assertEquals(json_encode($data), json_encode($client->validate_pluginfo_format($data)));
 135  
 136          // Some properties must not be empty.
 137          $data = json_decode($json);
 138          $data->version->downloadurl = '';
 139          $this->assertFalse($client->validate_pluginfo_format($data));
 140  
 141          // Download URL may be http:// or https:// only.
 142          $data = json_decode($json);
 143          $data->version->downloadurl = 'ftp://archive.moodle.org/block_course_contents/2014041100.zip';
 144          $this->assertFalse($client->validate_pluginfo_format($data));
 145      }
 146  }