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

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

@@ -21,11 +21,11 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+    - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
       with:
         persist-credentials: false
     - name: Set up Python
-      uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
+      uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
       with:
         python-version: "3.x"
     - name: Install pypa/build
@@ -82,7 +82,7 @@ jobs:
         name: python-package-distributions
         path: dist/
     - name: Publish distribution 📦 to PyPI
-      uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # release/v1.14
+      uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # release/v1.14
 
   github-release:
     name: >-
@@ -107,7 +107,7 @@ jobs:
       with:
         name: release-notes
     - name: Sign the dists with Sigstore
-      uses: sigstore/gh-action-sigstore-python@04cffa1d795717b140764e8b640de88853c92acc # v3.3.0
+      uses: sigstore/gh-action-sigstore-python@790bc6befb9d733738f18d8f895854b453640ec9 # v3.5.0
       with:
         inputs: >-
           ./dist/*.tar.gz
@@ -156,7 +156,7 @@ jobs:
         name: python-package-distributions
         path: dist/
     - name: Publish distribution 📦 to TestPyPI
-      uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # release/v1.14
+      uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # release/v1.14
       with:
         repository-url: https://test.pypi.org/legacy/
         skip-existing: true

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

@@ -0,0 +1,68 @@
+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", "3.15"]
+
+    # Job-scoped so every step resolves the same interpreter, not just the
+    # install step. Prereleases are aliased in mise.toml, so "3.15" resolves.
+    env:
+      MISE_PYTHON_VERSION: ${{ matrix.python-version }}
+      # pre-commit is a local lint tool. Disabling it beats limiting
+      # install_args, because `mise run` would auto-install it again.
+      MISE_DISABLE_TOOLS: pre-commit
+
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Set up mise
+        uses: jdx/mise-action@1648a7812b9aeae629881980618f079932869151 # v4.0.1
+        with:
+          install: true
+          cache: true
+          # The default key ignores MISE_PYTHON_VERSION, so all six jobs would
+          # share one entry holding a single Python.
+          cache_key: "{{default}}-{{env.MISE_PYTHON_VERSION}}"
+
+      - name: Cache uv downloads
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          path: ~/.cache/uv
+          key: uv-${{ runner.os }}-${{ matrix.python-version }}-${{ hashFiles('uv.lock') }}
+          restore-keys: uv-${{ runner.os }}-${{ matrix.python-version }}-
+
+      - name: Test with tox
+        run: mise run test-all
+
+  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@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - uses: zizmorcore/zizmor-action@3dc1ecc9bcb9e94e9b2c709687979e1298497054 # v0.6.2

{django_tailwind_cli-4.6.1 → django_tailwind_cli-4.7.0}/.gitignore

@@ -78,6 +78,9 @@ docs/_build/
 # macOS
 .DS_Store
 
+# Local tool config
+mise.local.toml
+
 # AI tool configs
 CLAUDE.md
 AGENTS.md

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

@@ -2,6 +2,26 @@
 
 ## Unreleased
 
+## 4.7.0 (2026-08-15)
+
+### 🎯 New Features
+- **Django 6.1 support**: added to the test matrix and the trove classifiers.
+
+### 🛠️ Developer Experience
+- **Switch dev tooling from `just` to `mise`**: Python 3.10–3.15, `uv`, and `pre-commit` are now pinned in `mise.toml`. Local tasks run via `mise run …`; CI uses `jdx/mise-action`.
+
+### 📚 Documentation
+- **Plainer README**: dropped the emoji headings and marketing register, and merged the overlapping feature sections into one. Same coverage, ~20% shorter.
+- **Accurate `tailwind setup` help**: `--help` no longer calls the command interactive. It lists the eight checks it actually runs and notes that it prompts for nothing.
+
+### 🔧 Technical Improvements
+- **Dependency refresh**: clears the advisories `uv-secure` flagged in the old lock. `pytest-django` 4.14 renamed `SettingsWrapper` to `Settings`, so the dev floor moved to 4.14.
+
+## 4.6.2 (2026-05-14)
+
+### 🛠️ Developer Experience
+- **Python 3.15 support**: Added `py315` to the tox matrix (Django 6.0) and to the PyPI classifiers.
+
 ## 4.6.1 (2026-05-10)
 
 ### 🐛 Bug Fixes

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

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: django-tailwind-cli
-Version: 4.6.1
+Version: 4.7.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/
@@ -31,6 +31,7 @@ Classifier: Environment :: Web Environment
 Classifier: Framework :: Django :: 4.2
 Classifier: Framework :: Django :: 5.2
 Classifier: Framework :: Django :: 6.0
+Classifier: Framework :: Django :: 6.1
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
@@ -39,6 +40,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Utilities
 Requires-Python: >=3.10
@@ -64,20 +66,22 @@ Description-Content-Type: text/markdown
 <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** ⚡
+[Tailwind CSS](https://tailwindcss.com) for Django without Node.js. The library downloads the
+standalone [Tailwind CSS CLI](https://tailwindcss.com/blog/standalone-cli) and wires it into Django
+management commands, so there is no npm, no webpack, and no separate build tool to configure. It
+follows the approach of the [Tailwind integration for Phoenix](https://github.com/phoenixframework/tailwind).
 
-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.
+## What it does
 
-## ✨ Why django-tailwind-cli?
+- Downloads and manages the Tailwind CLI binary for your platform
+- Rebuilds CSS on change, running under Django's own auto-reloader
+- Produces minified production builds containing only the classes you use, and skips work when
+  nothing changed
+- Includes the CSS via a `{% tailwind_css %}` template tag
+- Supports [DaisyUI](https://daisyui.com) through [tailwindcss-cli-extra](https://github.com/dobicinaitis/tailwind-cli-extra)
+- Targets Tailwind CSS 4.x
 
-- **🚀 Zero Node.js dependency** - No npm, webpack, or build tools required
-- **⚡ Instant setup** - Get Tailwind running in under 5 minutes
-- **🔄 Hot reload** - Watch mode with automatic CSS rebuilding
-- **📦 Production ready** - Optimized builds with automatic purging
-- **🎨 DaisyUI support** - Built-in component library integration
-- **🛠️ Developer friendly** - Rich CLI with helpful error messages and debugging tools
-
-## 🚀 Quick Start
+## Installation
 
 ### 1. Install the package
 
@@ -85,7 +89,7 @@ No Node.js required! This library provides seamless [Tailwind CSS](https://tailw
 # Using pip
 pip install django-tailwind-cli
 
-# Using uv (recommended)
+# Using uv
 uv add django-tailwind-cli
 
 # Using poetry
@@ -113,7 +117,7 @@ mkdir -p assets
 
 ### 3. Set up your base template
 
-Create or update your base template (e.g., `templates/base.html`):
+Create or update your base template (e.g. `templates/base.html`):
 
 ```html
 <!DOCTYPE html>
@@ -136,7 +140,7 @@ Create or update your base template (e.g., `templates/base.html`):
 ### 4. Start developing
 
 ```bash
-# Start Django's dev server with a parallel Tailwind watcher (recommended)
+# Start Django's dev server with a parallel Tailwind watcher
 python manage.py tailwind runserver
 
 # Or run build and watch separately
@@ -144,91 +148,52 @@ python manage.py tailwind watch  # In one terminal
 python manage.py runserver       # In another terminal
 ```
 
-The watcher runs under Django's own auto-reloader, so editing `settings.py` (e.g. adding a new app) restarts it automatically and picks up the new configuration on the fly. Pass `--noreload` to opt out.
-
-First run creates a managed `<BASE_DIR>/.django_tailwind_cli/` directory for the CLI binary and an auto-generated `source.css`. The directory is automatically git-ignored — no entry in your project-level `.gitignore` needed.
-
-> **Tip:** Prefer a guided walkthrough? Run `python manage.py tailwind setup` instead for an interactive step-by-step first-time setup.
-
-### 🎉 You're ready to go!
-
-Start adding Tailwind classes to your templates:
-
-```html
-{% extends "base.html" %}
-
-{% block content %}
-<div class="max-w-4xl mx-auto py-12">
-    <h1 class="text-4xl font-bold text-gray-900 mb-8">
-        Welcome to Django + Tailwind!
-    </h1>
-    <p class="text-lg text-gray-600">
-        This text is styled with Tailwind CSS.
-    </p>
-    <button class="bg-blue-500 hover:bg-blue-700 text-white font-bold py-2 px-4 rounded mt-4">
-        Click me!
-    </button>
-</div>
-{% endblock %}
-```
-
-📚 **Next Steps:** Check out the [full documentation](https://django-tailwind-cli.rtfd.io/) for advanced configuration and usage patterns.
-
-## 🎯 Core Features
+The watcher runs under Django's own auto-reloader, so editing `settings.py` (e.g. adding a new app)
+restarts it automatically and picks up the new configuration on the fly. Pass `--noreload` to opt
+out.
 
-### 🏗️ Build System
-- **Automatic CLI download** - No manual setup required
-- **Smart caching** - Faster rebuilds with file change detection
-- **Production optimization** - Automatic CSS purging and minification
-- **Force rebuild** - `--force` flag for clean builds
+First run creates a managed `<BASE_DIR>/.django_tailwind_cli/` directory for the CLI binary and an
+auto-generated `source.css`. The directory is automatically git-ignored — no entry in your
+project-level `.gitignore` needed.
 
-### 🔧 Development Tools
-- **Interactive setup** - `python manage.py tailwind setup`
-- **Configuration viewer** - `python manage.py tailwind config`
-- **Troubleshooting guide** - `python manage.py tailwind troubleshoot`
+`python manage.py tailwind setup` walks the same ground: it checks each piece in order, stops at
+the first one that is missing with instructions, and performs the download and first build when
+they are needed.
 
-### 🎨 Styling Features
-- **Tailwind CSS 4.x** - Latest features and performance improvements
-- **DaisyUI integration** - Pre-built components via [tailwindcss-cli-extra](https://github.com/dobicinaitis/tailwind-cli-extra)
-- **Custom CSS support** - Bring your own styles and configurations
-- **Template tag** - Simple `{% tailwind_css %}` inclusion
-
-### ⚡ Performance
-- **File change detection** - Only rebuild when necessary
-- **Concurrent processing** - Parallel build and server processes
-- **Progress indicators** - Visual feedback during downloads and builds
-- **Verbose logging** - Detailed diagnostics with `--verbose`
-
-### 🛠️ Management Commands
+## Management commands
 
 | Command        | Purpose                                              | Example                                  |
 | -------------- | ---------------------------------------------------- | ---------------------------------------- |
-| `setup`        | Interactive first-time setup guide                   | `python manage.py tailwind setup`        |
+| `setup`        | Guided first-time setup and checks                   | `python manage.py tailwind setup`        |
 | `build`        | Production CSS build                                 | `python manage.py tailwind build`        |
 | `watch`        | Development file watcher (Django autoreload by default) | `python manage.py tailwind watch`    |
 | `runserver`    | Django dev server + watcher (forwards any runserver flag) | `python manage.py tailwind runserver` |
 | `config`       | Show current configuration                           | `python manage.py tailwind config`       |
 | `troubleshoot` | Debug common issues                                  | `python manage.py tailwind troubleshoot` |
 
-`tailwind runserver` is a transparent passthrough: every positional argument and option (apart from `--force-default-runserver`) is forwarded verbatim to the underlying `runserver` or `runserver_plus`. Every flag those commands accept works — including `runserver_plus`-only ones like `--extra-file`, `--reloader-interval`, and `--print-sql`.
+`build` takes `--force` to rebuild regardless of change detection; `build` and `watch` both take
+`--verbose` for detailed diagnostics.
+
+`tailwind runserver` is a transparent passthrough: every positional argument and option (apart from
+`--force-default-runserver`) is forwarded verbatim to the underlying `runserver` or
+`runserver_plus`. Every flag those commands accept works — including `runserver_plus`-only ones like
+`--extra-file`, `--reloader-interval`, and `--print-sql`.
 
-## 📋 Requirements
+## Requirements
 
 - **Python:** 3.10+
-- **Django:** 4.2 LTS, 5.2, or 6.0
+- **Django:** 4.2 LTS, 5.2, 6.0, or 6.1
 - **Platform:** Windows, macOS, Linux (automatic platform detection)
 
-## ⚙️ Configuration Examples
+## Configuration
 
-### Basic Configuration
-```python
-# settings.py
-STATICFILES_DIRS = [BASE_DIR / "assets"]
-```
+Beyond adding the app to `INSTALLED_APPS`, `STATICFILES_DIRS` is the only setting you have to
+configure. Everything below is optional; see the
+[settings reference](https://django-tailwind-cli.readthedocs.io/latest/settings.html) for the full
+list.
 
-### Advanced Configuration
 ```python
-# Pin specific Tailwind version
+# Pin a specific Tailwind version instead of tracking the latest release
 TAILWIND_CLI_VERSION = "4.1.3"
 
 # Custom CSS paths
@@ -245,130 +210,96 @@ TAILWIND_CLI_USE_SYSTEM_BINARY = True
 TAILWIND_CLI_AUTO_SOURCE_EXTERNAL_APPS = True
 ```
 
-### Production Settings
+For production, pin the version and provide the binary yourself rather than downloading it during a
+build:
+
 ```python
-# Optimized for production
-TAILWIND_CLI_VERSION = "4.1.3"  # Pin version
-TAILWIND_CLI_AUTOMATIC_DOWNLOAD = False  # Use pre-installed CLI
+TAILWIND_CLI_VERSION = "4.1.3"
+TAILWIND_CLI_AUTOMATIC_DOWNLOAD = False
+TAILWIND_CLI_PATH = "/usr/local/bin/tailwindcss"  # where your binary actually is
 TAILWIND_CLI_DIST_CSS = "css/tailwind.min.css"
 ```
 
-## 🔍 Troubleshooting
+## DaisyUI
+
+Setting `TAILWIND_CLI_USE_DAISY_UI = True` switches to the DaisyUI-enabled CLI build, which makes
+its component classes available:
+
+```html
+<button class="btn btn-primary">Primary Button</button>
+<div class="card bg-base-100 shadow-xl">
+    <div class="card-body">
+        <h2 class="card-title">Card Title</h2>
+        <p>Card content goes here.</p>
+    </div>
+</div>
+```
 
-### Common Issues
+## Troubleshooting
 
 **CSS not updating?**
+
 ```bash
 python manage.py tailwind build --force
 python manage.py tailwind troubleshoot
 ```
 
 **Configuration problems?**
+
 ```bash
 python manage.py tailwind config
 python manage.py tailwind setup
 ```
 
-**Missing templates?**
-Make sure every template directory is covered by an `@source` directive in your
-Tailwind CSS input file — Tailwind CSS 4.x discovers templates exclusively
-through those directives.
+**Classes from some templates are missing?**
 
-### Performance Tips
+Make sure every template directory is covered by an `@source` directive in your Tailwind CSS input
+file — Tailwind CSS 4.x discovers templates exclusively through those directives. Declaring them
+explicitly also keeps builds fast, because Tailwind only scans what you list.
 
-1. **Use file watching:** `python manage.py tailwind runserver` for automatic rebuilds
-2. **Declare template sources explicitly:** Use `@source` directives in your CSS so Tailwind only scans what you need
-3. **Optimize builds:** Use `--force` only when necessary
-4. **Monitor file changes:** Use `--verbose` for detailed logging
+## Documentation and related projects
 
-## 🎨 DaisyUI Integration
+- [Full documentation](https://django-tailwind-cli.rtfd.io/)
+- [Tailwind CSS documentation](https://tailwindcss.com)
+- [DaisyUI components](https://daisyui.com)
+- [tailwindcss-cli-extra](https://github.com/dobicinaitis/tailwind-cli-extra) — the DaisyUI-enabled CLI build
+- [Django Extensions](https://django-extensions.readthedocs.io/) — provides `runserver_plus`
+- [Tailwind CSS IntelliSense](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss) — VS Code extension
+- [Django Commons](https://github.com/django-commons)
 
-Enable beautiful pre-built components:
+## Contributing
 
-```python
-# settings.py
-TAILWIND_CLI_USE_DAISY_UI = True
-```
-
-```html
-<!-- Use DaisyUI components -->
-<button class="btn btn-primary">Primary Button</button>
-<div class="card bg-base-100 shadow-xl">
-    <div class="card-body">
-        <h2 class="card-title">Card Title</h2>
-        <p>Card content goes here.</p>
-    </div>
-</div>
-```
-
-## 📚 Documentation & Resources
-
-- **📖 Full Documentation:** [django-tailwind-cli.rtfd.io](https://django-tailwind-cli.rtfd.io/)
-- **🎯 Tailwind CSS Docs:** [tailwindcss.com](https://tailwindcss.com)
-- **🧩 DaisyUI Components:** [daisyui.com](https://daisyui.com)
-- **💬 Django Commons:** [github.com/django-commons](https://github.com/django-commons)
-
-## 🔗 Related Projects
-
-- **tailwindcss-cli-extra:** [DaisyUI-enabled CLI](https://github.com/dobicinaitis/tailwind-cli-extra)
-- **Django Extensions:** [Extended runserver features](https://django-extensions.readthedocs.io/)
-- **Tailwind CSS IntelliSense:** [VS Code extension](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss)
-
-## 🤝 Contributing
-
-We welcome contributions! This project uses modern Python tooling for development.
+Contributions are welcome.
 
 ### Prerequisites
 
-- **[uv](https://docs.astral.sh/uv/)** - Fast Python package manager
-- **[just](https://github.com/casey/just)** - Command runner (optional but recommended)
+- **[mise](https://mise.jdx.dev/)** — provisions Python 3.10–3.15, `uv`, and `pre-commit` from `mise.toml`
 
-### Quick Development Setup
+### Development setup
 
 ```bash
-# Clone the repository
 git clone https://github.com/django-commons/django-tailwind-cli.git
 cd django-tailwind-cli
 
-# Setup development environment (with just)
-just bootstrap
-
-# Or setup manually with uv
-uv venv
-uv sync --all-extras
+mise install
+mise run bootstrap
 ```
 
-### Development Commands
+### Development commands
 
 ```bash
-# With just (recommended)
-just upgrade          # Update dependencies
-just lint             # Run linting and formatting
-just test             # Run test suite
-just test-all         # Run tests across Python/Django versions
-
-# Without just
-uv sync --all-extras  # Update dependencies
-uvx pre-commit run --all-files  # Run linting
-uv run pytest        # Run tests
-uvx --with tox-uv tox # Run full test matrix
+mise run upgrade      # Update dependencies
+mise run lint         # Run linting and formatting
+mise run test         # Run test suite
+mise run test-all     # Run tests across Python/Django versions
 ```
 
-### Contribution Guidelines
-
-1. **🍴 Fork** the repository
-2. **🌿 Create** a feature branch (`git checkout -b feature/amazing-feature`)
-3. **✅ Test** your changes (`just test`)
-4. **📝 Commit** with conventional commits (`feat:`, `fix:`, `docs:`, etc.)
-5. **📤 Push** to your branch (`git push origin feature/amazing-feature`)
-6. **🔄 Create** a Pull Request
-
-### Code Quality
+### Guidelines
 
-- **Type hints** for all new code
-- **Tests** for new features and bug fixes
-- **Documentation** updates for user-facing changes
-- **Conventional commits** for clear history
+Fork the repository and work on a feature branch. Please add type hints and tests for new code,
+update the documentation for user-facing changes, and use
+[conventional commits](https://www.conventionalcommits.org/) (`feat:`, `fix:`, `docs:`, …) so the
+history stays readable. Run `mise run test` before opening a pull request.
 
 ## License