LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest Class Reference

Covers the private static databaseRowsOfMigratedModule(): it folds the buffered per-form lng_data rows of a plural message into the single row the database must end up with (default form's value, first non-null remarks, local_change only if the merged value differs from the shipped default). More...

Inheritance diagram for LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest:

Collaboration diagram for LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest:

Public Member Functions
	testTwoFormRowsFoldIntoOneRowWithTheDefaultFormsValue ()
	Two buffered form rows fold into one row under the plain identifier, with the default form's (msgstr[1], count >= 2) value of the module's final content. More...
	testAPlainRowOfAnUnrelatedIdentifierIsKeptUnchanged ()
	A plain row of an identifier that is not a plural message of the shipped state (here the separately shipped "poll_population_singular", see pluralMessageOf()) is kept untouched. More...
	testRemarksParameterOverridesTheRowsOwnRemarkForAPlainIdentifier ()
	$remarks (from migratedModuleRemarks()) overrides the remark of the buffered rows, for plain identifiers and merged plural rows alike. More...
	testRemarksParameterOverridesTheMergedRemarkOfAPluralMessage ()
	testAnIdentifierNotInRemarksKeepsTheRowsOwnRemark ()
	An identifier not named in $remarks keeps the rows' own remark. More...
	testLocalChangeIsNullWhenTheMergedDefaultFormValueMatchesTheShippedOne ()
	local_change depends on the merged default-form VALUE differing from the shipped default, not on a stale local_change timestamp of some row. More...
	testTheFirstNonNullLocalChangeAndRemarksOfTheFormRowsAreKeptWhenTheValueActuallyChanged ()
	The first non-null local_change/remarks among the form rows wins once the merged value differs; a later null must not erase it. More...
	testAnEarlierNonNullLocalChangeSurvivesALaterRowsNullOnesWhenTheValueActuallyChanged ()
	Same, with the local_change-carrying row processed first. More...
	testFormRowsWithNoValueInTheFinalContentAreDroppedEntirely ()
	A form row whose message has no value in the final content is dropped instead of written with a bogus value. More...
	testASingleFormLanguageStillFoldsIntoOneRow ()
	A single-form language (nplurals=1) still folds into one row keyed by its identifier. More...

Private Member Functions
	call (array $rows, array $final_entries, array $shipped_entries, array $remarks=[])

Private Attributes
const	SHIPPED

Detailed Description

Covers the private static databaseRowsOfMigratedModule(): it folds the buffered per-form lng_data rows of a plural message into the single row the database must end up with (default form's value, first non-null remarks, local_change only if the merged value differs from the shipped default).

Definition at line 29 of file LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest.php.

Member Function Documentation

call()

LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest::call ( array  $rows, array  $final_entries, array  $shipped_entries, array  $remarks = []  )

private

Parameters

array<string,array{0	string, 1: ?string, 2: ?string}> $rows
array<string,string>	$final_entries
array<string,string>	$shipped_entries
array<string,string>	$remarks identifier => remark (see migratedModuleRemarks()), written into the row instead of the buffered rows' own remark

Returns

array<string, array{0: string, 1: ?string, 2: ?string}>

Definition at line 41 of file LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest.php.

                                                                                                         : array
    {
        $method = (new ReflectionClass(LanguageInstallationManager::class))->getMethod('databaseRowsOfMigratedModule');
 
        return $method->invoke(null, $rows, $final_entries, $shipped_entries, $remarks);
    }

References ILIAS\Scripts\PHPStan\$rows.

Referenced by testAnEarlierNonNullLocalChangeSurvivesALaterRowsNullOnesWhenTheValueActuallyChanged(), testAnIdentifierNotInRemarksKeepsTheRowsOwnRemark(), testAPlainRowOfAnUnrelatedIdentifierIsKeptUnchanged(), testASingleFormLanguageStillFoldsIntoOneRow(), testFormRowsWithNoValueInTheFinalContentAreDroppedEntirely(), testLocalChangeIsNullWhenTheMergedDefaultFormValueMatchesTheShippedOne(), testRemarksParameterOverridesTheMergedRemarkOfAPluralMessage(), testRemarksParameterOverridesTheRowsOwnRemarkForAPlainIdentifier(), testTheFirstNonNullLocalChangeAndRemarksOfTheFormRowsAreKeptWhenTheValueActuallyChanged(), and testTwoFormRowsFoldIntoOneRowWithTheDefaultFormsValue().

Here is the caller graph for this function:

testAnEarlierNonNullLocalChangeSurvivesALaterRowsNullOnesWhenTheValueActuallyChanged()

LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest::testAnEarlierNonNullLocalChangeSurvivesALaterRowsNullOnesWhenTheValueActuallyChanged

(

)

Same, with the local_change-carrying row processed first.

Definition at line 181 of file LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest.php.

                                                                                                          : void
    {
        $rows = [
            'poll_population [1]' => ['%s NEUE Stimmabgaben', '2024-01-01 00:00:00', 'lokal geändert'],
            'poll_population [0]' => ['Eine Stimmabgabe', null, null],
        ];
        $final_entries = ['poll_population [0]' => 'Eine Stimmabgabe', 'poll_population [1]' => '%s NEUE Stimmabgaben'];
 
        $result = $this->call($rows, $final_entries, self::SHIPPED);
 
        $this->assertSame(
            ['poll_population' => ['%s NEUE Stimmabgaben', '2024-01-01 00:00:00', 'lokal geändert']],
            $result
        );
    }

References ILIAS\Scripts\PHPStan\$rows, and call().

Here is the call graph for this function:

testAnIdentifierNotInRemarksKeepsTheRowsOwnRemark()

LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest::testAnIdentifierNotInRemarksKeepsTheRowsOwnRemark

(

)

An identifier not named in $remarks keeps the rows' own remark.

Definition at line 127 of file LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest.php.

                                                                       : void
    {
        $rows = ['poll_population_singular' => ['Eine Stimmabgabe', null, 'Eigene Anmerkung']];
 
        $result = $this->call($rows, ['poll_population_singular' => 'Eine Stimmabgabe'], self::SHIPPED, []);
 
        $this->assertSame('Eigene Anmerkung', $result['poll_population_singular'][2]);
    }

References ILIAS\Scripts\PHPStan\$rows, and call().

Here is the call graph for this function:

testAPlainRowOfAnUnrelatedIdentifierIsKeptUnchanged()

LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest::testAPlainRowOfAnUnrelatedIdentifierIsKeptUnchanged

(

)

A plain row of an identifier that is not a plural message of the shipped state (here the separately shipped "poll_population_singular", see pluralMessageOf()) is kept untouched.

Definition at line 78 of file LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest.php.

                                                                         : void
    {
        $rows = ['poll_population_singular' => ['Eine Stimmabgabe', '2024-01-01 00:00:00', 'Anmerkung']];
 
        $result = $this->call($rows, ['poll_population_singular' => 'Eine Stimmabgabe'], self::SHIPPED);
 
        $this->assertSame(
            ['poll_population_singular' => ['Eine Stimmabgabe', '2024-01-01 00:00:00', 'Anmerkung']],
            $result
        );
    }

References ILIAS\Scripts\PHPStan\$rows, and call().

Here is the call graph for this function:

testASingleFormLanguageStillFoldsIntoOneRow()

LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest::testASingleFormLanguageStillFoldsIntoOneRow

(

)

A single-form language (nplurals=1) still folds into one row keyed by its identifier.

Definition at line 219 of file LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest.php.

                                                                 : void
    {
        $shipped = ['poll_population [0]' => 'ある投票'];
        $rows = ['poll_population [0]' => ['ある投票NEU', null, null]];
        $final_entries = ['poll_population [0]' => 'ある投票NEU'];
 
        $result = $this->call($rows, $final_entries, $shipped);
 
        $this->assertSame(['poll_population' => ['ある投票NEU', null, null]], $result);
    }

References ILIAS\Scripts\PHPStan\$rows, and call().

Here is the call graph for this function:

testFormRowsWithNoValueInTheFinalContentAreDroppedEntirely()

LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest::testFormRowsWithNoValueInTheFinalContentAreDroppedEntirely

(

)

A form row whose message has no value in the final content is dropped instead of written with a bogus value.

Definition at line 200 of file LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest.php.

                                                                                : void
    {
        $rows = [
            'poll_population [0]' => ['Eine Stimmabgabe', null, null],
            'poll_population [1]' => ['%s Stimmabgaben', null, null],
            'poll_population_singular' => ['Eine Stimmabgabe', null, null],
        ];
        // final content no longer mentions "poll_population" at all
        $final_entries = ['poll_population_singular' => 'Eine Stimmabgabe'];
 
        $result = $this->call($rows, $final_entries, self::SHIPPED);
 
        $this->assertArrayNotHasKey('poll_population', $result);
        $this->assertSame(['poll_population_singular' => ['Eine Stimmabgabe', null, null]], $result);
    }

References ILIAS\Scripts\PHPStan\$rows, and call().

Here is the call graph for this function:

testLocalChangeIsNullWhenTheMergedDefaultFormValueMatchesTheShippedOne()

LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest::testLocalChangeIsNullWhenTheMergedDefaultFormValueMatchesTheShippedOne

(

)

local_change depends on the merged default-form VALUE differing from the shipped default, not on a stale local_change timestamp of some row.

Remarks are independent of that: the first non-null one wins, here from the second row.

Definition at line 141 of file LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest.php.

                                                                                            : void
    {
        $rows = [
            'poll_population [0]' => ['Eine Stimmabgabe', null, null],
            'poll_population [1]' => ['%s Stimmabgaben', '2024-01-01 00:00:00', 'lokal geändert'],
        ];
        // identical to self::SHIPPED - the message did not actually change
        $final_entries = ['poll_population [0]' => 'Eine Stimmabgabe', 'poll_population [1]' => '%s Stimmabgaben'];
 
        $result = $this->call($rows, $final_entries, self::SHIPPED);
 
        $this->assertSame(
            ['poll_population' => ['%s Stimmabgaben', null, 'lokal geändert']],
            $result
        );
    }

References ILIAS\Scripts\PHPStan\$rows, and call().

Here is the call graph for this function:

testRemarksParameterOverridesTheMergedRemarkOfAPluralMessage()

LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest::testRemarksParameterOverridesTheMergedRemarkOfAPluralMessage

(

)

Definition at line 111 of file LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest.php.

                                                                                  : void
    {
        $rows = [
            'poll_population [0]' => ['Eine Stimmabgabe', null, null],
            'poll_population [1]' => ['%s Stimmabgaben', null, 'Alte Anmerkung'],
        ];
        $final_entries = ['poll_population [0]' => 'Eine Stimmabgabe', 'poll_population [1]' => '%s Stimmabgaben'];
 
        $result = $this->call($rows, $final_entries, self::SHIPPED, ['poll_population' => 'Neue Anmerkung']);
 
        $this->assertSame('Neue Anmerkung', $result['poll_population'][2]);
    }

References ILIAS\Scripts\PHPStan\$rows, and call().

Here is the call graph for this function:

testRemarksParameterOverridesTheRowsOwnRemarkForAPlainIdentifier()

LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest::testRemarksParameterOverridesTheRowsOwnRemarkForAPlainIdentifier

(

)

$remarks (from migratedModuleRemarks()) overrides the remark of the buffered rows, for plain identifiers and merged plural rows alike.

Definition at line 94 of file LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest.php.

                                                                                      : void
    {
        $rows = ['poll_population_singular' => ['Eine Stimmabgabe', '2024-01-01 00:00:00', 'Alte Anmerkung']];
 
        $result = $this->call(
            $rows,
            ['poll_population_singular' => 'Eine Stimmabgabe'],
            self::SHIPPED,
            ['poll_population_singular' => 'Neue Anmerkung']
        );
 
        $this->assertSame(
            ['poll_population_singular' => ['Eine Stimmabgabe', '2024-01-01 00:00:00', 'Neue Anmerkung']],
            $result
        );
    }

References ILIAS\Scripts\PHPStan\$rows, and call().

Here is the call graph for this function:

testTheFirstNonNullLocalChangeAndRemarksOfTheFormRowsAreKeptWhenTheValueActuallyChanged()

LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest::testTheFirstNonNullLocalChangeAndRemarksOfTheFormRowsAreKeptWhenTheValueActuallyChanged

(

)

The first non-null local_change/remarks among the form rows wins once the merged value differs; a later null must not erase it.

Definition at line 162 of file LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest.php.

                                                                                                             : void
    {
        $rows = [
            'poll_population [0]' => ['Eine Stimmabgabe', null, null],
            'poll_population [1]' => ['%s NEUE Stimmabgaben', '2024-01-01 00:00:00', 'lokal geändert'],
        ];
        $final_entries = ['poll_population [0]' => 'Eine Stimmabgabe', 'poll_population [1]' => '%s NEUE Stimmabgaben'];
 
        $result = $this->call($rows, $final_entries, self::SHIPPED);
 
        $this->assertSame(
            ['poll_population' => ['%s NEUE Stimmabgaben', '2024-01-01 00:00:00', 'lokal geändert']],
            $result
        );
    }

References ILIAS\Scripts\PHPStan\$rows, and call().

Here is the call graph for this function:

testTwoFormRowsFoldIntoOneRowWithTheDefaultFormsValue()

LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest::testTwoFormRowsFoldIntoOneRowWithTheDefaultFormsValue

(

)

Two buffered form rows fold into one row under the plain identifier, with the default form's (msgstr[1], count >= 2) value of the module's final content.

Definition at line 58 of file LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest.php.

                                                                           : void
    {
        $rows = [
            'poll_population [0]' => ['Eine Stimmabgabe', null, null],
            'poll_population [1]' => ['%s NEUE Stimmabgaben', null, null],
        ];
        $final_entries = [
            'poll_population [0]' => 'Eine Stimmabgabe',
            'poll_population [1]' => '%s NEUE Stimmabgaben',
        ];
 
        $result = $this->call($rows, $final_entries, self::SHIPPED);
 
        $this->assertSame(['poll_population' => ['%s NEUE Stimmabgaben', null, null]], $result);
    }

References ILIAS\Scripts\PHPStan\$rows, and call().

Here is the call graph for this function:

Field Documentation

SHIPPED

const LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest::SHIPPED

private

Initial value:

= [
        'poll_population [0]' => 'Eine Stimmabgabe',
        'poll_population [1]' => '%s Stimmabgaben',
        'poll_population_singular' => 'Eine Stimmabgabe',
    ]

Definition at line 48 of file LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest.php.

---

The documentation for this class was generated from the following file:

• components/ILIAS/Language/tests/Setup/LanguageInstallationManagerDatabaseRowsOfMigratedModuleTest.php