-mix-into-source branches now also include TOC files (only for the specified flavor)

Author: Numynum

bin/annotate

@@ -32,7 +32,7 @@ require_once __DIR__ . '/../vendor/autoload.php';
     ->addOption('inputDir', 'i', InputOption::VALUE_REQUIRED, 'Directory containing the files to annotate', '.')
     ->addOption('linkPrefix', 'l', InputOption::VALUE_REQUIRED, 'Prefix for links in the output')
     ->addOption('mixAnnotationsIntoSource', 'm', InputOption::VALUE_NONE, 'Include all Lua source files, and add class annotations to the source files')
-    ->addOption('includeRawXmlSource', 'x', InputOption::VALUE_NONE, 'Include the raw XML source files in the output')
+    ->addOption('includeRawXmlSource', 'x', InputOption::VALUE_NONE, 'Include the raw XML and TOC source files in the output')
     ->setCode(function (InputInterface $input, ConsoleOutput $output) {
         $io = new SymfonyStyle($input, $output);
 
@@ -78,7 +78,7 @@ require_once __DIR__ . '/../vendor/autoload.php';
             foreach (array_keys($dirsWithToc) as $dirWithToc) {
                 $tocFile = $tocParser->findTocFile($dirWithToc);
                 if ($tocFile) {
-                    $fileList = array_merge($fileList, $tocParser->listFiles($tocFile));
+                    $fileList = array_merge($fileList, $tocParser->listFiles($tocFile), [$tocFile]);
                 }
             }
         }
@@ -112,6 +112,8 @@ require_once __DIR__ . '/../vendor/autoload.php';
                 }
             } elseif (str_ends_with($filePath, 'lua')) {
                 $luaFileParser->writeAnnotationsToFile($filePath, $outputDir, $inputDir);
+            } elseif (isset($tocParser) && $includeRawXmlSource && str_ends_with($filePath, 'toc')) {
+                $tocParser->writeRawTocToFile($filePath, $outputDir, $inputDir);
             }
             $progressBar->advance();
         }

src/TocFileParser.php

@@ -128,6 +128,20 @@ public function listFiles(string $tocFilePath): array
         return $files;
     }
 
+    public function writeRawTocToFile(string $filename, string $outDir, string $prefixToStrip): void
+    {
+        $targetFile = $filename;
+        if (str_starts_with($targetFile, $prefixToStrip)) {
+            $targetFile = substr($targetFile, strlen($prefixToStrip));
+        }
+        $targetFile = rtrim($outDir, '/') . '/' . ltrim($targetFile, '/');
+        if (!is_dir(dirname($targetFile))) {
+            mkdir($outDir . '/' . dirname($filename), recursive: true);
+        }
+
+        copy($filename, $targetFile);
+    }
+
     private function allowLoadGameType(string $gameTypes): bool
     {
         $gameTypesForFlavor = array_map(strtolower(...), $this->getGameTypesForFlavor($this->flavor));