parse.php

Go to the documentation of this file.

<?php
 
use MediaWiki\Maintenance\Maintenance;
use MediaWiki\Parser\Parser;
use MediaWiki\Parser\ParserOptions;
use MediaWiki\Parser\Parsoid\ParsoidParser;
use MediaWiki\Title\Title;
use Wikimedia\Parsoid\Utils\ContentUtils;
 
// @codeCoverageIgnoreStart
require_once __DIR__ . '/Maintenance.php';
// @codeCoverageIgnoreEnd
 
class CLIParser extends Maintenance {
    protected $parser;
 
    public function __construct() {
        parent::__construct();
        $this->addDescription( 'Parse a given wikitext' );
        $this->addOption(
            'title',
            'Title name for the given wikitext (Default: \'CLIParser\')',
            false,
            true
        );
        $this->addArg( 'file', 'File containing wikitext (Default: stdin)', false );
        $this->addOption( 'parsoid', 'Whether to use Parsoid', false, false, 'p' );
        $this->addOption( 'show-rich-attributes', 'Show rich attributes', false );
    }
 
    public function execute() {
        $this->initParser();
        print $this->render( $this->Wikitext() );
    }
 
    public function render( $wikitext ) {
        $options = ParserOptions::newFromAnon();
        $options->setOption( 'enableLimitReport', false );
        $po = $this->parser->parse(
            $wikitext,
            $this->getTitle(),
            $options
        );
        // TODO T371008 consider if using the Content framework makes sense instead of creating the pipeline
        $pipeline = $this->getServiceContainer()->getDefaultOutputPipeline();
        $po = $pipeline->run( $po, $options, [ 'wrapperDivClass' => '' ] );
        if ( $this->getOption( 'show-rich-attributes' ) ) {
            $df = $po->getContentHolder()->getAsDom();
            $df ??= $po->getContentHolder()->createFragment();
            return ContentUtils::dumpDOM( $df, '', [ 'quiet' => true ] );
        }
        return $po->getContentHolderText();
    }
 
    protected function Wikitext() {
        $php_stdin = 'php://stdin';
        $input_file = $this->getArg( 0, $php_stdin );
 
        if ( $input_file === $php_stdin && !$this->mQuiet ) {
            $ctrl = wfIsWindows() ? 'CTRL+Z' : 'CTRL+D';
            $this->error( basename( __FILE__ )
                . ": warning: reading wikitext from STDIN. Press $ctrl to parse.\n" );
        }
 
        return file_get_contents( $input_file );
    }
 
    protected function initParser() {
        $services = $this->getServiceContainer();
        if ( $this->hasOption( 'parsoid' ) ) {
            $this->parser = $services->getParsoidParserFactory()->create();
        } else {
            $this->parser = $services->getParserFactory()->create();
        }
    }
 
    protected function getTitle() {
        $title = $this->getOption( 'title' ) ?: 'CLIParser';
 
        return Title::newFromText( $title );
    }
}
 
// @codeCoverageIgnoreStart
$maintClass = CLIParser::class;
require_once RUN_MAINTENANCE_IF_MAIN;
// @codeCoverageIgnoreEnd