Allow setting a default highlighting language

Author: wouterj

packages/guides-restructured-text/resources/config/guides-restructured-text.php

@@ -53,6 +53,7 @@
 use phpDocumentor\Guides\RestructuredText\Directives\WarningDirective;
 use phpDocumentor\Guides\RestructuredText\Directives\WrapDirective;
 use phpDocumentor\Guides\RestructuredText\MarkupLanguageParser;
+use phpDocumentor\Guides\RestructuredText\Parser\DocumentParserContextFactory;
 use phpDocumentor\Guides\RestructuredText\Parser\InlineParser;
 use phpDocumentor\Guides\RestructuredText\Parser\Productions\AnnotationRule;
 use phpDocumentor\Guides\RestructuredText\Parser\Productions\BlockQuoteRule;
@@ -319,6 +320,8 @@
         ->set(SectionRule::class)
         ->tag('phpdoc.guides.parser.rst.structural_element', ['priority' => SectionRule::PRIORITY])
 
+        ->set(DocumentParserContextFactory::class)
+
         ->set(MarkupLanguageParser::class)
         ->args([
             '$startingRule' => service(DocumentRule::class),

packages/guides-restructured-text/src/RestructuredText/MarkupLanguageParser.php

@@ -10,8 +10,8 @@
 use phpDocumentor\Guides\ParserContext;
 use phpDocumentor\Guides\RestructuredText\Parser\BlockContext;
 use phpDocumentor\Guides\RestructuredText\Parser\DocumentParserContext;
+use phpDocumentor\Guides\RestructuredText\Parser\DocumentParserContextFactory;
 use phpDocumentor\Guides\RestructuredText\Parser\Productions\Rule;
-use phpDocumentor\Guides\RestructuredText\TextRoles\TextRoleFactory;
 use RuntimeException;
 use Webmozart\Assert\Assert;
 
@@ -28,7 +28,7 @@ class MarkupLanguageParser implements ParserInterface
     /** @param Rule<DocumentNode> $startingRule */
     public function __construct(
         private readonly Rule $startingRule,
-        private readonly TextRoleFactory $textRoleFactory,
+        private readonly DocumentParserContextFactory $documentParserContextFactory,
     ) {
     }
 
@@ -42,7 +42,7 @@ public function getSubParser(): MarkupLanguageParser
     {
         return new MarkupLanguageParser(
             $this->startingRule,
-            $this->textRoleFactory,
+            $this->documentParserContextFactory,
         );
     }
 
@@ -75,11 +75,7 @@ public function parse(ParserContext $parserContext, string $contents): DocumentN
     {
         $this->parserContext = $parserContext;
 
-        $this->documentParser = new DocumentParserContext(
-            $parserContext,
-            $this->textRoleFactory,
-            $this,
-        );
+        $this->documentParser = $this->documentParserContextFactory->create($this);
 
         $blockContext = new BlockContext($this->documentParser, $contents);
         if ($this->startingRule->applies($blockContext)) {

packages/guides-restructured-text/src/RestructuredText/Parser/DocumentParserContextFactory.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace phpDocumentor\Guides\RestructuredText\Parser;
+
+use phpDocumentor\Guides\RestructuredText\MarkupLanguageParser;
+use phpDocumentor\Guides\RestructuredText\TextRoles\TextRoleFactory;
+use phpDocumentor\Guides\Settings\SettingsManager;
+
+class DocumentParserContextFactory
+{
+    public function __construct(
+        private readonly TextRoleFactory $textRoleFactory,
+        private readonly SettingsManager $settingsManager,
+    ) {
+    }
+
+    public function create(MarkupLanguageParser $markupLanguageParser): DocumentParserContext
+    {
+        $documentParser = new DocumentParserContext(
+            $markupLanguageParser->getParserContext(),
+            $this->textRoleFactory,
+            $markupLanguageParser,
+        );
+
+        $documentParser->setCodeBlockDefaultLanguage($this->settingsManager->getProjectSettings()->getDefaultCodeLanguage());
+
+        return $documentParser;
+    }
+}

packages/guides/src/DependencyInjection/GuidesExtension.php

@@ -74,6 +74,7 @@ public function getConfigTreeBuilder(): TreeBuilder
                     ->defaultValue([])
                     ->scalarPrototype()->end()
                 ->end()
+                ->scalarNode('default_code_language')->defaultValue('')->end()
                 ->arrayNode('themes')
                     ->defaultValue([])
                     ->arrayPrototype()
@@ -159,6 +160,10 @@ public function load(array $configs, ContainerBuilder $container): void
             $projectSettings->setFailOnError((bool) $config['show_progress']);
         }
 
+        if (isset($config['default_code_language'])) {
+            $projectSettings->setDefaultCodeLanguage((string) $config['default_code_language']);
+        }
+
         $container->getDefinition(SettingsManager::class)
             ->addMethodCall('setProjectSettings', [$projectSettings]);
 

packages/guides/src/Settings/ProjectSettings.php

@@ -20,6 +20,7 @@ class ProjectSettings
     private string $logPath = 'php://stder';
     private bool $failOnError = false;
     private bool $showProgressBar = true;
+    private string $defaultCodeLanguage = '';
 
     public function getTitle(): string
     {
@@ -135,6 +136,16 @@ public function setOutputFormats(array $outputFormats): void
         $this->outputFormats = $outputFormats;
     }
 
+    public function setDefaultCodeLanguage(string $defaultCodeLanguage): void
+    {
+        $this->defaultCodeLanguage = $defaultCodeLanguage;
+    }
+
+    public function getDefaultCodeLanguage(): string
+    {
+        return $this->defaultCodeLanguage;
+    }
+
     public function getInputFile(): string
     {
         return $this->inputFile;

packages/guides/src/Settings/SettingsManager.php

@@ -6,11 +6,9 @@
 
 class SettingsManager
 {
-    private ProjectSettings $projectSettings;
-
-    public function __construct(ProjectSettings|null $projectSettings = null)
-    {
-        $this->projectSettings = $projectSettings ?? new ProjectSettings();
+    public function __construct(
+        private ProjectSettings $projectSettings = new ProjectSettings(),
+    ) {
     }
 
     public function getProjectSettings(): ProjectSettings