Update musl detection logic in TailwindBinary

Author: Spomky

config/services.php

@@ -21,6 +21,7 @@
                 abstract_arg('Tailwind binary version'),
                 abstract_arg('path to Tailwind CSS config file'),
                 abstract_arg('path to PostCSS config file'),
+                abstract_arg('Tailwind binary platform'),
             ])
 
         ->set('tailwind.command.build', TailwindBuildCommand::class)

src/DependencyInjection/TailwindExtension.php

@@ -39,6 +39,7 @@ public function load(array $configs, ContainerBuilder $container): void
             ->replaceArgument(4, $config['binary_version'])
             ->replaceArgument(5, $config['config_file'])
             ->replaceArgument(6, $config['postcss_config_file'])
+            ->replaceArgument(7, $config['binary_platform'])
         ;
     }
 
@@ -57,6 +58,7 @@ public function getConfigTreeBuilder(): TreeBuilder
         $treeBuilder = new TreeBuilder('symfonycasts_tailwind');
         $rootNode = $treeBuilder->getRootNode();
         \assert($rootNode instanceof ArrayNodeDefinition);
+        $platforms = ['auto', 'linux-arm64', 'linux-arm64-musl', 'linux-x64', 'linux-x64-musl', 'macos-arm64', 'macos-x64', 'windows-x64'];
 
         $rootNode
             ->children()
@@ -84,6 +86,11 @@ public function getConfigTreeBuilder(): TreeBuilder
                         })
                     ->end()
                 ->end()
+                ->enumNode('binary_platform')
+                    ->values($platforms)
+                    ->info('Tailwind CLI platform to download - "auto" will try to detect the platform automatically')
+                    ->defaultValue('auto')
+                ->end()
                 ->scalarNode('postcss_config_file')
                     ->info('Path to PostCSS config file which is passed to the Tailwind CLI')
                     ->defaultNull()

src/TailwindBinary.php

@@ -32,6 +32,7 @@ public function __construct(
         private ?string $binaryVersion,
         private ?SymfonyStyle $output = null,
         ?HttpClientInterface $httpClient = null,
+        private string $binaryPlatform = 'auto',
     ) {
         $this->httpClient = $httpClient ?? HttpClient::create();
 
@@ -95,7 +96,7 @@ private function getBinaryPath(): string
             return $this->binaryPath;
         }
 
-        $this->binaryPath = $this->binaryDownloadDir.'/'.$this->getVersion().'/'.self::getBinaryName($this->getRawVersion());
+        $this->binaryPath = $this->binaryDownloadDir.'/'.$this->getVersion().'/'.self::getBinaryName($this->getRawVersion(), $this->binaryPlatform);
 
         if (!is_file($this->binaryPath)) {
             $this->downloadExecutable();
@@ -106,7 +107,7 @@ private function getBinaryPath(): string
 
     private function downloadExecutable(): void
     {
-        $binaryName = self::getBinaryName($this->getRawVersion());
+        $binaryName = self::getBinaryName($this->getRawVersion(), $this->binaryPlatform);
         $url = \sprintf('https://github.com/tailwindlabs/tailwindcss/releases/download/%s/%s', $this->getVersion(), $binaryName);
 
         $this->output?->note(\sprintf('Downloading TailwindCSS binary from %s', $url));
@@ -146,8 +147,19 @@ private function downloadExecutable(): void
     /**
      * @internal
      */
-    public static function getBinaryName(string $version): string
+    public static function getBinaryName(string $version, string $platform = 'auto'): string
     {
+        $system = self::getBinarySystem($version, $platform);
+        $isWindows = str_contains($system, 'windows');
+
+        return "tailwindcss-{$system}".(($isWindows) ? '.exe' : '');
+    }
+
+    private static function getBinarySystem(string $version, string $platform): string
+    {
+        if ('auto' !== $platform) {
+            return $platform;
+        }
         $os = strtolower(\PHP_OS);
         $machine = strtolower(php_uname('m'));
 
@@ -183,11 +195,6 @@ public static function getBinaryName(string $version): string
 
         // Detect MUSL only when version >= 4.0.0
         if ('linux' === $system && version_compare($version, '4.0.0', '>=')) {
-            $libs = [
-                'x64' => 'x86_64',
-                'arm64' => 'aarch64',
-            ];
-
             $isMusl = false;
             if (is_executable('/usr/bin/ldd') || is_executable('/bin/ldd')) {
                 $ldd = shell_exec('ldd --version 2>&1');
@@ -196,9 +203,9 @@ public static function getBinaryName(string $version): string
                 }
             }
 
-            return "tailwindcss-{$system}-{$arch}".($isMusl ? '-musl' : '');
+            return "{$system}-{$arch}".($isMusl ? '-musl' : '');
         }
 
-        return "tailwindcss-{$system}-{$arch}".(('windows' === $system) ? '.exe' : '');
+        return "{$system}-{$arch}";
     }
 }

