wikimedia/mediawiki-extensions-Translate

<?php
declare( strict_types = 1 );

namespace MediaWiki\Extension\Translate\TtmServer;

use MediaWiki\Extension\Translate\MessageLoading\MessageHandle;
use MediaWiki\MediaWikiServices;
use WikiPage;

/**
 * TtmServer - The Translate extension translation memory interface
 * Some general static methods for instantiating TtmServer and helpers.
 * @author Niklas Laxström
 * @license GPL-2.0-or-later
 * @defgroup TtmServer The Translate extension translation memory interface
 * @ingroup TTMServerp
 */
abstract class TtmServer {
    protected array $config;

    public function __construct( array $config ) {
        $this->config = $config;
    }

    /**
     * @param array[] $suggestions
     * @return array[]
     */
    public static function sortSuggestions( array $suggestions ): array {
        usort( $suggestions, static function ( array $a, array $b ) {
            return $b['quality'] <=> $a['quality'];
        } );

        return $suggestions;
    }

    /** Hook: ArticleDeleteComplete */
    public static function onDelete( WikiPage $wikipage ): void {
        $handle = new MessageHandle( $wikipage->getTitle() );
        $job = TtmServerMessageUpdateJob::newJob( $handle, 'delete' );
        MediaWikiServices::getInstance()->getJobQueueGroup()->push( $job );
    }

    /** Called from TranslateEditAddons::onSave */
    public static function onChange( MessageHandle $handle ): void {
        $job = TtmServerMessageUpdateJob::newJob( $handle, 'refresh' );
        MediaWikiServices::getInstance()->getJobQueueGroup()->push( $job );
    }

    public static function onGroupChange( MessageHandle $handle, array $old ): void {
        if ( $old === [] ) {
            // Don't bother for newly added messages
            return;
        }

        $job = TtmServerMessageUpdateJob::newJob( $handle, 'rebuild' );
        MediaWikiServices::getInstance()->getJobQueueGroup()->push( $job );
    }
}