django-tailwind-cli 4.6.0__tar.gz → 4.6.1__tar.gz

django_tailwind_cli-4.6.1/.github/dependabot.yml

@@ -0,0 +1,19 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    cooldown:
+      default-days: 7
+
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    cooldown:
+      default-days: 7
+    groups:
+      python-deps:
+        patterns:
+          - "*"

{django_tailwind_cli-4.6.0 → django_tailwind_cli-4.6.1}/.github/workflows/release.yml

@@ -2,6 +2,13 @@ name: Publish Python 🐍 distribution 📦 to PyPI and TestPyPI
 
 on: push
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
 env:
   # Change these for your project's URLs
   PYPI_URL: https://pypi.org/p/django-tailwind-cli
@@ -14,9 +21,11 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v6
+    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+      with:
+        persist-credentials: false
     - name: Set up Python
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
       with:
         python-version: "3.x"
     - name: Install pypa/build
@@ -25,20 +34,21 @@ jobs:
     - name: Build a binary wheel and a source tarball
       run: python3 -m build
     - name: Store the distribution packages
-      uses: actions/upload-artifact@v7
+      uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
       with:
         name: python-package-distributions
         path: dist/
     - name: Extract changelog for tagged release
       if: startsWith(github.ref, 'refs/tags/')
+      env:
+        REF_NAME: ${{ github.ref_name }}
       run: |
-        VERSION="${{ github.ref_name }}"
-        VERSION="${VERSION#v}"
-        awk "
-          /^## ${VERSION}/ { found=1; next }
+        VERSION="${REF_NAME#v}"
+        awk -v ver="$VERSION" '
+          $0 ~ "^## " ver { found=1; next }
           found && /^## / { exit }
           found { print }
-        " CHANGELOG.md > release-notes.md
+        ' CHANGELOG.md > release-notes.md
         if [[ ! -s release-notes.md ]]; then
           echo "::error::No changelog section found for version ${VERSION}."
           echo "::error::Did you forget to rename '## Unreleased' in CHANGELOG.md before tagging?"
@@ -48,7 +58,7 @@ jobs:
         cat release-notes.md
     - name: Upload release notes
       if: startsWith(github.ref, 'refs/tags/')
-      uses: actions/upload-artifact@v7
+      uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
       with:
         name: release-notes
         path: release-notes.md
@@ -67,12 +77,12 @@ jobs:
       id-token: write  # IMPORTANT: mandatory for trusted publishing
     steps:
     - name: Download all the dists
-      uses: actions/download-artifact@v8
+      uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
       with:
         name: python-package-distributions
         path: dist/
     - name: Publish distribution 📦 to PyPI
-      uses: pypa/gh-action-pypi-publish@release/v1.13
+      uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # release/v1.14
 
   github-release:
     name: >-
@@ -88,16 +98,16 @@ jobs:
 
     steps:
     - name: Download all the dists
-      uses: actions/download-artifact@v8
+      uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
       with:
         name: python-package-distributions
         path: dist/
     - name: Download release notes
-      uses: actions/download-artifact@v8
+      uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
       with:
         name: release-notes
     - name: Sign the dists with Sigstore
