Merge pull request #628 from phpDocumentor/fix/anoymous_link_processing

[FIX]: be more strict on anonymous links

Author: jaapio

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

@@ -21,6 +21,9 @@
 use RuntimeException;
 
 use function array_merge;
+use function array_shift;
+use function strtolower;
+use function trim;
 
 /**
  * Our document parser contains
@@ -42,6 +45,12 @@ class DocumentParserContext
     /** @var string[] */
     private array $titleLetters = [];
 
+    /** @var array<string, string> */
+    private array $links = [];
+
+    /** @var string[] */
+    private array $anonymous = [];
+
     public function __construct(
         private readonly ParserContext $context,
         TextRoleFactory $textRoleFactory,
@@ -110,6 +119,33 @@ public function setCodeBlockDefaultLanguage(string $codeBlockDefaultLanguage): v
         $this->codeBlockDefaultLanguage = $codeBlockDefaultLanguage;
     }
 
+    public function setLink(string $name, string $url): void
+    {
+        $name = strtolower(trim($name));
+
+        if ($name === '_') {
+            $name = array_shift($this->anonymous);
+        }
+
+        $this->links[$name] = trim($url);
+    }
+
+    public function resetAnonymousStack(): void
+    {
+        $this->anonymous = [];
+    }
+
+    public function pushAnonymous(string $name): void
+    {
+        $this->anonymous[] = strtolower(trim($name));
+    }
+
+    /** @return array<string, string> */
+    public function getLinks(): array
+    {
+        return $this->links;
+    }
+
     /** @return array<string, string> */
     public function getLoggerInformation(): array
     {

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

@@ -57,8 +57,8 @@ protected function getCatchablePatterns(): array
             '\\\\``', // must be a separate case, as the next pattern would split in "\`" + "`", causing it to become a intepreted text
             '\\\\[\s\S]', // Escaping hell... needs escaped slash in regex, but also in php.
             '[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}',
-            '[a-z0-9-]+_{2}', //Inline href.
-            '[a-z0-9-]+_{1}(?=[\s\.+]|$)', //Inline href.
+            '(?<=^|\s)[a-z0-9-]+_{2}', //Inline href.
+            '(?<=^|\s)[a-z0-9-]+_{1}(?=[\s\.+]|$)', //Inline href.
             '``.+?``(?!`)',
             '_{2}',
             '_',

packages/guides-restructured-text/src/RestructuredText/Parser/Productions/DocumentRule.php

@@ -52,6 +52,8 @@ public function apply(BlockContext $blockContext, CompoundNode|null $on = null):
             $this->structuralElements->apply($blockContext, $on);
         }
 
+        $on->setLinks($blockContext->getDocumentParserContext()->getLinks());
+
         return $on;
     }
 }

packages/guides-restructured-text/src/RestructuredText/Parser/Productions/InlineRules/AnonymousPhraseRule.php

@@ -66,9 +66,8 @@ public function apply(BlockContext $blockContext, InlineLexer $lexer): HyperLink
 
     private function createAnonymousReference(BlockContext $blockContext, string $link, string|null $embeddedUrl): HyperLinkNode
     {
-        $blockContext->getDocumentParserContext()->getContext()->resetAnonymousStack();
         $node = $this->createReference($blockContext, $link, $embeddedUrl, false);
-        $blockContext->getDocumentParserContext()->getContext()->pushAnonymous($link);
+        $blockContext->getDocumentParserContext()->pushAnonymous($link);
 
         return $node;
     }

packages/guides-restructured-text/src/RestructuredText/Parser/Productions/InlineRules/AnonymousReferenceRule.php

@@ -39,9 +39,8 @@ public function apply(BlockContext $blockContext, InlineLexer $lexer): HyperLink
 
     private function createAnonymousReference(BlockContext $blockContext, string $link): HyperLinkNode
     {
-        $blockContext->getDocumentParserContext()->getContext()->resetAnonymousStack();
         $node = $this->createReference($blockContext, $link, null, false);
-        $blockContext->getDocumentParserContext()->getContext()->pushAnonymous($link);
+        $blockContext->getDocumentParserContext()->pushAnonymous($link);
 
         return $node;
     }

packages/guides-restructured-text/src/RestructuredText/Parser/Productions/InlineRules/ReferenceRule.php

@@ -22,7 +22,7 @@ protected function createReference(BlockContext $blockContext, string $link, str
         $link = trim(preg_replace('/\s+/', ' ', $link) ?? '');
 
         if ($registerLink && $embeddedUrl !== null) {
-            $blockContext->getDocumentParserContext()->getContext()->setLink($link, $embeddedUrl);
+            $blockContext->getDocumentParserContext()->setLink($link, $embeddedUrl);
         }
 
         return new HyperLinkNode($link, $embeddedUrl ?? $link);

packages/guides-restructured-text/src/RestructuredText/Parser/Productions/LinkRule.php

@@ -53,7 +53,7 @@ public function apply(BlockContext $blockContext, CompoundNode|null $on = null):
         }
 
         //TODO: pass link object to setLink
-        $blockContext->getDocumentParserContext()->getContext()->setLink($link->getName(), $link->getUrl());
+        $blockContext->getDocumentParserContext()->setLink($link->getName(), $link->getUrl());
 
         return $node;
     }

packages/guides-restructured-text/tests/unit/Parser/Productions/LinkRuleTest.php

@@ -29,7 +29,7 @@ public function testParseLink(
         self::assertTrue($this->rule->applies($blockContext));
         self::assertEquals($expectedNode, $this->rule->apply($blockContext));
 
-        self::assertSame([$expectedLabel => $expectedUrl], $blockContext->getDocumentParserContext()->getContext()->getLinks());
+        self::assertSame([$expectedLabel => $expectedUrl], $blockContext->getDocumentParserContext()->getLinks());
     }
 
     /** @return Generator<string, array{string, string, string, AnchorNode|null}> */

packages/guides/src/Parser.php

@@ -88,7 +88,6 @@ public function parse(
         $parser = $this->determineParser($inputFormat);
 
         $document = $parser->parse($this->parserContext, $text);
-        $document->setLinks($this->parserContext->getLinks());
 
         $this->parserContext = null;
 

packages/guides/src/ParserContext.php

@@ -9,20 +9,11 @@
 use League\Uri\UriInfo;
 use phpDocumentor\Guides\Nodes\ProjectNode;
 
-use function array_shift;
 use function dirname;
 use function ltrim;
-use function strtolower;
-use function trim;
 
 class ParserContext
 {
-    /** @var array<string, string> */
-    private array $links = [];
-
-    /** @var string[] */
-    private array $anonymous = [];
-
     public function __construct(
         private readonly ProjectNode $projectNode,
         private readonly string $currentFileName,
@@ -43,33 +34,6 @@ public function getInitialHeaderLevel(): int
         return $this->initialHeaderLevel;
     }
 
-    public function setLink(string $name, string $url): void
-    {
-        $name = strtolower(trim($name));
-
-        if ($name === '_') {
-            $name = array_shift($this->anonymous);
-        }
-
-        $this->links[$name] = trim($url);
-    }
-
-    public function resetAnonymousStack(): void
-    {
-        $this->anonymous = [];
-    }
-
-    public function pushAnonymous(string $name): void
-    {
-        $this->anonymous[] = strtolower(trim($name));
-    }
-
-    /** @return array<string, string> */
-    public function getLinks(): array
-    {
-        return $this->links;
-    }
-
     public function absoluteRelativePath(string $url): string
     {
         $uri = Uri::createFromString($url);