add an option to disable cache

Author: nikophil

src/BuildContext.php

@@ -15,6 +15,7 @@ class BuildContext
     private $htmlOutputDir;
     private $jsonOutputDir;
     private $parseSubPath;
+    private $disableCache = false;
 
     public function __construct(
         string $basePath,
@@ -30,12 +31,13 @@ public function __construct(
         $this->symfonyDocUrl  = $symfonyDocUrl;
     }
 
-    public function initializeRuntimeConfig(string $sourceDir, string $htmlOutputDir, ?string $jsonOutputDir = null, ?string $parseSubPath = null)
+    public function initializeRuntimeConfig(string $sourceDir, string $htmlOutputDir, ?string $jsonOutputDir = null, ?string $parseSubPath = null, ?bool $disableCache = false)
     {
         $this->sourceDir          = $sourceDir;
         $this->htmlOutputDir      = $htmlOutputDir;
         $this->jsonOutputDir      = $jsonOutputDir;
         $this->parseSubPath       = $parseSubPath;
+        $this->disableCache       = $disableCache;
         $this->runtimeInitialized = true;
     }
 
@@ -92,6 +94,13 @@ public function getParseSubPath(): ?string
         return $this->parseSubPath;
     }
 
+    public function getDisableCache(): bool
+    {
+        $this->checkThatRuntimeConfigIsInitialized();
+
+        return $this->disableCache;
+    }
+
     private function checkThatRuntimeConfigIsInitialized()
     {
         if (false === $this->runtimeInitialized) {

src/Command/BuildDocsCommand.php

@@ -49,6 +49,12 @@ protected function configure()
                 InputOption::VALUE_OPTIONAL,
                 'Parse only given sub directory and combine it into a single file (directory relative from source-dir)',
                 ''
+            )
+            ->addOption(
+                'disable-cache',
+                null,
+                InputOption::VALUE_NONE,
+                'If provided, caching meta will be disabled'
             );
     }
 

src/Command/CommandInitializerTrait.php

@@ -46,7 +46,8 @@ private function doInitialize(InputInterface $input, OutputInterface $output, st
             $sourceDir,
             $this->initializeHtmlOutputDir($this->filesystem, $outputDir),
             $this->initializeJsonOutputDir($outputDir),
-            $this->initializeParseSubPath($input, $sourceDir)
+            $this->initializeParseSubPath($input, $sourceDir),
+            (bool) $input->getOption('disable-cache')
         );
 
         $this->builder = new Builder(

src/KernelFactory.php

@@ -19,6 +19,10 @@ public static function createKernel(BuildContext $buildContext, ?UrlChecker $url
         $configuration->setCustomTemplateDirs([sprintf('%s/src/Templates', $buildContext->getBasePath())]);
         $configuration->setCacheDir(sprintf('%s/var/cache', $buildContext->getBasePath()));
 
+        if ($buildContext->getDisableCache()) {
+            $configuration->setUseCachedMetas(false);
+        }
+
         $configuration->addFormat(
             new SymfonyHTMLFormat(
                 $configuration->getTemplateRenderer(),