ReleaseNotesTest.php

Go to the documentation of this file.

<?php
 
class ReleaseNotesTest extends MediaWikiTestCase {
    public function testReleaseNotesFilesExistAndAreNotMalformed() {
        global $wgVersion, $IP;
 
        $notesFiles = glob( "$IP/RELEASE-NOTES-*" );
 
        $this->assertGreaterThanOrEqual(
            1,
            count( $notesFiles ),
            'Repo has at least one Release Notes file.'
        );
 
        $versionParts = explode( '.', explode( '-', $wgVersion )[0] );
        $this->assertContains(
            "$IP/RELEASE-NOTES-$versionParts[0].$versionParts[1]",
            $notesFiles,
            'Repo has a Release Notes file for the current $wgVersion.'
        );
 
        foreach ( $notesFiles as $index => $fileName ) {
            $this->assertFileLength( "Release Notes", $fileName );
        }
 
        // Also test the README and similar files
        $otherFiles = [ "$IP/COPYING", "$IP/FAQ", "$IP/INSTALL", "$IP/README", "$IP/SECURITY" ];
 
        foreach ( $otherFiles as $index => $fileName ) {
            $this->assertFileLength( "Help", $fileName );
        }
    }
 
    private function assertFileLength( $type, $fileName ) {
        $file = file( $fileName, FILE_IGNORE_NEW_LINES );
 
        $this->assertFalse(
            !$file,
            "$type file '$fileName' is inaccessible."
        );
 
        $lines = count( $file );
 
        for ( $i = 0; $i < $lines; $i++ ) {
            $line = $file[$i];
 
            $this->assertLessThanOrEqual(
                // FILE_IGNORE_NEW_LINES drops the \n at the EOL, so max length is 80 not 81.
                80,
                mb_strlen( $line ),
                "$type file '$fileName' line $i is longer than 80 chars:\n\t'$line'"
            );
        }
    }
}