django-tailwind-cli 4.4.2__tar.gz → 4.5.0__tar.gz

{django_tailwind_cli-4.4.2 → django_tailwind_cli-4.5.0}/.github/workflows/release.yml

@@ -14,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v6
     - name: Set up Python
       uses: actions/setup-python@v6
       with:
@@ -25,7 +25,7 @@ jobs:
     - name: Build a binary wheel and a source tarball
       run: python3 -m build
     - name: Store the distribution packages
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v6
       with:
         name: python-package-distributions
         path: dist/
@@ -44,7 +44,7 @@ jobs:
       id-token: write  # IMPORTANT: mandatory for trusted publishing
     steps:
     - name: Download all the dists
-      uses: actions/download-artifact@v5
+      uses: actions/download-artifact@v7
       with:
         name: python-package-distributions
         path: dist/
@@ -65,12 +65,12 @@ jobs:
 
     steps:
     - name: Download all the dists
-      uses: actions/download-artifact@v5
+      uses: actions/download-artifact@v7
       with:
         name: python-package-distributions
         path: dist/
     - name: Sign the dists with Sigstore
-      uses: sigstore/gh-action-sigstore-python@v3.0.1
+      uses: sigstore/gh-action-sigstore-python@v3.2.0
       with:
         inputs: >-
           ./dist/*.tar.gz
@@ -110,7 +110,7 @@ jobs:
 
     steps:
     - name: Download all the dists
-      uses: actions/download-artifact@v5
+      uses: actions/download-artifact@v7
       with:
         name: python-package-distributions
         path: dist/

{django_tailwind_cli-4.4.2 → django_tailwind_cli-4.5.0}/.github/workflows/test.yml

@@ -14,7 +14,7 @@ jobs:
         python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
 
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v6
@@ -23,7 +23,7 @@ jobs:
           allow-prereleases: true
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v7
 
       - name: Test with tox
         run: uvx --with tox-uv --with tox-gh-actions tox

{django_tailwind_cli-4.4.2 → django_tailwind_cli-4.5.0}/.pre-commit-config.yaml

@@ -40,11 +40,12 @@ repos:
         args: [--target-version, "4.2"]
 
   - repo: https://github.com/owenlamont/uv-secure
-    rev: 0.11.1
+    rev: 0.15.4
     hooks:
       - id: uv-secure
+        exclude: ^docs/
 
   - repo: https://github.com/RobertCraigie/pyright-python
-    rev: v1.1.403
+    rev: v1.1.407
     hooks:
     - id: pyright

{django_tailwind_cli-4.4.2 → django_tailwind_cli-4.5.0}/.readthedocs.yml

@@ -7,10 +7,10 @@ build:
   tools:
     python: "3.12"
 
-mkdocs:
-  configuration: mkdocs.yml
+sphinx:
+  configuration: docs/conf.py
 
 # Optionally declare the Python requirements required to build your docs
 python:
   install:
-  - requirements: docs/requirements.txt
+    - requirements: docs/requirements.txt

{django_tailwind_cli-4.4.2 → django_tailwind_cli-4.5.0}/CHANGELOG.md

@@ -1,6 +1,21 @@
 # Changelog
 
-## Unreleased
+## 4.5.0 (2025-12-29)
+
+### 🎯 New Features
+- **Multiple CSS entry points**: Added `TAILWIND_CLI_CSS_MAP` setting for compiling multiple CSS files in a single project (e.g., separate admin and frontend styles)
+- **Template tag enhancement**: `{% tailwind_css %}` now supports optional name parameter for multi-file mode: `{% tailwind_css "admin" %}`
+
+### 🔧 Technical Improvements
+- **Django support**: Dropped support for Django 5.1 (now supporting Django 4.2 LTS, 5.2, and 6.0 only)
+- **Pre-commit hooks**: Updated uv-secure (0.15.4) and pyright (1.1.407)
+- **Security**: Updated Django and Werkzeug to fix security vulnerabilities
+- **Documentation**: Migrated from MkDocs to Sphinx with myst-parser and Furo theme
+- **Template tag consistency**: Template tag now uses Config class for consistent validation
+- **Test coverage**: Added integration tests for multi-file build and watch commands
+
+### 🛠️ Developer Experience
+- **Cleanup command**: Added `just clean` target to remove temporary files and build artifacts
 
 ## 4.4.2 (2025-09-23)
 

{django_tailwind_cli-4.4.2 → django_tailwind_cli-4.5.0}/CLAUDE.md

@@ -114,7 +114,7 @@ Key Django settings for configuration:
 ## Version Support
 
 - Python: 3.10-3.14
-- Django: 4.0-6.0
+- Django: 4.2, 5.2-6.0
 - Tailwind CSS: 4.x only (use v2.21.1 for Tailwind 3.x)
 
 ## Commit Message Guidelines

{django_tailwind_cli-4.4.2 → django_tailwind_cli-4.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-tailwind-cli
-Version: 4.4.2
+Version: 4.5.0
 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/
@@ -28,11 +28,7 @@ License-File: LICENSE
 Keywords: css,django,tailwind
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Web Environment
-Classifier: Framework :: Django :: 4.0
-Classifier: Framework :: Django :: 4.1
 Classifier: Framework :: Django :: 4.2
-Classifier: Framework :: Django :: 5.0
-Classifier: Framework :: Django :: 5.1
 Classifier: Framework :: Django :: 5.2
 Classifier: Framework :: Django :: 6.0
 Classifier: Intended Audience :: Developers
@@ -46,8 +42,8 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Utilities
 Requires-Python: >=3.10
+Requires-Dist: django!=5.0.*,!=5.1.*,>=4.2
 Requires-Dist: django-typer>=2.1.2
-Requires-Dist: django>=4.0
 Requires-Dist: semver>=3.0.4
 Provides-Extra: django-extensions
 Requires-Dist: django-extensions>=3.2; extra == 'django-extensions'
@@ -56,23 +52,22 @@ Description-Content-Type: text/markdown
 
 # django-tailwind-cli
 
-![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/django-commons/django-tailwind-cli/test.yml?style=flat-square)
-[![PyPI](https://img.shields.io/pypi/v/django-tailwind-cli.svg?style=flat-square)](https://pypi.org/project/django-tailwind-cli/)
-[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
-[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
-![GitHub](https://img.shields.io/github/license/django-commons/django-tailwind-cli?style=flat-square)
-![Django Versions](https://img.shields.io/pypi/frameworkversions/django/django-tailwind-cli)
-![Python Versions](https://img.shields.io/pypi/pyversions/django-tailwind-cli)
-[![Downloads](https://static.pepy.tech/badge/django-tailwind-cli)](https://pepy.tech/project/django-tailwind-cli)
-[![Downloads / Month](https://pepy.tech/badge/django-tailwind-cli/month)](<https://pepy.tech/project/django-tailwind-cli>)
+<p style="display: flex; gap: 4px; flex-wrap: wrap; align-items: flex-start; line-height: 1;">
+<img style="height: auto;" alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/django-commons/django-tailwind-cli/test.yml">
+<a style="display: inline-block;" href="https://pypi.org/project/django-tailwind-cli/"><img style="height: auto;" alt="PyPI" src="https://img.shields.io/pypi/v/django-tailwind-cli.svg"></a>
+<a style="display: inline-block;" href="https://github.com/astral-sh/ruff"><img style="height: auto;" alt="Ruff" src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json"></a>
+<a style="display: inline-block;" href="https://github.com/astral-sh/uv"><img style="height: auto;" alt="uv" src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json"></a>
+<img style="height: auto;" alt="GitHub" src="https://img.shields.io/github/license/django-commons/django-tailwind-cli">
+<img style="height: auto;" alt="Django Versions" src="https://img.shields.io/pypi/frameworkversions/django/django-tailwind-cli">
+<img style="height: auto;" alt="Python Versions" src="https://img.shields.io/pypi/pyversions/django-tailwind-cli">
+<a style="display: inline-block;" href="https://pepy.tech/project/django-tailwind-cli"><img style="height: auto;" alt="Downloads" src="https://static.pepy.tech/badge/django-tailwind-cli"></a>
+<a style="display: inline-block;" href="https://pepy.tech/project/django-tailwind-cli"><img style="height: auto;" alt="Downloads / Month" src="https://pepy.tech/badge/django-tailwind-cli/month"></a>
+</p>
 
 **The simplest way to integrate Tailwind CSS with Django** ⚡
 
 No Node.js required! This library provides seamless [Tailwind CSS](https://tailwindcss.com) integration for Django using the standalone [Tailwind CSS CLI](https://tailwindcss.com/blog/standalone-cli). Inspired by the [Tailwind integration for Phoenix](https://github.com/phoenixframework/tailwind), it eliminates the need for Node.js in your Django development workflow.
 
-> [!WARNING]
-> **Version Compatibility:** 4.2.x+ supports Tailwind CSS 4.x only. For Tailwind CSS 3.x, use version 2.21.1.
-
 ## ✨ Why django-tailwind-cli?
 
 - **🚀 Zero Node.js dependency** - No npm, webpack, or build tools required
@@ -204,14 +199,14 @@ Start adding Tailwind classes to your templates:
 
 ### 🛠️ Management Commands
 
-| Command | Purpose | Example |
-|---------|---------|---------|
-| `setup` | Interactive setup guide | `python manage.py tailwind setup` |
-| `build` | Production CSS build | `python manage.py tailwind build` |
-| `watch` | Development file watcher | `python manage.py tailwind watch` |
-| `runserver` | Combined server + watcher | `python manage.py tailwind runserver` |
-| `config` | Show current configuration | `python manage.py tailwind config` |
-| `troubleshoot` | Debug common issues | `python manage.py tailwind troubleshoot` |
+| Command        | Purpose                    | Example                                  |
+| -------------- | -------------------------- | ---------------------------------------- |
+| `setup`        | Interactive setup guide    | `python manage.py tailwind setup`        |
+| `build`        | Production CSS build       | `python manage.py tailwind build`        |
+| `watch`        | Development file watcher   | `python manage.py tailwind watch`        |
+| `runserver`    | Combined server + watcher  | `python manage.py tailwind runserver`    |
+| `config`       | Show current configuration | `python manage.py tailwind config`       |
+| `troubleshoot` | Debug common issues        | `python manage.py tailwind troubleshoot` |
 
 ## 📋 Requirements
 

{django_tailwind_cli-4.4.2 → django_tailwind_cli-4.5.0}/README.md

@@ -1,22 +1,21 @@
 # django-tailwind-cli
 
-![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/django-commons/django-tailwind-cli/test.yml?style=flat-square)
-[![PyPI](https://img.shields.io/pypi/v/django-tailwind-cli.svg?style=flat-square)](https://pypi.org/project/django-tailwind-cli/)
-[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
-[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
-![GitHub](https://img.shields.io/github/license/django-commons/django-tailwind-cli?style=flat-square)
-![Django Versions](https://img.shields.io/pypi/frameworkversions/django/django-tailwind-cli)
-![Python Versions](https://img.shields.io/pypi/pyversions/django-tailwind-cli)
-[![Downloads](https://static.pepy.tech/badge/django-tailwind-cli)](https://pepy.tech/project/django-tailwind-cli)
-[![Downloads / Month](https://pepy.tech/badge/django-tailwind-cli/month)](<https://pepy.tech/project/django-tailwind-cli>)
+<p style="display: flex; gap: 4px; flex-wrap: wrap; align-items: flex-start; line-height: 1;">
+<img style="height: auto;" alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/django-commons/django-tailwind-cli/test.yml">
+<a style="display: inline-block;" href="https://pypi.org/project/django-tailwind-cli/"><img style="height: auto;" alt="PyPI" src="https://img.shields.io/pypi/v/django-tailwind-cli.svg"></a>
+<a style="display: inline-block;" href="https://github.com/astral-sh/ruff"><img style="height: auto;" alt="Ruff" src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json"></a>
+<a style="display: inline-block;" href="https://github.com/astral-sh/uv"><img style="height: auto;" alt="uv" src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json"></a>
+<img style="height: auto;" alt="GitHub" src="https://img.shields.io/github/license/django-commons/django-tailwind-cli">
+<img style="height: auto;" alt="Django Versions" src="https://img.shields.io/pypi/frameworkversions/django/django-tailwind-cli">
+<img style="height: auto;" alt="Python Versions" src="https://img.shields.io/pypi/pyversions/django-tailwind-cli">
+<a style="display: inline-block;" href="https://pepy.tech/project/django-tailwind-cli"><img style="height: auto;" alt="Downloads" src="https://static.pepy.tech/badge/django-tailwind-cli"></a>
+<a style="display: inline-block;" href="https://pepy.tech/project/django-tailwind-cli"><img style="height: auto;" alt="Downloads / Month" src="https://pepy.tech/badge/django-tailwind-cli/month"></a>
+</p>
 
 **The simplest way to integrate Tailwind CSS with Django** ⚡
 
 No Node.js required! This library provides seamless [Tailwind CSS](https://tailwindcss.com) integration for Django using the standalone [Tailwind CSS CLI](https://tailwindcss.com/blog/standalone-cli). Inspired by the [Tailwind integration for Phoenix](https://github.com/phoenixframework/tailwind), it eliminates the need for Node.js in your Django development workflow.
 
-> [!WARNING]
-> **Version Compatibility:** 4.2.x+ supports Tailwind CSS 4.x only. For Tailwind CSS 3.x, use version 2.21.1.
-
 ## ✨ Why django-tailwind-cli?
 
 - **🚀 Zero Node.js dependency** - No npm, webpack, or build tools required
@@ -148,14 +147,14 @@ Start adding Tailwind classes to your templates:
 
 ### 🛠️ Management Commands
 
-| Command | Purpose | Example |
-|---------|---------|---------|
-| `setup` | Interactive setup guide | `python manage.py tailwind setup` |
-| `build` | Production CSS build | `python manage.py tailwind build` |
-| `watch` | Development file watcher | `python manage.py tailwind watch` |
-| `runserver` | Combined server + watcher | `python manage.py tailwind runserver` |
-| `config` | Show current configuration | `python manage.py tailwind config` |
-| `troubleshoot` | Debug common issues | `python manage.py tailwind troubleshoot` |
+| Command        | Purpose                    | Example                                  |
+| -------------- | -------------------------- | ---------------------------------------- |
+| `setup`        | Interactive setup guide    | `python manage.py tailwind setup`        |
+| `build`        | Production CSS build       | `python manage.py tailwind build`        |
+| `watch`        | Development file watcher   | `python manage.py tailwind watch`        |
+| `runserver`    | Combined server + watcher  | `python manage.py tailwind runserver`    |
+| `config`       | Show current configuration | `python manage.py tailwind config`       |
+| `troubleshoot` | Debug common issues        | `python manage.py tailwind troubleshoot` |
 
 ## 📋 Requirements
 

{django_tailwind_cli-4.4.2 → django_tailwind_cli-4.5.0}/docs/base_template.md

@@ -1,8 +1,3 @@
----
-hide:
-  - navigation
----
-
 # Base Template
 
 The package also includes a minimal base template, which you can use as a starting point for your own project. It is a very simple template, which only includes the CSS stylesheets and the `tailwind_css` template tag. You can use by putting `{% extends "tailwind_cli/base.html" %}` into your template files.

django_tailwind_cli-4.5.0/docs/changelog.md

@@ -0,0 +1,2 @@
+```{include} ../CHANGELOG.md
+```

django_tailwind_cli-4.5.0/docs/conf.py

@@ -0,0 +1,51 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# For the full list of built-in configuration values, see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Project information -----------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
+
+project = "django-tailwind-cli"
+copyright = "2023, Oliver Andrich"  # noqa: A001
+author = "Oliver Andrich"
+
+# -- General configuration ---------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
+
+extensions = [
+    "myst_parser",
+    "sphinx_copybutton",
+]
+
+templates_path = ["_templates"]
+exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
+
+# -- Options for HTML output -------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
+
+html_theme = "furo"
+html_title = "django-tailwind-cli"
+html_static_path = []
+
+html_theme_options = {
+    "source_repository": "https://github.com/django-commons/django-tailwind-cli",
+    "source_branch": "main",
+    "source_directory": "docs/",
+}
+
+# -- MyST configuration ------------------------------------------------------
+# https://myst-parser.readthedocs.io/en/latest/configuration.html
+
+myst_enable_extensions = [
+    "colon_fence",
+    "deflist",
+    "fieldlist",
+    "substitution",
+]
+
+# Allow .md files to be parsed
+source_suffix = {
+    ".rst": "restructuredtext",
+    ".md": "markdown",
+}

django_tailwind_cli-4.5.0/docs/development.md

@@ -0,0 +1,177 @@
+# Development Workflow
+
+This guide covers development workflows for django-tailwind-cli.
+
+## Initial Setup
+
+```bash
+# Step 1: Install and configure
+pip install django-tailwind-cli
+python manage.py tailwind setup  # Interactive setup
+
+# Step 2: Verify configuration
+python manage.py tailwind config
+
+# Step 3: Start development
+python manage.py tailwind runserver
+```
+
+## Daily Development
+
+```bash
+# Morning startup
+python manage.py tailwind runserver  # Starts both Django and Tailwind
+
+# Alternative: Separate terminals
+python manage.py tailwind watch     # Terminal 1: CSS watching
+python manage.py runserver          # Terminal 2: Django server
+```
+
+## Template Development
+
+1. **Create/Edit Template**
+
+   ```htmldjango
+   <!-- templates/myapp/page.html -->
+   {% extends "base.html" %}
+
+   {% block content %}
+   <div class="max-w-4xl mx-auto p-6">
+     <h1 class="text-3xl font-bold text-gray-900">New Page</h1>
+   </div>
+   {% endblock %}
+   ```
+
+2. **Verify Template Scanning**
+
+   ```bash
+   python manage.py tailwind list_templates --verbose
+   ```
+
+3. **Build and Test**
+
+   ```bash
+   # CSS rebuilds automatically with watch mode
+   # Or manually: python manage.py tailwind build
+   ```
+
+## IDE Integration
+
+### VS Code Setup
+
+1. **Install Extensions:**
+   - Tailwind CSS IntelliSense
+   - Django Template
+   - Python
+
+2. **Workspace Settings:**
+
+   ```json
+   // .vscode/settings.json
+   {
+     "tailwindCSS.includeLanguages": {
+       "django-html": "html"
+     },
+     "tailwindCSS.files.exclude": [
+       "**/.git/**",
+       "**/node_modules/**"
+     ],
+     "files.associations": {
+       "*.html": "django-html"
+     }
+   }
+   ```
+
+3. **Tasks Configuration:**
+
+   ```json
+   // .vscode/tasks.json
+   {
+     "version": "2.0.0",
+     "tasks": [
+       {
+         "label": "Tailwind Runserver",
+         "type": "shell",
+         "command": "python",
+         "args": ["manage.py", "tailwind", "runserver"],
+         "group": "build",
+         "isBackground": true
+       }
+     ]
+   }
+   ```
+
+### PyCharm Setup
+
+1. **Run Configurations:**
+   - Name: Tailwind Watch
+   - Script: manage.py
+   - Parameters: tailwind watch
+   - Environment: Development
+
+2. **File Watchers:**
+   - File type: Django Template
+   - Scope: Project Files
+   - Program: python
+   - Arguments: manage.py tailwind build
+
+## Troubleshooting Checklist
+
+### Before Asking for Help
+
+1. **Check Configuration:**
+
+   ```bash
+   python manage.py tailwind config
+   ```
+
+2. **Verify Template Scanning:**
+
+   ```bash
+   python manage.py tailwind list_templates --verbose
+   ```
+
+3. **Test CLI Functionality:**
+
+   ```bash
+   python manage.py tailwind download_cli
+   python manage.py tailwind build --verbose
+   ```
+
+4. **Run Diagnostics:**
+
+   ```bash
+   python manage.py tailwind troubleshoot
+   ```
+
+5. **Check System Requirements:**
+   - Python 3.10+
+   - Django 4.2+
+   - Sufficient disk space
+   - Network access for CLI download
+
+### Information to Include in Bug Reports
+
+```text
+Environment:
+- OS: [macOS/Linux/Windows version]
+- Python: [version]
+- Django: [version]
+- django-tailwind-cli: [version]
+
+Configuration:
+- STATICFILES_DIRS: [value]
+- TAILWIND_CLI_VERSION: [value]
+- Custom settings: [list any custom Tailwind settings]
+
+Command Output:
+[Paste output from python manage.py tailwind config]
+
+Error Message:
+[Full error message and traceback]
+
+Steps to Reproduce:
+1. [First step]
+2. [Second step]
+3. [etc.]
+```

django_tailwind_cli-4.5.0/docs/index.md

@@ -0,0 +1,15 @@
+```{include} ../README.md
+```
+
+```{toctree}
+:maxdepth: 2
+:hidden:
+
+installation
+usage
+settings
+development
+template_tags
+base_template
+changelog
+```

{django_tailwind_cli-4.4.2 → django_tailwind_cli-4.5.0}/docs/installation.md

@@ -1,8 +1,3 @@
----
-hide:
-  - navigation
----
-
 # Installation
 
 ## Install `django-tailwind-cli`

django_tailwind_cli-4.5.0/docs/requirements.txt

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