added more tests and comments

Author: eceltov

app/helpers/Mocks/MockHelper.php

@@ -2,6 +2,8 @@
 
 namespace App\Helpers\Mocks;
 
+use App\Helpers\MetaFormats\FormatCache;
+use App\Helpers\MetaFormats\MetaFormatHelper;
 use App\Helpers\Mocks\MockUserStorage;
 use App\V1Module\Presenters\BasePresenter;
 use Nette\Application\Application;
@@ -11,6 +13,7 @@
 use Nette\Http\UrlScript;
 use Nette\Security\User;
 use Nette;
+use ReflectionProperty;
 
 class MockHelper
 {
@@ -32,4 +35,30 @@ public static function initPresenter(BasePresenter $presenter)
 
         $presenter->injectPrimary($httpRequest, $httpResponse, user: $user, templateFactory: $factory);
     }
+
+    /**
+     * Injects a Format class to the FormatCache.
+     * This method must not be used outside of testing, normal Format classes are discovered automatically.
+     * @param string $format The Format class name.
+     */
+    public static function injectFormat(string $format)
+    {
+        // make sure the cache is initialized (it uses lazy loading)
+        FormatCache::getFormatToFieldDefinitionsMap();
+        FormatCache::getFormatNamesHashSet();
+
+        // inject the format name
+        $hashSetReflector = new ReflectionProperty(FormatCache::class, "formatNamesHashSet");
+        $hashSetReflector->setAccessible(true);
+        $formatNamesHashSet = $hashSetReflector->getValue();
+        $formatNamesHashSet[$format] = true;
+        $hashSetReflector->setValue(null, $formatNamesHashSet);
+
+        // inject the format definitions
+        $formatMapReflector = new ReflectionProperty(FormatCache::class, "formatToFieldFormatsMap");
+        $formatMapReflector->setAccessible(true);
+        $formatToFieldFormatsMap = $formatMapReflector->getValue();
+        $formatToFieldFormatsMap[$format] = MetaFormatHelper::createNameToFieldDefinitionsMap($format);
+        $formatMapReflector->setValue(null, $formatToFieldFormatsMap);
+    }
 }