add update notification for failing reference file tests

Author: mringler

tests/Propel/Tests/CompareGeneratedCodeTestCase.php

@@ -9,6 +9,8 @@
  */
 class CompareGeneratedCodeTestCase extends TestCase
 {
+    public const HOW_TO_UPDATE_MESSAGE = 'Reference file does not match anymore. Update by calling `./tests/bin/rebuild-reference-files` (from Perpl root dir).';
+
     /**
      * Summary of generateCodeFileContent
      * @param mixed $obj

tests/Propel/Tests/Generator/Builder/Om/CodeBuilderTest.php

@@ -80,7 +80,7 @@ public function buildCode(string $tableName, BuilderType $builderType, array|nul
     public function testCodeBuilderOutput(array $builderArgs, string $fileName): void
     {
         $code = $this->buildCode(...$builderArgs);
-        $this->assertStringEqualsFile($fileName, $code);
+        $this->assertStringEqualsFile($fileName, $code, CompareGeneratedCodeTestCase::HOW_TO_UPDATE_MESSAGE);
     }
 
     /**

tests/Propel/Tests/Generator/Builder/Om/ObjectBuilder/ColumnTypes/ColumnCodeTest.php

@@ -78,7 +78,7 @@ public function buildObjectClassCode(string $columnXml, array|null $config, Plat
     public function testEnumeratedColumnObjectCode(array $builderArgs, string $fileName): void
     {
         $objectClassCode = $this->buildObjectClassCode(...$builderArgs);
-        $this->assertStringEqualsFile($fileName, $objectClassCode);
+        $this->assertStringEqualsFile($fileName, $objectClassCode, CompareGeneratedCodeTestCase::HOW_TO_UPDATE_MESSAGE);
     }
 
     /**
@@ -138,7 +138,7 @@ public function buildQueryClassCode(string $columnXml, array|null $config, Platf
     public function testEnumeratedColumnQueryCode(array $builderArgs, string $fileName): void
     {
         $queryClassCode = $this->buildQueryClassCode(...$builderArgs);
-        $this->assertStringEqualsFile($fileName, $queryClassCode);
+        $this->assertStringEqualsFile($fileName, $queryClassCode, CompareGeneratedCodeTestCase::HOW_TO_UPDATE_MESSAGE);
     }
 
     /**

tests/Propel/Tests/Generator/Builder/Om/ObjectBuilder/RelationCodeProducer/CrossRelationCodeProducerCodeTest.php

@@ -67,7 +67,7 @@ public function buildCodeForCrossRelation(string $schema): string
     public function testCrossRelationCode(string $schema, string $fileName): void
     {
         $code = $this->buildCodeForCrossRelation($schema);
-        $this->assertStringEqualsFile($fileName, $code);
+        $this->assertStringEqualsFile($fileName, $code, CompareGeneratedCodeTestCase::HOW_TO_UPDATE_MESSAGE);
     }
 
     /* 

tests/Propel/Tests/Generator/Builder/Om/ObjectBuilder/RelationCodeProducer/FkRelationCodeProducerCodeTest.php

@@ -65,7 +65,7 @@ public function buildCodeForRelation(string $schema): string
     public function testFkRelationCode(string $schema, string $fileName): void
     {
         $code = $this->buildCodeForRelation($schema);
-        $this->assertStringEqualsFile($fileName, $code);
+        $this->assertStringEqualsFile($fileName, $code, CompareGeneratedCodeTestCase::HOW_TO_UPDATE_MESSAGE);
     }
 
     /**

tests/Propel/Tests/Generator/Builder/Om/ObjectBuilder/RelationCodeProducer/IncomingRelationCodeProducerCodeTest.php

@@ -72,7 +72,7 @@ public function buildCodeForIncomingRelation(string $schema): string
     public function testIncomingRelationCode(string $schema, string $fileName): void
     {
         $code = $this->buildCodeForIncomingRelation($schema);
-        $this->assertStringEqualsFile($fileName, $code);
+        $this->assertStringEqualsFile($fileName, $code, CompareGeneratedCodeTestCase::HOW_TO_UPDATE_MESSAGE);
     }
 
     protected const MANY_TO_ONE_RELATION_CODE_SCHEMA = <<<EOF