Windows Docker and Tailwind watch mode (#57)

* Add --poll-watch option

* --poll-watch option documentation

* Adding --poll option

* Update --poll option description

Co-authored-by: Victor Bocharsky <[email protected]>

---------

Co-authored-by: Victor Bocharsky <[email protected]>

Author: clussiana

doc/index.rst

@@ -54,6 +54,17 @@ That's it! This will watch for changes to your ``assets/styles/app.css`` file
 and automatically recompile it when needed. If you refresh the page, the
 final ``app.css`` file will already contain the compiled CSS.
 
+Watch mode in Docker with Windows host
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you work on Windows and your app is running in a Docker container, and you
+are having trouble with the ``--watch`` option, you can try runnig the ``tailwind:build``
+command with ``--poll`` option.
+
+.. code-block:: terminal
+
+    $ php bin/console tailwind:build --watch --poll
+
 Symfony CLI
 ~~~~~~~~~~~
 

src/Command/TailwindBuildCommand.php

@@ -33,6 +33,7 @@ protected function configure(): void
     {
         $this
             ->addOption('watch', 'w', null, 'Watch for changes and rebuild automatically')
+            ->addOption('poll', null, null, 'Use polling instead of filesystem events when watching')
             ->addOption('minify', 'm', InputOption::VALUE_NONE, 'Minify the output CSS')
         ;
     }
@@ -44,6 +45,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
 
         $process = $this->tailwindBuilder->runBuild(
             watch: $input->getOption('watch'),
+            poll: $input->getOption('poll'),
             minify: $input->getOption('minify'),
         );
         $process->wait(function ($type, $buffer) use ($io) {

src/TailwindBuilder.php

@@ -48,12 +48,16 @@ public function __construct(
 
     public function runBuild(
         bool $watch,
+        bool $poll,
         bool $minify,
     ): Process {
         $binary = $this->createBinary();
         $arguments = ['-c', $this->configPath, '-i', $this->inputPath, '-o', $this->getInternalOutputCssPath()];
         if ($watch) {
             $arguments[] = '--watch';
+            if ($poll) {
+                $arguments[] = '--poll';
+            }
         }
         if ($minify) {
             $arguments[] = '--minify';

tests/TailwindBuilderTest.php

@@ -46,7 +46,7 @@ public function testIntegrationWithDefaultOptions(): void
             null,
             __DIR__.'/fixtures/tailwind.config.js'
         );
-        $process = $builder->runBuild(watch: false, minify: false);
+        $process = $builder->runBuild(watch: false, poll: false, minify: false);
         $process->wait();
 
         $this->assertTrue($process->isSuccessful());
@@ -67,7 +67,7 @@ public function testIntegrationWithMinify(): void
             null,
             __DIR__.'/fixtures/tailwind.config.js'
         );
-        $process = $builder->runBuild(watch: false, minify: true);
+        $process = $builder->runBuild(watch: false, poll: false, minify: true);
         $process->wait();
 
         $this->assertTrue($process->isSuccessful());