PageToGitHub.php

<?php
/**
 * 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.
 *
 * @file
 */

use MediaWiki\MediaWikiServices;

class PageToGitHubHooks
{
    /**
     * Occurs after an article has been updated.
     *
     * @param WikiPage $wikiPage
	 * @param MediaWiki\User\UserIdentity $user
	 * @param string $summary
	 * @param int $flags
	 * @param MediaWiki\Revision\RevisionRecord $revisionRecord
	 * @param MediaWiki\Storage\EditResult $editResult
     * 
	 * @return bool|void
     *
     * @see https://www.mediawiki.org/wiki/Manual:Hooks/PageSaveComplete
     */
    public static function onPageSaveComplete( WikiPage $wikiPage, MediaWiki\User\UserIdentity $user, string $summary, int $flags, MediaWiki\Revision\RevisionRecord $revisionRecord, MediaWiki\Storage\EditResult $editResult )
    {
        $config = MediaWikiServices::getInstance()->getConfigFactory()->makeConfig('PageToGitHub');

        $P2GNameSpace = $config->get('P2GNameSpace');
        $P2GKeyword = $config->get('P2GKeyword');
        $P2GIgnoreMinor = (bool) $config->get('P2GIgnoreMinor');

        wfDebugLog('PageToGitHub', '[PageToGitHub]||| Entered |||');
        $pageNameSpace = $wikiPage->getTitle()->getNsText();
        $pageTitle = $wikiPage->getTitle()->getRootText();
        $pageContent = $wikiPage->getContent()->getNativeData();
        $isMinor = (bool) $wikiPage->getMinorEdit();

        wfDebugLog('PageToGitHub', '[PageToGitHub]Summary: '.$summary);
        wfDebugLog('PageToGitHub', '[PageToGitHub]Keyword: '.$P2GKeyword);
        wfDebugLog('PageToGitHub', '[PageToGitHub]Is minor: '.$isMinor);

        if ($P2GIgnoreMinor and $isMinor) {
            wfDebugLog('PageToGitHub', '[PageToGitHub]IGNORING Minor');
        } else {
            wfDebugLog('PageToGitHub', '[PageToGitHub]NOT ignoring Minor');
            if ($pageNameSpace == $P2GNameSpace) {
                wfDebugLog('PageToGitHub', '[PageToGitHub]Namespace OK');
                /*wfDebugLog('PageToGitHub', '[PageToGitHub]Keyword count: ' . count($P2GKeyword));*/
                wfDebugLog('PageToGitHub', '[PageToGitHub]Keyword: '.$P2GKeyword[0]);
                if ($P2GKeyword[0] == null or $P2GKeyword == '' or (strpos($pageContent, $P2GKeyword) > -1)) {
                    wfDebugLog('PageToGitHub', '[PageToGitHub]Keyword OK');
                    $return = self::WriteToGithub($pageTitle, $pageContent, $summary, $config);
                    wfDebugLog('PageToGitHub', '[PageToGitHub]Returned: ' . $return);
                } else {
                    wfDebugLog('PageToGitHub', '[PageToGitHub]Keyword KO');
                }
            } else {
                wfDebugLog('PageToGitHub', '[PageToGitHub]Namespace KO');
            }
        }

        return true;
    }

    public static function WriteToGithub($pageName, $pageContent, $description, $extConfig)
    {
        try {
            wfDebugLog('PageToGitHub', '[PageToGitHub]Function WriteToGithub');

            $P2GAuthToken = $extConfig->get('P2GAuthToken');
            $P2GOwner = $extConfig->get('P2GOwner');
            $P2GRepo = $extConfig->get('P2GRepo');
            $P2GNameSpace = $extConfig->get('P2GNameSpace');

            $P2GKeyword = $extConfig->get('P2GKeyword');
            $P2GAddKeyword = $extConfig->get('P2GAddKeyword');

            wfDebugLog('PageToGitHub', '[PageToGitHub]Token: '.$P2GAuthToken);

            $client = new \Github\Client();
            wfDebugLog('PageToGitHub', '[PageToGitHub]Init done');

            // https://github.com/KnpLabs/php-github-api/blob/master/doc/security.md
            $client->authenticate($P2GAuthToken, '', \Github\AuthMethod::ACCESS_TOKEN);

            if ($P2GKeyword[0] != null and $P2GKeyword != '' and $P2GAddKeyword == true) {
                wfDebugLog('PageToGitHub', '[PageToGitHub]Keyword OK and Add OK');
                $pageName = $P2GKeyword . "-" . $pageName;
            } else {
                wfDebugLog('PageToGitHub', '[PageToGitHub]No Keyword');
            }

            $fileParamArray = [$P2GOwner, $P2GRepo, $pageName.'.lua'];
            $fileContent = '-- [P2G] Auto upload by PageToGitHub on '.date('c').PHP_EOL.'-- [P2G] This code from page '.$P2GNameSpace.':'.$pageName.PHP_EOL.$pageContent;
            if ($description == null) {
                $commitText = 'Auto commit by PageToGitHub'.date('Y-m-d');
            } else {
                $commitText = $description;
            }

            // https://github.com/KnpLabs/php-github-api/blob/master/doc/repo/cohttps://www.php.net/manual/en/function.get-class.phpntents.md
            $fileExists = $client->api('repo')->contents()->exists(...$fileParamArray);

            wfDebugLog('PageToGitHub', '[PageToGitHub]Message -auto-upload-: '.wfMessage('auto-upload')->parse());
            if ($fileExists == true) {
                wfDebugLog('PageToGitHub', '[PageToGitHub]Exist');
            
                $oldFile = $client->api('repo')->contents()->show(...$fileParamArray);
                wfDebugLog('PageToGitHub', '[PageToGitHub]File retrieved. SHA: '.$oldFile['sha']);
                $fileInfo = $client->api('repo')->contents()->update($P2GOwner, $P2GRepo, $pageName.'.lua', $fileContent, $commitText, $oldFile['sha']);
                wfDebugLog('PageToGitHub', '[PageToGitHub]File updated: '.$fileInfo['url']);
            } else {
                wfDebugLog('PageToGitHub', '[PageToGitHub]Does NOT exist');
                $fileInfo = $client->api('repo')->contents()->create($P2GOwner, $P2GRepo, $pageName.'.lua', $fileContent, $commitText);
                wfDebugLog('PageToGitHub', '[PageToGitHub]File created');
            }
        } catch (\Throwable $e) {
            wfDebugLog('PageToGitHub', '[PageToGitHub]Error '.$e->getMessage());

            return false;
        } finally {
            //return ("Returned from FINALLY");
        }

        return true;
    }
}