wiki.techinc.nl/tests/parser/ParserTestParserHook.php
C. Scott Ananian 398e86f7c7 Make private deprecated public properties of Parser
This prepares for a split of the parser class.  These properties were
deprecated for public use in 1.35.

Some adjustments to phan annotations were necessary, as phan seems to
have a stronger analysis of the Parser class after this patch.

Bug: T236810
Bug: T236812
Change-Id: I66ad07d004a081096edec641141e787fc2cc0958
2022-09-19 23:44:56 -04:00

76 lines
2.5 KiB
PHP

<?php
/**
* A basic extension that's used by the parser tests to test whether input and
* arguments are passed to extensions properly.
*
* Copyright © 2005, 2006 Ævar Arnfjörð Bjarmason
*
* This program 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 2 of the License, or
* (at your option) any later version.
*
* This program 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 this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
* http://www.gnu.org/copyleft/gpl.html
*
* @file
* @ingroup Testing
* @author Ævar Arnfjörð Bjarmason <avarab@gmail.com>
*/
class ParserTestParserHook {
public static function setup( Parser $parser ) {
$parser->setHook( 'tag', [ __CLASS__, 'dumpHook' ] );
$parser->setHook( 'tåg', [ __CLASS__, 'dumpHook' ] );
$parser->setHook( 'statictag', [ __CLASS__, 'staticTagHook' ] );
$parser->setHook( 'asidetag', [ __CLASS__, 'asideTagHook' ] );
return true;
}
public static function dumpHook( $in, $argv ) {
// @phan-suppress-next-line SecurityCheck-XSS
return "<pre>\n" .
var_export( $in, true ) . "\n" .
var_export( $argv, true ) . "\n" .
"</pre>";
}
/**
* @param string $in
* @param array $argv
* @param Parser $parser
* @return string
* @suppress PhanUndeclaredProperty static_tag_buf is deliberately dynamic
* @suppress SecurityCheck-XSS
*/
public static function staticTagHook( $in, $argv, $parser ) {
if ( !count( $argv ) ) {
$parser->static_tag_buf = $in;
return '';
} elseif ( count( $argv ) === 1 && isset( $argv['action'] )
&& $argv['action'] === 'flush' && $in === null
) {
// Clear the buffer, we probably don't need to
$tmp = $parser->static_tag_buf ?? '';
$parser->static_tag_buf = null;
return $tmp;
} else { // wtf?
return "\nCall this extension as <statictag>string</statictag> or as" .
" <statictag action=flush/>, not in any other way.\n" .
"text: " . var_export( $in, true ) . "\n" .
"argv: " . var_export( $argv, true ) . "\n";
}
}
public static function asideTagHook(): string {
return Html::element( 'aside', [], 'Some aside content' );
}
}