Making an autowireable alias and documenting reset

Author: weaverryan

README.md

@@ -88,3 +88,39 @@ and `build/entry1.js`, then `encore_entry_script_tags()` is equivalent to:
 If you want more control, you can use the `encore_entry_js_files()` and
 `encore_entry_css_files()` methods to get the list of files needed, then
 loop and create the `script` and `link` tags manually.
+
+## Rendering Multiple Times in a Request (e.g. to Generate a PDF)
+
+When you render your script or link tags, the bundle is smart enough
+not to repeat the same JavaScript or CSS file within the same request.
+This prevents you from having duplicate `<link>` or `<script>` tags
+if you render multiple entries that both rely on the same file.
+
+In some cases, however, you may want to render the script & link
+tags for the same entry multiple times in a request. For example,
+if you render multiple Twig templates to create multiple PDF files
+during a single request.
+
+In that case, before each render, you'll need to "reset" the internal
+cache so that the bundle re-renders CSS or JS files that it previously
+rendered. For example, in a controller:
+
+```php
+// src/Controller/SomeController.php
+
+use Symfony\WebpackEncoreBundle\Asset\EntrypointLookupCollectionInterface;
+
+class SomeController
+{
+    public function index(EntrypointLookupCollectionInterface $entrypointLookups)
+    {
+        $entrypointLookups->getEntrypointLookup()->reset();
+        // render a template
+
+        $entrypointLookups->getEntrypointLookup()->reset();
+        // render another template
+
+        // ...
+    }
+}
+```

src/Asset/EntrypointLookupCollection.php

@@ -19,19 +19,30 @@
  *
  * @final
  */
-class EntrypointLookupCollection
+class EntrypointLookupCollection implements EntrypointLookupCollectionInterface
 {
     private $buildEntrypoints;
 
-    public function __construct(ContainerInterface $buildEntrypoints)
+    private $defaultBuildName;
+
+    public function __construct(ContainerInterface $buildEntrypoints, string $defaultBuildName = null)
     {
         $this->buildEntrypoints = $buildEntrypoints;
+        $this->defaultBuildName = $defaultBuildName;
     }
 
-    public function getEntrypointLookup(string $buildName): EntrypointLookupInterface
+    public function getEntrypointLookup(string $buildName = null): EntrypointLookupInterface
     {
+        if (null === $buildName) {
+            if (null === $this->defaultBuildName) {
+                throw new UndefinedBuildException('There is no default build configured: please pass an argument to getEntrypointLookup().');
+            }
+
+            $buildName = $this->defaultBuildName;
+        }
+
         if (!$this->buildEntrypoints->has($buildName)) {
-            throw new UndefinedBuildException(sprintf('Given entry point "%s" is not configured', $buildName));
+            throw new UndefinedBuildException(sprintf('The build "%s" is not configured', $buildName));
         }
 
         return $this->buildEntrypoints->get($buildName);

src/Asset/EntrypointLookupCollectionInterface.php

@@ -0,0 +1,22 @@
+<?php
+
+/*
+ * This file is part of the Symfony WebpackEncoreBundle package.
+ * (c) Fabien Potencier <[email protected]>
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\WebpackEncoreBundle\Asset;
+
+use Symfony\WebpackEncoreBundle\Exception\UndefinedBuildException;
+
+interface EntrypointLookupCollectionInterface
+{
+    /**
+     * Retrieve the EntrypointLookupInterface for the given build.
+     *
+     * @throws UndefinedBuildException If the build does not exist.
+     */
+    public function getEntrypointLookup(string $buildName = null): EntrypointLookupInterface;
+}

src/Resources/config/services.xml

@@ -11,6 +11,8 @@
             <argument /> <!-- build list of entrypoints locator -->
         </service>
 
+        <service id="Symfony\WebpackEncoreBundle\Asset\EntrypointLookupCollectionInterface" alias="webpack_encore.entrypoint_lookup_collection" />
+
         <service id="webpack_encore.tag_renderer" class="Symfony\WebpackEncoreBundle\Asset\TagRenderer">
             <argument type="service" id="webpack_encore.entrypoint_lookup_collection" />
             <argument type="service" id="assets.packages" />

tests/Asset/EntrypointLookupCollectionTest.php

@@ -5,16 +5,35 @@
 use Symfony\Component\DependencyInjection\ServiceLocator;
 use Symfony\WebpackEncoreBundle\Asset\EntrypointLookupCollection;
 use PHPUnit\Framework\TestCase;
+use Symfony\WebpackEncoreBundle\Asset\EntrypointLookupInterface;
 
 class EntrypointLookupCollectionTest extends TestCase
 {
     /**
      * @expectedException Symfony\WebpackEncoreBundle\Exception\UndefinedBuildException
-     * @expectedExceptionMessage Given entry point "something" is not configured
+     * @expectedExceptionMessage The build "something" is not configured
      */
     public function testExceptionOnMissingEntry()
     {
         $collection = new EntrypointLookupCollection(new ServiceLocator([]));
         $collection->getEntrypointLookup('something');
     }
+
+    /**
+     * @expectedException Symfony\WebpackEncoreBundle\Exception\UndefinedBuildException
+     * @expectedExceptionMessage There is no default build configured: please pass an argument to getEntrypointLookup().
+     */
+    public function testExceptionOnMissingDefaultBuildEntry()
+    {
+        $collection = new EntrypointLookupCollection(new ServiceLocator([]));
+        $collection->getEntrypointLookup();
+    }
+
+    public function testDefaultBuildIsReturned()
+    {
+        $lookup = $this->createMock(EntrypointLookupInterface::class);
+        $collection = new EntrypointLookupCollection(new ServiceLocator(['the_default' => function() use ($lookup) { return $lookup; }]), 'the_default');
+
+        $this->assertSame($lookup, $collection->getEntrypointLookup());
+    }
 }