-      uses: sigstore/gh-action-sigstore-python@v3.3.0
+      uses: sigstore/gh-action-sigstore-python@04cffa1d795717b140764e8b640de88853c92acc # v3.3.0
       with:
         inputs: >-
           ./dist/*.tar.gz
@@ -105,21 +115,25 @@ jobs:
     - name: Create GitHub Release
       env:
         GITHUB_TOKEN: ${{ github.token }}
+        REF_NAME: ${{ github.ref_name }}
+        REPO: ${{ github.repository }}
       run: >-
         gh release create
-        '${{ github.ref_name }}'
-        --repo '${{ github.repository }}'
+        "$REF_NAME"
+        --repo "$REPO"
         --notes-file release-notes.md
     - name: Upload artifact signatures to GitHub Release
       env:
         GITHUB_TOKEN: ${{ github.token }}
+        REF_NAME: ${{ github.ref_name }}
+        REPO: ${{ github.repository }}
       # Upload to GitHub Release using the `gh` CLI.
       # `dist/` contains the built packages, and the
       # sigstore-produced signatures and certificates.
       run: >-
         gh release upload
-        '${{ github.ref_name }}' dist/**
-        --repo '${{ github.repository }}'
+        "$REF_NAME" dist/**
+        --repo "$REPO"
 
   publish-to-testpypi:
     name: Publish Python 🐍 distribution 📦 to TestPyPI
@@ -137,12 +151,12 @@ jobs:
 
     steps:
     - name: Download all the dists
-      uses: actions/download-artifact@v8
+      uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
       with:
         name: python-package-distributions
         path: dist/
     - name: Publish distribution 📦 to TestPyPI
-      uses: pypa/gh-action-pypi-publish@release/v1.13
+      uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # release/v1.14
       with:
         repository-url: https://test.pypi.org/legacy/
         skip-existing: true

django_tailwind_cli-4.6.1/.github/workflows/test.yml

@@ -0,0 +1,53 @@
+name: Test
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        with:
+          persist-credentials: false
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+
+      - name: Test with tox
+        run: uvx --with tox-uv --with tox-gh-actions tox
+
+  zizmor:
+    name: Audit workflows (zizmor)
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      actions: read # zizmor-action reads workflow definitions
+      security-events: write # upload SARIF results to code scanning
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        with:
+          persist-credentials: false
+
+      - uses: zizmorcore/zizmor-action@b1d7e1fb5de872772f31590499237e7cce841e8e # v0.5.3

{django_tailwind_cli-4.6.0 → django_tailwind_cli-4.6.1}/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## Unreleased
+
+## 4.6.1 (2026-05-10)
+
+### 🐛 Bug Fixes
+- **`tailwind watch` crash with `TAILWIND_CLI_CSS_MAP`**: `MultiWatchProcessManager` installed `signal.signal` handlers that fail with `ValueError: signal only works in main thread of the main interpreter` under Django's autoreloader (the watch loop runs in a worker thread). Cleanup now relies on `KeyboardInterrupt` propagation, matching the single-entry path. Fixes [#201](https://github.com/django-commons/django-tailwind-cli/issues/201).
+- **SIGTERM-graceful shutdown for both watch managers**: `ProcessManager` and `MultiWatchProcessManager` now install a SIGTERM handler only when running on the main thread, so `kill -TERM` cleans up child watchers in `tailwind watch --noreload` and `tailwind runserver` without re-introducing the autoreloader crash. SIGINT keeps using Python's default handler (which raises `KeyboardInterrupt`).
+- **Sidestepped a Bun DLOPEN race in multi-entry watch**: `MultiWatchProcessManager` now staggers successive watcher subprocess spawns by 300 ms. The Bun-built tailwindcss standalone binary extracts its embedded `@parcel/watcher` native module to `/$bunfs/` on first use; two parallel processes raced on that path and the loser crashed with `ERR_DLOPEN_FAILED`. The 300 ms gap is below noticeable in interactive use.
+
+### 🛠️ Developer Experience
+- **Filtered Bun native-runtime noise from watcher stderr**: `MultiWatchProcessManager` captures each `tailwindcss` subprocess' stderr and drops upstream Bun stack traces (`EIO: i/o error` on shutdown, `ERR_DLOPEN_FAILED` on the rare DLOPEN race) while forwarding Tailwind's own diagnostics verbatim. Cleanup output stays clean even when the user `kill -TERM`s the runserver.
+
+### 🔧 Technical Improvements
+- **Hardened GitHub Actions workflows**: pinned all actions to commit SHAs, scoped top-level permissions, added concurrency groups, moved `github.ref_name` / `github.repository` out of shell interpolation into `env:` vars, and added a [zizmor](https://docs.zizmor.sh/) audit job to keep workflow security regressions out of CI.
+
 ## 4.6.0 (2026-04-11)
 
 ### 💥 Breaking Changes

{django_tailwind_cli-4.6.0 → django_tailwind_cli-4.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-tailwind-cli
-Version: 4.6.0
+Version: 4.6.1
 Summary: Django and Tailwind integration based on the prebuilt Tailwind CSS CLI.
 Project-URL: Home, https://django-tailwind-cli.rtfd.io/
 Project-URL: Documentation, https://django-tailwind-cli.rtfd.io/

{django_tailwind_cli-4.6.0 → django_tailwind_cli-4.6.1}/docs/requirements.txt

@@ -1,5 +1,5 @@
-sphinx>=8.0
-myst-parser>=4.0
+sphinx>=8.1.3
+myst-parser>=4.0.1
 sphinx-copybutton
 sphinx-autobuild
 furo

{django_tailwind_cli-4.6.0 → django_tailwind_cli-4.6.1}/src/django_tailwind_cli/management/commands/tailwind.py

@@ -3,13 +3,15 @@
 import importlib.util
 import functools
 import os
+import re
 import signal
 import subprocess
 import sys
+import threading
 import time
 from pathlib import Path
 from types import FrameType
-from typing import Any
+from typing import IO, Any
 from collections.abc import Callable
 
 from django_tailwind_cli.utils import http
@@ -43,6 +45,51 @@ For more information about a specific command, use:
     rich_markup_mode="markdown",
 )  # type: ignore
 
+# Delay between successive multi-watch Popen calls. The Bun-built tailwindcss
+# standalone binary extracts its embedded @parcel/watcher native module to
+# /$bunfs/ on first use; two parallel spawns race on the same path and one
+# crashes with ERR_DLOPEN_FAILED. Staggering by 300 ms sidesteps the race
+# without being noticeable in interactive use.
+_WATCH_SPAWN_STAGGER_S = 0.3
+
+# Bun-built tailwindcss occasionally leaks unhandled native-module errors
+# (DLOPEN race on startup, EIO on shutdown when its watch FD is closed under
+# it). The traces are upstream noise — neither actionable nor caused by
+# user code. We drop matching lines from forwarded stderr while keeping
+# Tailwind's own diagnostics intact.
+_BUN_NOISE = re.compile(
+    r"""
+    ^EIO:\ i/o\ error          |   # EIO header
+    ^Bun\ v\d                  |   # crash footer
+    ^error:\ dlopen\(          |   # DLOPEN header
+    ^\d+\ ?\|                  |   # numbered source-context line
+    ^\s+(?:fd|syscall|errno|code):  |   # error-detail field
+    ^\s+at\ <anonymous>\ \(/\$bunfs/   |   # bunfs stack frame
+    ^\s+\^\s*$                 |   # caret pointer
+    ^\s+code:\s*"(?:EIO|ERR_DLOPEN_FAILED)"   # error-code value
+    """,
+    re.VERBOSE,
+)
+
+
+def _is_bun_noise(line: str) -> bool:
+    """Return True if the line looks like a Bun native-runtime crash trace."""
+    return bool(_BUN_NOISE.match(line))
+
+
+def _drain_filtered_stderr(stream: IO[str], is_shutting_down: Callable[[], bool]) -> None:
+    """Forward subprocess stderr to the parent's stderr, dropping Bun noise.
+
+    Runs in a daemon thread until the subprocess closes the pipe. Drops every
+    line once `is_shutting_down()` returns True — post-shutdown stderr is not
+    actionable and just churns output during cleanup.
+    """
+    for line in stream:
+        if is_shutting_down() or _is_bun_noise(line):
+            continue
+        sys.stderr.write(line)
+        sys.stderr.flush()
+
 
 # DECORATORS AND COMMON SETUP ---------------------------------------------------------------------
 
@@ -1027,6 +1074,8 @@ def runserver(
 class ProcessManager:
     """Manages concurrent processes for Tailwind watch and Django runserver."""
 
+    _SHUTDOWN_MESSAGE = "\nShutdown signal received, stopping processes..."
+
     def __init__(self) -> None:
         self.processes: list[subprocess.Popen[str]] = []
         self.shutdown_requested = False
@@ -1038,9 +1087,11 @@ class ProcessManager:
             watch_cmd: Command to start Tailwind watch process.
             server_cmd: Command to start Django development server.
         """
-        # Set up signal handlers for graceful shutdown
-        signal.signal(signal.SIGINT, self._signal_handler)
-        signal.signal(signal.SIGTERM, self._signal_handler)
+        # SIGINT propagates as KeyboardInterrupt via Python's default handler.
+        # Override SIGTERM only on the main thread — signal.signal() raises
+        # ValueError in worker threads (e.g. under Django's autoreloader).
+        if threading.current_thread() is threading.main_thread():
+            signal.signal(signal.SIGTERM, self._signal_handler)
 
         try:
             # Start Tailwind watch process — inherit stdout/stderr so the
@@ -1067,22 +1118,31 @@ class ProcessManager:
             self.processes.append(server_process)
             typer.secho("Started Django development server", fg=typer.colors.GREEN)
 
-            # Monitor processes
             self._monitor_processes()
-
+        except KeyboardInterrupt:
+            self._request_shutdown()
         except Exception as e:
             typer.secho(f"Error starting processes: {e}", fg=typer.colors.RED)
-            self._cleanup_processes()
             raise
+        finally:
+            self._cleanup_processes()
 
     def _signal_handler(self, _signum: int, _frame: FrameType | None) -> None:
-        """Handle shutdown signals gracefully."""
-        typer.secho("\nShutdown signal received, stopping processes...", fg=typer.colors.YELLOW)
+        """Adapter for signal.signal — delegates to the idempotent shutdown request."""
+        self._request_shutdown()
+
+    def _request_shutdown(self) -> None:
+        """Print the shutdown message once and flip the flag. Idempotent.
+
+        Cleanup is owned by start_concurrent_processes' finally.
+        """
+        if self.shutdown_requested:
+            return
+        typer.secho(self._SHUTDOWN_MESSAGE, fg=typer.colors.YELLOW)
         self.shutdown_requested = True
-        self._cleanup_processes()
 
     def _monitor_processes(self) -> None:
-        """Monitor running processes and handle their lifecycle."""
+        """Monitor running processes. Cleanup is owned by start_concurrent_processes' finally."""
         while not self.shutdown_requested and any(p.poll() is None for p in self.processes):
             time.sleep(0.5)
 
@@ -1093,9 +1153,6 @@ class ProcessManager:
                     self.shutdown_requested = True
                     break
 
-        # Clean up any remaining processes
-        self._cleanup_processes()
-
     def _cleanup_processes(self) -> None:
         """Clean up all managed processes."""
         for process in self.processes:
@@ -1119,6 +1176,8 @@ class ProcessManager:
 class MultiWatchProcessManager:
     """Manages multiple Tailwind watch processes for multi-file mode."""
 
+    _SHUTDOWN_MESSAGE = "\nShutdown signal received, stopping watch processes..."
+
     def __init__(self) -> None:
         self.processes: list[subprocess.Popen[str]] = []
         self.shutdown_requested = False
@@ -1130,42 +1189,68 @@ class MultiWatchProcessManager:
             config: Configuration object with css_entries.
             verbose: Whether to show detailed information.
         """
-        # Set up signal handlers for graceful shutdown
-        signal.signal(signal.SIGINT, self._signal_handler)
-        signal.signal(signal.SIGTERM, self._signal_handler)
+        # SIGINT propagates as KeyboardInterrupt via Python's default handler.
+        # Override SIGTERM only on the main thread — signal.signal() raises
+        # ValueError in worker threads (e.g. under Django's autoreloader).
+        if threading.current_thread() is threading.main_thread():
+            signal.signal(signal.SIGTERM, self._signal_handler)
 
         try:
-            for entry in config.css_entries:
+            for index, entry in enumerate(config.css_entries):
+                if index > 0:
+                    time.sleep(_WATCH_SPAWN_STAGGER_S)
+
                 watch_cmd = config.get_watch_cmd(entry)
                 if verbose:
                     typer.secho(f"🚀 Starting watch for '{entry.name}'...", fg=typer.colors.CYAN)
                     typer.secho(f"   • Command: {' '.join(watch_cmd)}", fg=typer.colors.BLUE)
 
-                # Inherit stdout/stderr so output flows to the terminal and we
-                # avoid a pipe-fill deadlock — the OS pipe buffer would otherwise
-                # block the watcher after ~64 KB of rebuild status lines.
+                # Inherit stdout (high-volume rebuild progress) to avoid a pipe-fill
+                # deadlock — the OS pipe buffer would otherwise block the watcher
+                # after ~64 KB. stderr is captured so we can filter Bun's native-
+                # runtime noise (DLOPEN race, EIO on shutdown) before it hits the
+                # terminal; volume there is low enough that the drain thread keeps
+                # up easily.
                 process = subprocess.Popen(
                     watch_cmd,
                     cwd=settings.BASE_DIR,
                     text=True,
+                    stderr=subprocess.PIPE,
                 )
                 self.processes.append(process)
+                if process.stderr is not None:
+                    threading.Thread(
+                        target=_drain_filtered_stderr,
+                        args=(process.stderr, lambda: self.shutdown_requested),
+                        daemon=True,
+                    ).start()
                 typer.secho(f"Watching '{entry.name}': {entry.src_css}", fg=typer.colors.GREEN)
 
             self._monitor_processes()
+        except KeyboardInterrupt:
+            self._request_shutdown()
         except Exception as e:
             typer.secho(f"Error starting watch processes: {e}", fg=typer.colors.RED)
-            self._cleanup_processes()
             raise
+        finally:
+            self._cleanup_processes()
 
     def _signal_handler(self, _signum: int, _frame: FrameType | None) -> None:
-        """Handle shutdown signals gracefully."""
-        typer.secho("\nShutdown signal received, stopping watch processes...", fg=typer.colors.YELLOW)
+        """Adapter for signal.signal — delegates to the idempotent shutdown request."""
+        self._request_shutdown()
+
+    def _request_shutdown(self) -> None:
+        """Print the shutdown message once and flip the flag. Idempotent.
+
+        Cleanup is owned by start_watch_processes' finally.
+        """
+        if self.shutdown_requested:
+            return
+        typer.secho(self._SHUTDOWN_MESSAGE, fg=typer.colors.YELLOW)
         self.shutdown_requested = True
-        self._cleanup_processes()
 
     def _monitor_processes(self) -> None:
-        """Monitor all watch processes."""
+        """Monitor all watch processes. Cleanup is owned by start_watch_processes' finally."""
         while not self.shutdown_requested and any(p.poll() is None for p in self.processes):
             time.sleep(0.5)
 
@@ -1175,8 +1260,6 @@ class MultiWatchProcessManager:
                     self.shutdown_requested = True
                     break
 
-        self._cleanup_processes()
-
     def _cleanup_processes(self) -> None:
         """Clean up all watch processes."""
         for process in self.processes:

{django_tailwind_cli-4.6.0 → django_tailwind_cli-4.6.1}/tests/test_error_scenarios.py

@@ -7,7 +7,6 @@ file operations, and subprocess execution.
 # pyright: reportPrivateUsage=false
 
 import os
-import signal
 import subprocess
 import time
 from pathlib import Path
@@ -483,8 +482,8 @@ class TestFileSystemErrorScenarios:
 class TestConcurrencyErrorScenarios:
     """Test concurrency and race condition handling."""
 
-    def test_process_manager_signal_handling_error(self):
-        """Test ProcessManager error handling during signal processing."""
+    def test_process_manager_cleanup_swallows_terminate_error(self):
+        """ProcessManager cleanup must not propagate OSError from terminate()."""
         manager = ProcessManager()
 
         # Mock process that raises exception during terminate
@@ -494,14 +493,13 @@ class TestConcurrencyErrorScenarios:
         mock_process.wait.return_value = None
         manager.processes = [mock_process]
 
-        # Should handle terminate errors gracefully
-        manager._signal_handler(signal.SIGINT, None)
+        manager._cleanup_processes()
 
         # Should still clean up processes list
         assert manager.processes == []
 
-    def test_process_manager_wait_timeout_error(self):
-        """Test ProcessManager handling of wait timeout."""
+    def test_process_manager_cleanup_escalates_on_wait_timeout(self):
+        """ProcessManager cleanup must kill() when terminate() + wait() time out."""
         manager = ProcessManager()
 
         # Mock process that times out during wait
@@ -512,8 +510,7 @@ class TestConcurrencyErrorScenarios:
         mock_process.kill.return_value = None
         manager.processes = [mock_process]
 
-        # Should escalate to kill when terminate times out
-        manager._signal_handler(signal.SIGINT, None)
+        manager._cleanup_processes()
 
         mock_process.terminate.assert_called_once()
         mock_process.kill.assert_called_once()

{django_tailwind_cli-4.6.0 → django_tailwind_cli-4.6.1}/tests/test_integration.py

@@ -5,8 +5,11 @@ file operations, and cross-platform compatibility.
 """
 # pyright: reportPrivateUsage=false
 
+import io
 import os
 import platform
+import signal
+import threading
 import time
 from pathlib import Path
 from collections.abc import Callable
@@ -24,7 +27,12 @@ from django_tailwind_cli.config import get_config
 from django_tailwind_cli.management.commands.tailwind import (
     DAISY_UI_SOURCE_CSS,
     DEFAULT_SOURCE_CSS,
+    _WATCH_SPAWN_STAGGER_S,
+    MultiWatchProcessManager,
     ProcessManager,
+    _drain_filtered_stderr,
+    _is_bun_noise,
+    _run_watch_loop,
 )
 
 
@@ -33,6 +41,13 @@ def _call_directly(func: Any, *args: Any, **kwargs: Any) -> Any:
     return func(*args, **kwargs)
 
 
+def _clear_legacy_css_settings(settings: LazySettings) -> None:
+    """Drop single-file CSS settings so CSS_MAP is the sole source of truth."""
+    for name in ("TAILWIND_CLI_SRC_CSS", "TAILWIND_CLI_DIST_CSS"):
+        if hasattr(settings, name):
+            delattr(settings, name)
+
+
 class TestBuildWorkflowIntegration:
     """Test complete build workflow from setup to CSS generation."""
 
@@ -197,11 +212,7 @@ class TestBuildWorkflowIntegration:
             ("admin.css", "admin.output.css"),
             ("web.css", "web.output.css"),
         ]
-        # Remove single-file settings to avoid conflict
-        if hasattr(settings, "TAILWIND_CLI_SRC_CSS"):
-            delattr(settings, "TAILWIND_CLI_SRC_CSS")
-        if hasattr(settings, "TAILWIND_CLI_DIST_CSS"):
-            delattr(settings, "TAILWIND_CLI_DIST_CSS")
+        _clear_legacy_css_settings(settings)
 
         # Create source CSS files
         (tmp_path / "admin.css").write_text('@import "tailwindcss";')
@@ -308,11 +319,7 @@ class TestWatchModeIntegration:
             ("admin.css", "admin.output.css"),
             ("web.css", "web.output.css"),
         ]
-        # Remove single-file settings to avoid conflict
-        if hasattr(settings, "TAILWIND_CLI_SRC_CSS"):
-            delattr(settings, "TAILWIND_CLI_SRC_CSS")
-        if hasattr(settings, "TAILWIND_CLI_DIST_CSS"):
-            delattr(settings, "TAILWIND_CLI_DIST_CSS")
+        _clear_legacy_css_settings(settings)
 
         # Create source CSS files
         (tmp_path / "admin.css").write_text('@import "tailwindcss";')
@@ -339,6 +346,7 @@ class TestWatchModeIntegration:
             mock_process = Mock()
             mock_process.poll.return_value = 0  # Process already exited
             mock_process.wait.return_value = 0
+            mock_process.stderr = None  # skip the stderr drain thread
             mock_popen.return_value = mock_process
 
             call_command("tailwind", "watch")
@@ -361,6 +369,117 @@ class TestWatchModeIntegration:
             assert "web.output.css" in str(call_args_1)
             assert "--watch" in call_args_1
 
+    def test_watch_with_css_map_runs_in_worker_thread(self, settings: LazySettings, tmp_path: Path):
+        """Regression for #201: multi-entry watch must work outside the main thread.
+
+        Django's autoreload.run_with_reloader executes the wrapped callable
+        in a worker thread. signal.signal() raises ValueError there, so the
+        multi-entry watch path must not rely on signal handlers.
+        """
+        settings.BASE_DIR = tmp_path
+        settings.TAILWIND_CLI_PATH = tmp_path / ".django_tailwind_cli"
+        settings.STATICFILES_DIRS = (tmp_path / "assets",)
+        settings.TAILWIND_CLI_VERSION = "4.1.3"
+        settings.TAILWIND_CLI_CSS_MAP = [
+            ("admin.css", "admin.output.css"),
+            ("web.css", "web.output.css"),
+        ]
+        _clear_legacy_css_settings(settings)
+
+        (tmp_path / "admin.css").write_text('@import "tailwindcss";')
+        (tmp_path / "web.css").write_text('@import "tailwindcss";')
+
+        with (
+            patch("django_tailwind_cli.utils.http.download_with_progress") as mock_download,
+            patch("subprocess.Popen") as mock_popen,
+        ):
+
+            def mock_download_func(
+                url: str,
+                filepath: Path,
+                timeout: int = 30,
+                progress_callback: Callable[[int, int, float], None] | None = None,
+            ) -> None:
+                filepath.parent.mkdir(parents=True, exist_ok=True)
+                filepath.write_bytes(b"fake-cli-binary")
+                filepath.chmod(0o755)
+
+            mock_download.side_effect = mock_download_func
+
+            mock_process = Mock()
+            mock_process.poll.return_value = 0  # already exited → monitor loop returns immediately
+            mock_process.wait.return_value = 0
+            mock_process.stderr = None  # skip the stderr drain thread
+            mock_popen.return_value = mock_process
+
+            errors: list[BaseException] = []
+
+            def runner() -> None:
+                try:
+                    _run_watch_loop(verbose=False)
+                except BaseException as exc:
+                    errors.append(exc)
+
+            worker = threading.Thread(target=runner)
+            worker.start()
+            worker.join(timeout=5)
+
+            assert not worker.is_alive(), "_run_watch_loop did not terminate within 5s"
+            assert not errors, f"_run_watch_loop crashed in worker thread: {errors[0]!r}"
+
+    @pytest.mark.parametrize(
+        "entry_count,expected_staggers",
+        [(2, 1), (3, 2), (4, 3)],
+    )
+    def test_watch_staggers_multi_entry_spawn(
+        self,
+        settings: LazySettings,
+        tmp_path: Path,
+        mocker: MockerFixture,
+        entry_count: int,
+        expected_staggers: int,
+    ):
+        """Multi-entry Popen calls must be spaced by _WATCH_SPAWN_STAGGER_S to avoid the Bun DLOPEN race."""
+        settings.BASE_DIR = tmp_path
+        settings.TAILWIND_CLI_PATH = tmp_path / ".django_tailwind_cli"
+        settings.STATICFILES_DIRS = (tmp_path / "assets",)
+        settings.TAILWIND_CLI_VERSION = "4.1.3"
+        settings.TAILWIND_CLI_CSS_MAP = [(f"src{i}.css", f"out{i}.output.css") for i in range(entry_count)]
+        _clear_legacy_css_settings(settings)
+
+        for i in range(entry_count):
+            (tmp_path / f"src{i}.css").write_text('@import "tailwindcss";')
+
+        def mock_download_func(
+            url: str,
+            filepath: Path,
+            timeout: int = 30,
+            progress_callback: Callable[[int, int, float], None] | None = None,
+        ) -> None:
+            filepath.parent.mkdir(parents=True, exist_ok=True)
+            filepath.write_bytes(b"fake-cli-binary")
+            filepath.chmod(0o755)
+
+        mocker.patch("django_tailwind_cli.utils.http.download_with_progress", side_effect=mock_download_func)
+
+        mock_process = Mock()
+        mock_process.poll.return_value = 0  # exits immediately so monitor loop returns
+        mock_process.wait.return_value = 0
+        mock_process.stderr = None  # skip the stderr drain thread
+        mock_popen = mocker.patch("subprocess.Popen", return_value=mock_process)
+
+        # Patch only the time reference inside tailwind.py to avoid disturbing
+        # the rest of the test runtime.
+        mock_sleep = mocker.patch("django_tailwind_cli.management.commands.tailwind.time.sleep")
+
+        call_command("tailwind", "watch")
+
+        assert mock_popen.call_count == entry_count
+        stagger_calls = [c for c in mock_sleep.call_args_list if c.args == (_WATCH_SPAWN_STAGGER_S,)]
+        assert len(stagger_calls) == expected_staggers, (
+            f"expected {expected_staggers} stagger sleeps, got {len(stagger_calls)} of {mock_sleep.call_args_list}"
+        )
+
     def test_watch_keyboard_interrupt_handling(
         self, settings: LazySettings, tmp_path: Path, capsys: CaptureFixture[str]
     ):
@@ -413,10 +532,7 @@ class TestProcessManagerIntegration:
         mock_process.wait.return_value = None
         manager.processes = [mock_process]
 
-        # Manually trigger cleanup to test behavior
-        import signal
-
-        manager._signal_handler(signal.SIGINT, None)
+        manager._cleanup_processes()
 
         # Verify cleanup was called
         mock_process.terminate.assert_called_once()
@@ -431,15 +547,115 @@ class TestProcessManagerIntegration:
         mock_process.poll.return_value = 0  # Already exited
         manager.processes = [mock_process]
 
-        # Manually trigger cleanup to test behavior
-        import signal
-
-        manager._signal_handler(signal.SIGINT, None)
+        manager._cleanup_processes()
 
         # Should not call terminate on already-exited process
         mock_process.terminate.assert_not_called()
         assert manager.processes == []
 
+    @pytest.mark.parametrize("manager_cls", [ProcessManager, MultiWatchProcessManager])
+    def test_signal_handler_flips_shutdown_flag_without_cleanup(self, manager_cls: type):
+        """Handler must only flip the flag — cleanup is owned by start_xxx' finally."""
+        manager = manager_cls()
+        mock_process = Mock()
+        mock_process.poll.return_value = None
+        manager.processes = [mock_process]
+
+        manager._signal_handler(signal.SIGTERM, None)
+
+        assert manager.shutdown_requested is True
+        # Cleanup must NOT happen inside the handler — re-entrancy risk.
+        mock_process.terminate.assert_not_called()
+        assert manager.processes == [mock_process]
+
+    @pytest.mark.parametrize("manager_cls", [ProcessManager, MultiWatchProcessManager])
+    def test_sigterm_in_main_thread_triggers_shutdown(self, manager_cls: type):
+        """SIGTERM received in the main thread must flip the shutdown flag."""
+        manager = manager_cls()
+        original = signal.getsignal(signal.SIGTERM)
+        signal.signal(signal.SIGTERM, manager._signal_handler)
+        try:
+            signal.raise_signal(signal.SIGTERM)
+            assert manager.shutdown_requested is True
+        finally:
+            signal.signal(signal.SIGTERM, original)
+
+    @pytest.mark.parametrize("manager_cls", [ProcessManager, MultiWatchProcessManager])
+    def test_signal_handler_is_idempotent(self, manager_cls: type, capsys: CaptureFixture[str]):
+        """Repeated SIGTERMs must produce a single shutdown message (e.g. when pkill matches both wrapper and child)."""
+        manager = manager_cls()
+        manager._signal_handler(signal.SIGTERM, None)
+        manager._signal_handler(signal.SIGTERM, None)
+        manager._signal_handler(signal.SIGTERM, None)
+
+        out = capsys.readouterr().out
+        assert out.count("Shutdown signal received") == 1
+        assert manager.shutdown_requested is True
+
+
+class TestBunStderrFilter:
+    """Pattern-match and drain logic for filtering Bun native-runtime crash traces."""
+
+    @pytest.mark.parametrize(
+        "line",
+        [
+            "EIO: i/o error, read\n",
+            "      fd: 7,\n",
+            ' syscall: "read",\n',
+            "   errno: -5,\n",
+            '    code: "EIO"\n',
+            "Bun v1.2.8 (macOS arm64)\n",
+            "error: dlopen(/$bunfs/root/watcher-tzt47keb.node, 0x0001): tried...\n",
+            "      at <anonymous> (/$bunfs/root/tailwindcss-macos-arm64:22717:29)\n",
+            '    code: "ERR_DLOPEN_FAILED"\n',
+            "22716 |   module.exports = __require(...);\n",
+            "                                    ^\n",
+        ],
+    )
+    def test_is_bun_noise_drops_known_patterns(self, line: str):
+        assert _is_bun_noise(line) is True
+
+    @pytest.mark.parametrize(
+        "line",
+        [
+            "≈ tailwindcss v4.1.3\n",
+            "Done in 32ms\n",
+            '[ERROR] Could not resolve "tailwindcss"\n',
+            "Watching 'admin': /path/to/admin.css\n",
+            "warn - Cannot find module './foo'\n",
+            "\n",  # blank line — drained but not filtered
+        ],
+    )
+    def test_is_bun_noise_keeps_legitimate_lines(self, line: str):
+        assert _is_bun_noise(line) is False
+
+    def test_drain_filtered_stderr_drops_bun_noise(self, capsys: CaptureFixture[str]):
+        stream = io.StringIO(
+            "Done in 32ms\n"
+            "EIO: i/o error, read\n"
+            "      fd: 7,\n"
+            "Bun v1.2.8 (macOS arm64)\n"
+            '[ERROR] Could not resolve "tailwindcss"\n'
+        )
+
+        _drain_filtered_stderr(stream, lambda: False)
+
+        err = capsys.readouterr().err
+        assert "Done in 32ms" in err
+        assert "[ERROR] Could not resolve" in err
+        assert "EIO" not in err
+        assert "Bun v" not in err
+        assert "fd: 7" not in err
+
+    def test_drain_filtered_stderr_drops_everything_after_shutdown(self, capsys: CaptureFixture[str]):
+        """Post-shutdown stderr is just churn from terminating subprocesses; drop it."""
+        stream = io.StringIO("Done in 32ms\n[ERROR] something legit\n")
+
+        _drain_filtered_stderr(stream, lambda: True)
+
+        err = capsys.readouterr().err
+        assert err == ""
+
 
 class TestCLIDownloadIntegration:
     """Test CLI download and setup workflows."""

{django_tailwind_cli-4.6.0 → django_tailwind_cli-4.6.1}/uv.lock

@@ -168,36 +168,16 @@ toml = [
 
 [[package]]
 name = "django"
-version = "5.2.13"
+version = "5.2.14"
 source = { registry = "https://pypi.org/simple" }
-resolution-markers = [
-    "python_full_version < '3.12'",
-]
-dependencies = [
-    { name = "asgiref", marker = "python_full_version < '3.12'" },
-    { name = "sqlparse", marker = "python_full_version < '3.12'" },
-    { name = "tzdata", marker = "python_full_version < '3.12' and sys_platform == 'win32'" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/1f/c5/c69e338eb2959f641045802e5ea87ca4bf5ac90c5fd08953ca10742fad51/django-5.2.13.tar.gz", hash = "sha256:a31589db5188d074c63f0945c3888fad104627dfcc236fb2b97f71f89da33bc4", size = 10890368, upload-time = "2026-04-07T14:02:15.072Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/59/b1/51ab36b2eefcf8cdb9338c7188668a157e29e30306bfc98a379704c9e10d/django-5.2.13-py3-none-any.whl", hash = "sha256:5788fce61da23788a8ce6f02583765ab060d396720924789f97fa42119d37f7a", size = 8310982, upload-time = "2026-04-07T14:02:08.883Z" },
-]
-
-[[package]]
-name = "django"
-version = "6.0.4"
-source = { registry = "https://pypi.org/simple" }
-resolution-markers = [
-    "python_full_version >= '3.12'",
-]
 dependencies = [
-    { name = "asgiref", marker = "python_full_version >= '3.12'" },
-    { name = "sqlparse", marker = "python_full_version >= '3.12'" },
-    { name = "tzdata", marker = "python_full_version >= '3.12' and sys_platform == 'win32'" },
+    { name = "asgiref" },
+    { name = "sqlparse" },
+    { name = "tzdata", marker = "sys_platform == 'win32'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/60/b9/4155091ad1788b38563bd77a7258c0834e8c12a7f56f6975deaf54f8b61d/django-6.0.4.tar.gz", hash = "sha256:8cfa2572b3f2768b2e84983cf3c4811877a01edb64e817986ec5d60751c113ac", size = 10907407, upload-time = "2026-04-07T13:55:44.961Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/65/95/95f7faa0950867afaa0bef2460c6263afd6a2c78cc9434046ed28160b015/django-5.2.14.tar.gz", hash = "sha256:58a63ba841662e5c686b57ba1fec52ddd68c0b93bd96ac3029d55728f00bf8a2", size = 10895118, upload-time = "2026-05-05T13:57:31.104Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/e9/47/3d61d611609764aa71a37f7037b870e7bfb22937366974c4fd46cada7bab/django-6.0.4-py3-none-any.whl", hash = "sha256:14359c809fc16e8f81fd2b59d7d348e4d2d799da6840b10522b6edf7b8afc1da", size = 8368342, upload-time = "2026-04-07T13:55:37.999Z" },
+    { url = "https://files.pythonhosted.org/packages/14/44/f172870cf87aa25afef48fb72adba89ee8b77fcab6f3b23d240b923f1528/django-5.2.14-py3-none-any.whl", hash = "sha256:6f712143bd3064310d1f50fac859c3e9a274bdcfc9595339853be7779297fc76", size = 8311320, upload-time = "2026-05-05T13:57:25.795Z" },
 ]
 
 [[package]]
@@ -205,8 +185,7 @@ name = "django-extensions"
 version = "4.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "django", version = "5.2.13", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.12'" },
-    { name = "django", version = "6.0.4", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.12'" },
+    { name = "django" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/6d/b3/ed0f54ed706ec0b54fd251cc0364a249c6cd6c6ec97f04dc34be5e929eac/django_extensions-4.1.tar.gz", hash = "sha256:7b70a4d28e9b840f44694e3f7feb54f55d495f8b3fa6c5c0e5e12bcb2aa3cdeb", size = 283078, upload-time = "2025-04-11T01:15:39.617Z" }
 wheels = [
@@ -218,8 +197,7 @@ name = "django-stubs"
 version = "6.0.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "django", version = "5.2.13", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.12'" },
-    { name = "django", version = "6.0.4", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.12'" },
+    { name = "django" },
     { name = "django-stubs-ext" },
     { name = "tomli", marker = "python_full_version < '3.11'" },
     { name = "types-pyyaml" },
@@ -235,8 +213,7 @@ name = "django-stubs-ext"
 version = "6.0.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "django", version = "5.2.13", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.12'" },
-    { name = "django", version = "6.0.4", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.12'" },
+    { name = "django" },
     { name = "typing-extensions" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/52/e0/f2e6caf627d176a51fba1ca9c34082c7ea10d3f521ff2c828532ca99fa91/django_stubs_ext-6.0.2.tar.gz", hash = "sha256:70b7b7ae837e7a6036e2facb64435550bf7cf8143c1a6e802864d4824ce6058c", size = 6751, upload-time = "2026-04-01T08:27:01.987Z" }
@@ -248,8 +225,7 @@ wheels = [
 name = "django-tailwind-cli"
 source = { editable = "." }
 dependencies = [
-    { name = "django", version = "5.2.13", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.12'" },
-    { name = "django", version = "6.0.4", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.12'" },
+    { name = "django" },
     { name = "django-typer" },
     { name = "semver" },
 ]
@@ -298,8 +274,7 @@ version = "3.7.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "click" },
-    { name = "django", version = "5.2.13", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.12'" },
-    { name = "django", version = "6.0.4", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.12'" },
+    { name = "django" },
     { name = "typer" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/a8/3e/2c22722c02cbae3a1ba65a11b4764418562dd0962f533463dd4b8e2afb0f/django_typer-3.7.1.tar.gz", hash = "sha256:e20720f2f85e30db86be6abd2d5f67e673cfe0bebf7ef4ddd22c37bf8699ea06", size = 2975518, upload-time = "2026-03-31T23:14:15.061Z" }

django_tailwind_cli-4.6.0/.github/dependabot.yml

@@ -1,6 +0,0 @@
-version: 2
-updates:
-  - package-ecosystem: "github-actions"
-    directory: "/"
-    schedule:
-      interval: "weekly"

django_tailwind_cli-4.6.0/.github/workflows/test.yml

@@ -1,29 +0,0 @@
-name: Test
-
-on:
-  push:
-    branches:
-      - main
-  pull_request:
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
-
-    steps:
-      - uses: actions/checkout@v6
-
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v6
-        with:
-          python-version: ${{ matrix.python-version }}
-          allow-prereleases: true
-
-      - name: Install uv
-        uses: astral-sh/setup-uv@v7
-
-      - name: Test with tox
-        run: uvx --with tox-uv --with tox-gh-actions tox