src/TailwindBuilder.php

@@ -34,6 +34,7 @@ public function __construct(
         private readonly ?string $binaryVersion = null,
         private readonly string $configPath = 'tailwind.config.js',
         private readonly ?string $postCssConfigPath = null,
+        private readonly string $binaryPlatform = 'auto',
     ) {
         $paths = [];
         foreach ($inputPaths as $inputPath) {
@@ -155,7 +156,7 @@ public function getOutputCssContent(string $inputFile): string
 
     public function createBinary(): TailwindBinary
     {
-        return $this->binary ??= new TailwindBinary($this->tailwindVarDir, $this->projectRootDir, $this->binaryPath, $this->binaryVersion, $this->output);
+        return $this->binary ??= new TailwindBinary($this->tailwindVarDir, $this->projectRootDir, $this->binaryPath, $this->binaryVersion, $this->output, null, $this->binaryPlatform);
     }
 
     private function validateInputFile(string $inputPath): string

tests/TailwindBinaryTest.php

@@ -18,7 +18,10 @@
 
 class TailwindBinaryTest extends TestCase
 {
-    public function testBinaryIsDownloadedAndProcessCreated()
+    /**
+     * @dataProvider platformAndVersionProvider
+     */
+    public function testBinaryIsDownloadedAndProcessCreated(string $version, string $platform, string $expectedBinaryName)
     {
         $binaryDownloadDir = __DIR__.'/fixtures/download';
         $fs = new Filesystem();
@@ -31,9 +34,9 @@ public function testBinaryIsDownloadedAndProcessCreated()
             new MockResponse('fake binary contents'),
         ]);
 
-        $binary = new TailwindBinary($binaryDownloadDir, __DIR__, null, 'fake-version', null, $client);
+        $binary = new TailwindBinary($binaryDownloadDir, __DIR__, null, 'fake-version', null, $client, $platform);
         $process = $binary->createProcess(['-i', 'fake.css']);
-        $binaryFile = $binaryDownloadDir.'/fake-version/'.TailwindBinary::getBinaryName('4.0.0');
+        $binaryFile = $binaryDownloadDir.'/fake-version/'.$expectedBinaryName;
         $this->assertFileExists($binaryFile);
 
         $this->assertSame(
@@ -86,4 +89,21 @@ public function testCustomBinaryUsed()
             $process->getCommandLine()
         );
     }
+
+    public function platformAndVersionProvider(): iterable
+    {
+        yield ['3.4.17', 'linux-arm64', 'tailwindcss-linux-arm64'];
+        yield ['3.4.17', 'linux-armv7', 'tailwindcss-linux-armv7'];
+        yield ['3.4.17', 'linux-x64', 'tailwindcss-linux-x64'];
+        yield ['3.4.17', 'macos-arm64', 'tailwindcss-macos-arm64'];
+        yield ['3.4.17', 'macos-x64', 'tailwindcss-macos-x64'];
+        yield ['3.4.17', 'windows-x64', 'tailwindcss-windows-x64.exe'];
+        yield ['4.0.0', 'linux-arm64', 'tailwindcss-linux-arm64'];
+        yield ['4.0.0', 'linux-arm64-musl', 'tailwindcss-linux-arm64-musl'];
+        yield ['4.0.0', 'linux-x64', 'tailwindcss-linux-x64'];
+        yield ['4.0.0', 'linux-x64-musl', 'tailwindcss-linux-x64-musl'];
+        yield ['4.0.0', 'macos-arm64', 'tailwindcss-macos-arm64'];
+        yield ['4.0.0', 'macos-x64', 'tailwindcss-macos-x64'];
+        yield ['4.0.0', 'windows-x64', 'tailwindcss-windows-x64.exe'];
+    }
 }