Adding a failing test case for bad figure behavior

weaverryan · weaverryan · commit 5e28a030e11a · 2021-03-18T20:22:06.000-04:00
diff --git a/src/Directive/AbstractAdmonitionDirective.php b/src/Directive/AbstractAdmonitionDirective.php
@@ -29,6 +29,10 @@ public function __construct(string $name, string $text)
 
     final public function processSub(Parser $parser, ?Node $document, string $variable, string $data, array $options): ?Node
     {
+        if (null === $document) {
+            throw new \RuntimeException('Content expected, none found.');
+        }
+
         $wrapperDiv = $parser->renderTemplate(
             'directives/admonition.html.twig',
             [
diff --git a/tests/IntegrationTest.php b/tests/IntegrationTest.php
@@ -137,8 +137,13 @@ public function testParseUnitBlock(string $blockName)
         $indenter = $this->createIndenter();
 
         $expectedFile = sprintf('%s/fixtures/expected/blocks/%s.html', __DIR__, $blockName);
+        $expected = file_get_contents($expectedFile);
+        // you can add notes to a test file via <!-- REMOVE the notes here -->
+        // we remove them here for comparing
+        $expected = preg_replace('/<\!\-\- REMOVE(.)+\-\->/', '', $expected);
+
         $this->assertSame(
-            str_replace(" \n", "\n", $indenter->indent(file_get_contents($expectedFile))),
+            str_replace(" \n", "\n", $indenter->indent($expected)),
             str_replace(" \n", "\n", $indenter->indent($document))
         );
     }
@@ -157,6 +162,10 @@ public function parserUnitBlockProvider()
             'blockName' => 'nodes/list',
         ];
 
+        yield 'figure' => [
+            'blockName' => 'nodes/figure',
+        ];
+
         yield 'caution' => [
             'blockName' => 'directives/caution',
         ];
diff --git a/tests/fixtures/expected/blocks/nodes/figure.html b/tests/fixtures/expected/blocks/nodes/figure.html
@@ -0,0 +1,22 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="utf-8" />
+</head>
+<body>
+
+<figure>
+    <!-- REMOVE: src is empty just because the test doesn't utilize the full stack, with CopyImagesListener -->
+    <img src="" alt="Symfony Logo" width="200px" />
+</figure>
+<p>I am a paragraph AFTER the figure. I should not be included as the
+caption for the above figure.</p>
+
+<figure>
+    <img src="" />
+
+    <figcaption><p>But I am a caption <em>for</em> the figure above.</p></figcaption>
+</figure>
+
+</body>
+</html>
diff --git a/tests/fixtures/source/blocks/nodes/figure.rst b/tests/fixtures/source/blocks/nodes/figure.rst
@@ -0,0 +1,10 @@
+.. figure:: images/logo.png
+   :alt: Symfony Logo
+   :width: 200px
+
+I am a paragraph AFTER the figure. I should not be included as the
+caption for the above figure.
+
+.. figure:: images/logo.png
+
+    But I am a caption *for* the figure above.

Original file line number	Diff line number	Diff line change
`@@ -29,6 +29,10 @@ public function __construct(string $name, string $text)`
`29`	`29`
`30`	`30`	`final public function processSub(Parser $parser, ?Node $document, string $variable, string $data, array $options): ?Node`
`31`	`31`	`{`
	`32`	`+ if (null === $document) {`
	`33`	`+ throw new \RuntimeException('Content expected, none found.');`
	`34`	`+ }`
	`35`	`+`
`32`	`36`	`$wrapperDiv = $parser->renderTemplate(`
`33`	`37`	`'directives/admonition.html.twig',`
`34`	`38`	`[`