Rev 1 | Ir a la última revisión | Autoría | Comparar con el anterior | Ultima modificación | Ver Log |
<?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 <https://www.gnu.org/licenses/>.namespace mod_wiki;use wiki_parser_proxy;defined('MOODLE_INTERNAL') || die;global $CFG;require_once($CFG->dirroot . '/mod/wiki/parser/parser.php');/*** Unit tests for the wiki parser** @package mod_wiki* @category test* @copyright 2009 Marc Alier, Jordi Piguillem marc.alier@upc.edu* @copyright 2009 Universitat Politecnica de Catalunya http://www.upc.edu** @author Jordi Piguillem* @author Marc Alier* @author David Jimenez* @author Josep Arus* @author Kenneth Riba** @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later*/class wikiparser_test extends \advanced_testcase {/*** URL inside the clickable text of some link should not be turned into a new link via the url_tag_rule.** @dataProvider urls_inside_link_text_provider* @param string $markup Markup of the Wiki page the text is part of.* @param string $input The input text.* @param string $output The expected output HTML as a result of the parsed input text.*/public function test_urls_inside_link_text(string $markup, string $input, string $output): void {$parsingresult = wiki_parser_proxy::parse($input, $markup, ['link_callback' => '/mod/wiki/locallib.php:wiki_parser_link','link_callback_args' => ['swid' => 1],]);$this->assertStringContainsString($output, $parsingresult['parsed_text']);}/*** Provides data sets for {@see self::test_urls_inside_link_text()}.** @return array*/public function urls_inside_link_text_provider() {return ['creole implicit link' => ['markup' => 'creole','input' => 'Visit https://site.url for more information.','output' => 'Visit <a href="https://site.url">https://site.url</a> for more information.',],'creole explicit link' => ['markup' => 'creole','input' => 'Visit [[https://site.url]] for more information.','output' => 'Visit <a href="https://site.url">https://site.url</a> for more information.',],'creole explicit link with text' => ['markup' => 'creole','input' => 'Visit [[https://site.url|http://www.site.url]] for more information.','output' => 'Visit <a href="https://site.url">http://www.site.url</a> for more information.',],'nwiki implicit link' => ['markup' => 'nwiki','input' => 'Visit https://site.url for more information.','output' => 'Visit <a href="https://site.url">https://site.url</a> for more information.',],'nwiki explicit link' => ['markup' => 'nwiki','input' => 'Visit [https://site.url] for more information.','output' => 'Visit <a href="https://site.url">https://site.url</a> for more information.',],'nwiki explicit link with space separated text' => ['markup' => 'nwiki','input' => 'Visit [https://site.url http://www.site.url] for more information.','output' => 'Visit <a href="https://site.url">http://www.site.url</a> for more information.',],'nwiki explicit link with pipe separated text' => ['markup' => 'nwiki','input' => 'Visit [https://site.url|http://www.site.url] for more information.','output' => 'Visit <a href="https://site.url">http://www.site.url</a> for more information.',],'html implicit link' => ['markup' => 'html','input' => 'Visit https://site.url for more information.','output' => 'Visit <a href="https://site.url">https://site.url</a> for more information.',],'html explicit link with text' => ['markup' => 'html','input' => 'Visit <a href="https://site.url">http://www.site.url</a> for more information.','output' => 'Visit <a href="https://site.url">http://www.site.url</a> for more information.',],'html wiki link to non-existing page' => ['markup' => 'html','input' => 'Visit [[Another page]] for more information.','output' => 'Visit <a class="wiki_newentry" ' .'href="https://www.example.com/moodle/mod/wiki/create.php?swid=1&title=Another+page&action=new">' .'Another page</a> for more information.',],'html wiki link inside an explicit link' => [// The explicit href URL takes precedence here, the [[...]] is not turned into a wiki link.'markup' => 'html','input' => 'Visit <a href="https://site.url">[[Another page]]</a> for more information.','output' => 'Visit <a href="https://site.url">[[Another page]]</a> for more information.',],];}function testCreoleMarkup() {$this->assertTestFiles('creole');}function testNwikiMarkup() {$this->assertTestFiles('nwiki');}function testHtmlMarkup() {$this->assertTestFiles('html');}private function assertTestFile($num, $markup) {if(!file_exists(__DIR__."/fixtures/input/$markup/$num") || !file_exists(__DIR__."/fixtures/output/$markup/$num")) {return false;}$input = file_get_contents(__DIR__."/fixtures/input/$markup/$num");$output = file_get_contents(__DIR__."/fixtures/output/$markup/$num");$result = wiki_parser_proxy::parse($input, $markup, array('pretty_print' => true));//removes line breaks to avoid line break encoding causing tests to fail.$result['parsed_text'] = preg_replace('~[\r\n]~', '', $result['parsed_text']);$output = preg_replace('~[\r\n]~', '', $output);$this->assertEquals($output, $result['parsed_text'], 'Failed asserting that two strings are equal. Markup = '.$markup.", num = $num");return true;}private function assertTestFiles($markup) {$i = 1;while($this->assertTestFile($i, $markup)) {$i++;}}/*** Check that headings with special characters work as expected with HTML.** - The heading itself is well displayed,* - The TOC heading is well display,* - The edit link points to the right page,* - The links properly works with get_section.*/public function test_special_headings(): void {// First testing HTML markup.// Test section name using HTML entities.$input = '<h1>Code & Test</h1>';$output = '<h3><a name="toc-1"></a>Code & Test <a href="edit.php?pageid=&section=Code+%26amp%3B+Test" '.'class="wiki_edit_section">[edit]</a></h3>' . "\n";$toc = '<div class="wiki-toc"><p class="wiki-toc-title">Table of contents</p><p class="wiki-toc-section-1 '.'wiki-toc-section">1. <a href="#toc-1">Code & Test <a href="edit.php?pageid=&section=Code+%26amp%3B+'.'Test" class="wiki_edit_section">[edit]</a></a></p></div>';$section = wiki_parser_proxy::get_section($input, 'html', 'Code & Test');$actual = wiki_parser_proxy::parse($input, 'html');$this->assertEquals($output, $actual['parsed_text']);$this->assertEquals($toc, $actual['toc']);$this->assertNotEquals(false, $section);// Test section name using non-ASCII characters.$input = '<h1>Another áéíóúç€ test</h1>';$output = '<h3><a name="toc-1"></a>Another áéíóúç€ test <a href="edit.php?pageid=&section=Another+%C'.'3%A1%C3%A9%C3%AD%C3%B3%C3%BA%C3%A7%E2%82%AC+test" class="wiki_edit_section">[edit]</a></h3>' . "\n";$toc = '<div class="wiki-toc"><p class="wiki-toc-title">Table of contents</p><p class="wiki-toc-section-1 '.'wiki-toc-section">1. <a href="#toc-1">Another áéíóúç€ test <a href="edit.php?pageid=&section=Another+%C'.'3%A1%C3%A9%C3%AD%C3%B3%C3%BA%C3%A7%E2%82%AC+test" class="wiki_edit_section">[edit]</a></a></p></div>';$section = wiki_parser_proxy::get_section($input, 'html', 'Another áéíóúç€ test');$actual = wiki_parser_proxy::parse($input, 'html');$this->assertEquals($output, $actual['parsed_text']);$this->assertEquals($toc, $actual['toc']);$this->assertNotEquals(false, $section);// Test section name with a URL.$input = '<h1>Another http://moodle.org test</h1>';$output = '<h3><a name="toc-1"></a>Another <a href="http://moodle.org">http://moodle.org</a> test <a href="edit.php'.'?pageid=&section=Another+http%3A%2F%2Fmoodle.org+test" class="wiki_edit_section">[edit]</a></h3>' . "\n";$toc = '<div class="wiki-toc"><p class="wiki-toc-title">Table of contents</p><p class="wiki-toc-section-1 '.'wiki-toc-section">1. <a href="#toc-1">Another http://moodle.org test <a href="edit.php?pageid=&section='.'Another+http%3A%2F%2Fmoodle.org+test" class="wiki_edit_section">[edit]</a></a></p></div>';$section = wiki_parser_proxy::get_section($input, 'html', 'Another http://moodle.org test');$actual = wiki_parser_proxy::parse($input, 'html', array('link_callback' => '/mod/wiki/locallib.php:wiki_parser_link'));$this->assertEquals($output, $actual['parsed_text']);$this->assertEquals($toc, $actual['toc']);$this->assertNotEquals(false, $section);// Test toc section names being wikilinks.$input = '<h1>[[Heading 1]]</h1><h2>[[Heading A]]</h2><h2>Heading D</h2>';$regexpoutput = '!<h3><a name="toc-1"></a>' .'<a class="wiki_newentry" href.*mod/wiki/create\.php\?.*title=Heading\+1.*action=new.*>Heading 1<.*' .'<h4><a name="toc-2"></a>' .'<a class="wiki_newentry" href.*mod/wiki/create\.php\?.*title=Heading\+A.*action=new.*>Heading A<.*' .'<h4><a name="toc-3"></a>' .'Heading D!ms';$regexptoc = '!<a href="#toc-1">Heading 1.*<a href="#toc-2">Heading A</a>.*<a href="#toc-3">Heading D</a>!ms';$section = wiki_parser_proxy::get_section($input, 'html', 'Another [[wikilinked]] test');$actual = wiki_parser_proxy::parse($input, 'html', array('link_callback' => '/mod/wiki/locallib.php:wiki_parser_link','link_callback_args' => array('swid' => 1)));$this->assertMatchesRegularExpression($regexpoutput, $actual['parsed_text']);$this->assertMatchesRegularExpression($regexptoc, $actual['toc']);// Now going to test Creole markup.// Note that Creole uses links to the escaped version of the section.// Test section name using HTML entities.$input = '= Code & Test =';$output = '<h3><a name="toc-1"></a>Code & Test <a href="edit.php?pageid=&section=Code+%26amp%3B+Test" '.'class="wiki_edit_section">[edit]</a></h3>' . "\n";$toc = '<div class="wiki-toc"><p class="wiki-toc-title">Table of contents</p><p class="wiki-toc-section-1 '.'wiki-toc-section">1. <a href="#toc-1">Code & Test <a href="edit.php?pageid=&section=Code+%26amp%3B+'.'Test" class="wiki_edit_section">[edit]</a></a></p></div>';$section = wiki_parser_proxy::get_section($input, 'creole', 'Code & Test');$actual = wiki_parser_proxy::parse($input, 'creole');$this->assertEquals($output, $actual['parsed_text']);$this->assertEquals($toc, $actual['toc']);$this->assertNotEquals(false, $section);// Test section name using non-ASCII characters.$input = '= Another áéíóúç€ test =';$output = '<h3><a name="toc-1"></a>Another áéíóúç€ test <a href="edit.php?pageid=&section=Another+%C'.'3%A1%C3%A9%C3%AD%C3%B3%C3%BA%C3%A7%E2%82%AC+test" class="wiki_edit_section">[edit]</a></h3>' . "\n";$toc = '<div class="wiki-toc"><p class="wiki-toc-title">Table of contents</p><p class="wiki-toc-section-1 '.'wiki-toc-section">1. <a href="#toc-1">Another áéíóúç€ test <a href="edit.php?pageid=&section=Another+%C'.'3%A1%C3%A9%C3%AD%C3%B3%C3%BA%C3%A7%E2%82%AC+test" class="wiki_edit_section">[edit]</a></a></p></div>';$section = wiki_parser_proxy::get_section($input, 'creole', 'Another áéíóúç€ test');$actual = wiki_parser_proxy::parse($input, 'creole');$this->assertEquals($output, $actual['parsed_text']);$this->assertEquals($toc, $actual['toc']);$this->assertNotEquals(false, $section);// Test section name with a URL, creole does not support linking links in a heading.$input = '= Another http://moodle.org test =';$output = '<h3><a name="toc-1"></a>Another http://moodle.org test <a href="edit.php'.'?pageid=&section=Another+http%3A%2F%2Fmoodle.org+test" class="wiki_edit_section">[edit]</a></h3>' . "\n";$toc = '<div class="wiki-toc"><p class="wiki-toc-title">Table of contents</p><p class="wiki-toc-section-1 '.'wiki-toc-section">1. <a href="#toc-1">Another http://moodle.org test <a href="edit.php?pageid=&section='.'Another+http%3A%2F%2Fmoodle.org+test" class="wiki_edit_section">[edit]</a></a></p></div>';$section = wiki_parser_proxy::get_section($input, 'creole', 'Another http://moodle.org test');$actual = wiki_parser_proxy::parse($input, 'creole');$this->assertEquals($output, $actual['parsed_text']);$this->assertEquals($toc, $actual['toc']);$this->assertNotEquals(false, $section);// Now going to test NWiki markup.// Note that Creole uses links to the escaped version of the section.// Test section name using HTML entities.$input = '= Code & Test =';$output = '<h3><a name="toc-1"></a>Code & Test <a href="edit.php?pageid=&section=Code+%26+Test" '.'class="wiki_edit_section">[edit]</a></h3>' . "\n";$toc = '<div class="wiki-toc"><p class="wiki-toc-title">Table of contents</p><p class="wiki-toc-section-1 '.'wiki-toc-section">1. <a href="#toc-1">Code & Test <a href="edit.php?pageid=&section=Code+%26+'.'Test" class="wiki_edit_section">[edit]</a></a></p></div>';$section = wiki_parser_proxy::get_section($input, 'nwiki', 'Code & Test');$actual = wiki_parser_proxy::parse($input, 'nwiki');$this->assertEquals($output, $actual['parsed_text']);$this->assertEquals($toc, $actual['toc']);$this->assertNotEquals(false, $section);// Test section name using non-ASCII characters.$input = '= Another áéíóúç€ test =';$output = '<h3><a name="toc-1"></a>Another áéíóúç€ test <a href="edit.php?pageid=&section=Another+%C'.'3%A1%C3%A9%C3%AD%C3%B3%C3%BA%C3%A7%E2%82%AC+test" class="wiki_edit_section">[edit]</a></h3>' . "\n";$toc = '<div class="wiki-toc"><p class="wiki-toc-title">Table of contents</p><p class="wiki-toc-section-1 '.'wiki-toc-section">1. <a href="#toc-1">Another áéíóúç€ test <a href="edit.php?pageid=&section=Another+%C'.'3%A1%C3%A9%C3%AD%C3%B3%C3%BA%C3%A7%E2%82%AC+test" class="wiki_edit_section">[edit]</a></a></p></div>';$section = wiki_parser_proxy::get_section($input, 'nwiki', 'Another áéíóúç€ test');$actual = wiki_parser_proxy::parse($input, 'nwiki');$this->assertEquals($output, $actual['parsed_text']);$this->assertEquals($toc, $actual['toc']);$this->assertNotEquals(false, $section);// Test section name with a URL, nwiki does not support linking links in a heading.$input = '= Another http://moodle.org test =';$output = '<h3><a name="toc-1"></a>Another http://moodle.org test <a href="edit.php'.'?pageid=&section=Another+http%3A%2F%2Fmoodle.org+test" class="wiki_edit_section">[edit]</a></h3>' . "\n";$toc = '<div class="wiki-toc"><p class="wiki-toc-title">Table of contents</p><p class="wiki-toc-section-1 '.'wiki-toc-section">1. <a href="#toc-1">Another http://moodle.org test <a href="edit.php?pageid=&section='.'Another+http%3A%2F%2Fmoodle.org+test" class="wiki_edit_section">[edit]</a></a></p></div>';$section = wiki_parser_proxy::get_section($input, 'nwiki', 'Another http://moodle.org test');$actual = wiki_parser_proxy::parse($input, 'nwiki');$this->assertEquals($output, $actual['parsed_text']);$this->assertEquals($toc, $actual['toc']);$this->assertNotEquals(false, $section);// Test section names when headings start with level 3.$input = '<h3>Heading test</h3><h4>Subsection</h4>';$output = '<h3><a name="toc-1"></a>Heading test <a href="edit.php?pageid=&section=Heading+test" '.'class="wiki_edit_section">[edit]</a></h3>'. "\n" . '<h4><a name="toc-2"></a>Subsection</h4>' . "\n";$toc = '<div class="wiki-toc"><p class="wiki-toc-title">Table of contents</p><p class="wiki-toc-section-1 '.'wiki-toc-section">1. <a href="#toc-1">Heading test <a href="edit.php?pageid=&section=Heading+'.'test" class="wiki_edit_section">[edit]</a></a></p><p class="wiki-toc-section-2 wiki-toc-section">'.'1.1. <a href="#toc-2">Subsection</a></p></div>';$section = wiki_parser_proxy::get_section($input, 'html', 'Heading test');$actual = wiki_parser_proxy::parse($input, 'html');$this->assertEquals($output, $actual['parsed_text']);$this->assertEquals($toc, $actual['toc']);$this->assertNotEquals(false, $section);}/*** Test that format that are not supported are raising an exception** @param string $format* @param string $expected* @covers \wiki_parser_proxy::parse* @dataProvider format_parser_provider*/public function test_format_parser(string $format, string $expected): void {$this->resetAfterTest();$this->setAdminUser();$generator = $this->getDataGenerator();$course = $generator->create_course();$wiki = $generator->create_module('wiki', array_merge(['course' => $course->id, 'defaultformat' => $format]));$wikigenerator = $this->getDataGenerator()->get_plugin_generator('mod_wiki');if ($expected === 'exception') {$this->expectException(\moodle_exception::class);}$page = $wikigenerator->create_page($wiki);$version = wiki_get_current_version($page->id);$this->assertEquals($expected, $version->contentformat);}/*** Data provider for test_format_parser** @return array[]*/public static function format_parser_provider(): array {return ['creole' => ['data' => 'creole','expected' => 'creole',],'html' => ['data' => 'html','expected' => 'html',],'wikimarkup' => ['data' => 'nwiki','expected' => 'nwiki',],'wrong format' => ['data' => '../wrongformat123','expected' => 'exception',],];}}