django-tailwind-cli 4.8.0__tar.gz → 4.8.2__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/.github/workflows/release.yml +8 -8
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/.github/workflows/test.yml +10 -10
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/.pre-commit-config.yaml +5 -5
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/CHANGELOG.md +21 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/CONTRIBUTING.md +19 -20
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/PKG-INFO +33 -128
- django_tailwind_cli-4.8.2/README.md +135 -0
- django_tailwind_cli-4.8.2/docs/installation.md +131 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/docs/settings.md +9 -5
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/docs/template_tags.md +5 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/docs/usage.md +2 -2
- django_tailwind_cli-4.8.2/docs/workflow.md +180 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/mise.toml +5 -7
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/config.py +51 -236
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/management/commands/_build.py +4 -30
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/management/commands/_download.py +0 -3
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/management/commands/_guides.py +8 -35
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/management/commands/_process.py +0 -2
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/management/commands/tailwind.py +11 -63
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/templatetags/tailwind_cli.py +4 -4
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/utils/http.py +33 -29
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/tests/test_config.py +2 -2
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/tests/test_error_scenarios.py +19 -92
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/tests/test_http.py +97 -1
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/tests/test_integration.py +62 -67
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/tests/test_management_commands.py +8 -4
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/tests/test_tailwind_css_tag.py +106 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/uv.lock +11 -11
- django_tailwind_cli-4.8.0/README.md +0 -230
- django_tailwind_cli-4.8.0/docs/installation.md +0 -136
- django_tailwind_cli-4.8.0/docs/workflow.md +0 -160
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/.github/dependabot.yml +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/.gitignore +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/.mise/tasks/dev +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/.readthedocs.yml +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/CODE_OF_CONDUCT.md +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/LICENSE +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/docs/base_template.md +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/docs/changelog.md +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/docs/conf.py +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/docs/contributing.md +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/docs/index.md +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/docs/requirements.txt +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/docs/whitenoise.md +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/pyproject.toml +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/__init__.py +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/apps.py +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/checks.py +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/management/__init__.py +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/management/commands/__init__.py +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/management/commands/_errors.py +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/management/commands/_group.py +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/management/commands/_source_css.py +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/py.typed +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/templates/tailwind_cli/base.html +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/templates/tailwind_cli/tailwind_css.html +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/templatetags/__init__.py +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/src/django_tailwind_cli/utils/__init__.py +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/tests/.gitignore +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/tests/__init__.py +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/tests/assets/css/.gitkeep +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/tests/assets/css/tailwind.css +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/tests/conftest.py +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/tests/helpers.py +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/tests/settings.py +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/tests/templates/tests/base.html +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/tests/templates/tests/dummy.email +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/tests/test_additional_commands.py +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/tests/test_checks.py +0 -0
- {django_tailwind_cli-4.8.0 → django_tailwind_cli-4.8.2}/tox.ini +0 -0
|
@@ -34,7 +34,7 @@ jobs:
|
|
|
34
34
|
- name: Build a binary wheel and a source tarball
|
|
35
35
|
run: python3 -m build
|
|
36
36
|
- name: Store the distribution packages
|
|
37
|
-
uses: actions/upload-artifact@
|
|
37
|
+
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7
|
|
38
38
|
with:
|
|
39
39
|
name: python-package-distributions
|
|
40
40
|
path: dist/
|
|
@@ -58,7 +58,7 @@ jobs:
|
|
|
58
58
|
cat release-notes.md
|
|
59
59
|
- name: Upload release notes
|
|
60
60
|
if: startsWith(github.ref, 'refs/tags/')
|
|
61
|
-
uses: actions/upload-artifact@
|
|
61
|
+
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7
|
|
62
62
|
with:
|
|
63
63
|
name: release-notes
|
|
64
64
|
path: release-notes.md
|
|
@@ -80,12 +80,12 @@ jobs:
|
|
|
80
80
|
id-token: write # IMPORTANT: mandatory for trusted publishing
|
|
81
81
|
steps:
|
|
82
82
|
- name: Download all the dists
|
|
83
|
-
uses: actions/download-artifact@
|
|
83
|
+
uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8
|
|
84
84
|
with:
|
|
85
85
|
name: python-package-distributions
|
|
86
86
|
path: dist/
|
|
87
87
|
- name: Publish distribution 📦 to PyPI
|
|
88
|
-
uses: pypa/gh-action-pypi-publish@
|
|
88
|
+
uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # v1.14.3
|
|
89
89
|
|
|
90
90
|
github-release:
|
|
91
91
|
name: >-
|
|
@@ -101,12 +101,12 @@ jobs:
|
|
|
101
101
|
|
|
102
102
|
steps:
|
|
103
103
|
- name: Download all the dists
|
|
104
|
-
uses: actions/download-artifact@
|
|
104
|
+
uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8
|
|
105
105
|
with:
|
|
106
106
|
name: python-package-distributions
|
|
107
107
|
path: dist/
|
|
108
108
|
- name: Download release notes
|
|
109
|
-
uses: actions/download-artifact@
|
|
109
|
+
uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8
|
|
110
110
|
with:
|
|
111
111
|
name: release-notes
|
|
112
112
|
- name: Sign the dists with Sigstore
|
|
@@ -154,12 +154,12 @@ jobs:
|
|
|
154
154
|
|
|
155
155
|
steps:
|
|
156
156
|
- name: Download all the dists
|
|
157
|
-
uses: actions/download-artifact@
|
|
157
|
+
uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8
|
|
158
158
|
with:
|
|
159
159
|
name: python-package-distributions
|
|
160
160
|
path: dist/
|
|
161
161
|
- name: Publish distribution 📦 to TestPyPI
|
|
162
|
-
uses: pypa/gh-action-pypi-publish@
|
|
162
|
+
uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # v1.14.3
|
|
163
163
|
with:
|
|
164
164
|
repository-url: https://test.pypi.org/legacy/
|
|
165
165
|
skip-existing: true
|
|
@@ -18,10 +18,10 @@ jobs:
|
|
|
18
18
|
name: Lint
|
|
19
19
|
runs-on: ubuntu-latest
|
|
20
20
|
|
|
21
|
-
# pre-commit pins its hook environments to 3.
|
|
21
|
+
# pre-commit pins its hook environments to 3.13 (default_language_version),
|
|
22
22
|
# and the linters only ever need one interpreter.
|
|
23
23
|
env:
|
|
24
|
-
MISE_PYTHON_VERSION: "3.
|
|
24
|
+
MISE_PYTHON_VERSION: "3.13"
|
|
25
25
|
# tmux only exists for the optional `mise run dev` session, which CI never starts. Disabling
|
|
26
26
|
# beats limiting install_args, because `mise run` would auto-install it again.
|
|
27
27
|
MISE_DISABLE_TOOLS: tmux
|
|
@@ -32,7 +32,7 @@ jobs:
|
|
|
32
32
|
persist-credentials: false
|
|
33
33
|
|
|
34
34
|
- name: Set up mise
|
|
35
|
-
uses: jdx/mise-action@
|
|
35
|
+
uses: jdx/mise-action@9b200bcecbfd6303e69a4a261b2e09e3757440a7 # v5.2.0
|
|
36
36
|
with:
|
|
37
37
|
install: true
|
|
38
38
|
cache: true
|
|
@@ -61,11 +61,11 @@ jobs:
|
|
|
61
61
|
# which is why the original pre-commit job was dropped back in 2022.
|
|
62
62
|
# --locked, unlike `mise run bootstrap`: a uv.lock that has drifted from
|
|
63
63
|
# pyproject.toml should fail the job, not be silently re-resolved into
|
|
64
|
-
# something uv-
|
|
64
|
+
# something uv-audit then audits instead of the committed lock.
|
|
65
65
|
- name: Install dependencies
|
|
66
66
|
run: uv sync --all-extras --locked
|
|
67
67
|
|
|
68
|
-
# uv-
|
|
68
|
+
# uv-audit checks uv.lock against the published advisories, so a new one
|
|
69
69
|
# can turn an unrelated pull request red. That is deliberate: it is how we
|
|
70
70
|
# hear about it. Fix the lock rather than skipping the hook.
|
|
71
71
|
- name: Run pre-commit
|
|
@@ -79,7 +79,7 @@ jobs:
|
|
|
79
79
|
python-version: ["3.10", "3.11", "3.12", "3.13", "3.14", "3.15"]
|
|
80
80
|
|
|
81
81
|
# Job-scoped so every step resolves the same interpreter, not just the
|
|
82
|
-
# install step.
|
|
82
|
+
# install step.
|
|
83
83
|
env:
|
|
84
84
|
MISE_PYTHON_VERSION: ${{ matrix.python-version }}
|
|
85
85
|
# pre-commit too, unlike the lint job: this one never runs it.
|
|
@@ -91,7 +91,7 @@ jobs:
|
|
|
91
91
|
persist-credentials: false
|
|
92
92
|
|
|
93
93
|
- name: Set up mise
|
|
94
|
-
uses: jdx/mise-action@
|
|
94
|
+
uses: jdx/mise-action@9b200bcecbfd6303e69a4a261b2e09e3757440a7 # v5.2.0
|
|
95
95
|
with:
|
|
96
96
|
install: true
|
|
97
97
|
cache: true
|
|
@@ -126,7 +126,7 @@ jobs:
|
|
|
126
126
|
persist-credentials: false
|
|
127
127
|
|
|
128
128
|
- name: Set up mise
|
|
129
|
-
uses: jdx/mise-action@
|
|
129
|
+
uses: jdx/mise-action@9b200bcecbfd6303e69a4a261b2e09e3757440a7 # v5.2.0
|
|
130
130
|
with:
|
|
131
131
|
install: true
|
|
132
132
|
cache: true
|
|
@@ -162,7 +162,7 @@ jobs:
|
|
|
162
162
|
persist-credentials: false
|
|
163
163
|
|
|
164
164
|
- name: Set up mise
|
|
165
|
-
uses: jdx/mise-action@
|
|
165
|
+
uses: jdx/mise-action@9b200bcecbfd6303e69a4a261b2e09e3757440a7 # v5.2.0
|
|
166
166
|
with:
|
|
167
167
|
install: true
|
|
168
168
|
cache: true
|
|
@@ -190,4 +190,4 @@ jobs:
|
|
|
190
190
|
with:
|
|
191
191
|
persist-credentials: false
|
|
192
192
|
|
|
193
|
-
- uses: zizmorcore/zizmor-action@
|
|
193
|
+
- uses: zizmorcore/zizmor-action@85b2b9fb8e3325e7a23d7d0a9d7ba5ae0f999e3e # v0.7.1
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
default_language_version:
|
|
2
|
-
python: python3.
|
|
2
|
+
python: python3.13
|
|
3
3
|
|
|
4
4
|
repos:
|
|
5
5
|
- repo: https://github.com/pre-commit/pre-commit-hooks
|
|
@@ -39,11 +39,11 @@ repos:
|
|
|
39
39
|
- id: djade
|
|
40
40
|
args: [--target-version, "4.2"]
|
|
41
41
|
|
|
42
|
-
- repo: https://github.com/
|
|
43
|
-
rev: 0.
|
|
42
|
+
- repo: https://github.com/astral-sh/uv-pre-commit
|
|
43
|
+
rev: 0.13.6
|
|
44
44
|
hooks:
|
|
45
|
-
- id: uv-
|
|
46
|
-
|
|
45
|
+
- id: uv-audit
|
|
46
|
+
args: [--preview-features, audit-command]
|
|
47
47
|
|
|
48
48
|
- repo: https://github.com/DetachHead/basedpyright-pre-commit-mirror
|
|
49
49
|
rev: 1.39.0
|
|
@@ -1,5 +1,26 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 4.8.2 (2026-10-27)
|
|
4
|
+
|
|
5
|
+
### 🐛 Bug Fixes
|
|
6
|
+
- **`tailwind watch` with one stylesheet shows the watcher's output again.** It ran the CLI with its output captured, so rebuild messages and build errors never reached the terminal, and the captured text grew for as long as the watcher ran. Multiple stylesheets were not affected.
|
|
7
|
+
|
|
8
|
+
### 🛠️ Developer Experience
|
|
9
|
+
- **Python 3.15 is tested against the final release** instead of 3.15.0rc1.
|
|
10
|
+
- **`uv audit` replaces `uv-secure`** in the lint hooks. The `uv-secure` project is archived. `uv audit` checks `uv.lock` but not the installed uv binary.
|
|
11
|
+
|
|
12
|
+
## 4.8.1 (2026-09-18)
|
|
13
|
+
|
|
14
|
+
### 🐛 Bug Fixes
|
|
15
|
+
- **`tailwind build` always rebuilds every stylesheet.** Template changes, imported CSS and build options could previously leave stale output because only the source CSS timestamp was checked. `--force` remains accepted for compatibility but is no longer needed. The build step in `tailwind setup` also always runs.
|
|
16
|
+
- **`{% tailwind_css %}` resolves only stylesheet paths.** Rendering no longer looks up Tailwind releases or searches for a CLI binary, so serving prebuilt CSS does not require a Tailwind installation. CSS configuration errors are still reported; CLI settings are validated by management commands.
|
|
17
|
+
- **Failed CLI downloads leave an existing binary intact.** Downloads are staged on the destination filesystem and replace the binary only after a successful transfer. A mismatch with the advertised `Content-Length` now fails instead of installing an incomplete file; responses without that header remain supported.
|
|
18
|
+
|
|
19
|
+
### 📚 Documentation
|
|
20
|
+
- Clarified contribution expectations around focused submissions, actionable reports, contributor responsibility and variable review times.
|
|
21
|
+
- Reorganized the README into a working quickstart, the installation guide into setup and optional integrations, and the workflow guide into recurring tasks and troubleshooting.
|
|
22
|
+
- **Source detection guidance corrected:** Tailwind scans automatically by default; `@source` adds paths. Documentation and command guides now explain when to add external sources and how `source(none)` limits scanning to explicit sources.
|
|
23
|
+
|
|
3
24
|
## 4.8.0 (2026-08-30)
|
|
4
25
|
|
|
5
26
|
### 💥 Dependencies
|
|
@@ -6,23 +6,22 @@ follows the
|
|
|
6
6
|
|
|
7
7
|
## Before you open an issue or a pull request
|
|
8
8
|
|
|
9
|
-
This project is maintained in spare time.
|
|
10
|
-
the
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
- **
|
|
18
|
-
|
|
19
|
-
- **
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
If you are unsure whether something warrants an issue, ask first: open a
|
|
9
|
+
This project is maintained in spare time. Response and review times depend on the available
|
|
10
|
+
capacity and the scope of the work; a quick response to one submission does not set a timeline
|
|
11
|
+
for others.
|
|
12
|
+
|
|
13
|
+
- **Keep submissions focused.** Use one topic per issue and one change per pull request. Submit
|
|
14
|
+
unrelated changes separately so each can be reviewed on its own.
|
|
15
|
+
- **Make reports actionable.** Describe what you did, what you expected, and what happened instead.
|
|
16
|
+
Include reproduction steps and relevant diagnostics so the problem can be investigated.
|
|
17
|
+
- **Review and understand your contribution.** You are responsible for what you submit, including
|
|
18
|
+
work produced with assistance. Check it before submitting and be prepared to explain each change.
|
|
19
|
+
- **Use a specific subject line.** Name the affected command or feature and describe the problem
|
|
20
|
+
or proposed change.
|
|
21
|
+
|
|
22
|
+
For questions about scope or direction, open a
|
|
24
23
|
[discussion](https://github.com/django-commons/django-tailwind-cli/discussions) or mail
|
|
25
|
-
<oliver@andrich.me
|
|
24
|
+
<oliver@andrich.me> before starting substantial work.
|
|
26
25
|
|
|
27
26
|
## Reporting a bug
|
|
28
27
|
|
|
@@ -56,14 +55,14 @@ mise run bootstrap
|
|
|
56
55
|
```bash
|
|
57
56
|
mise run test # pytest with coverage on the default interpreter
|
|
58
57
|
mise run test-all # the full Python/Django matrix via tox
|
|
59
|
-
mise run lint # pre-commit: ruff, basedpyright, uv-
|
|
58
|
+
mise run lint # pre-commit: ruff, basedpyright, uv-audit, upgrade hooks
|
|
60
59
|
```
|
|
61
60
|
|
|
62
61
|
`mise run test` and `mise run lint` both have to pass before a pull request is ready. `test-all`
|
|
63
62
|
takes a while; CI runs the matrix on every pull request, so running it locally is optional unless
|
|
64
63
|
you are touching something version-specific.
|
|
65
64
|
|
|
66
|
-
One of the lint hooks, `uv-
|
|
65
|
+
One of the lint hooks, `uv-audit`, checks the lock file against published security advisories. If
|
|
67
66
|
it fails on a dependency your change never touched, a new advisory appeared and the lock needs a
|
|
68
67
|
bump — mention it in the pull request instead of working around it.
|
|
69
68
|
|
|
@@ -98,7 +97,7 @@ Use the scope that names the area you touched. `config`, `management`, `build`,
|
|
|
98
97
|
`runserver`, `download`, `http`, `docs`, `tests`, `ci`, and `deps` are the common ones; `git log`
|
|
99
98
|
shows the rest.
|
|
100
99
|
|
|
101
|
-
Keep the message short — a title plus one or two sentences on the
|
|
100
|
+
Keep the message short — a title plus one or two sentences on the _why_. The diff already shows
|
|
102
101
|
what changed, and test counts or coverage numbers belong in the pull request, not in the history.
|
|
103
102
|
|
|
104
103
|
Commit under your own name and without bot co-author trailers. Whatever tools you used, the change
|
|
@@ -118,7 +117,7 @@ Tailwind 4.x, and the major only moves when Tailwind's does. A change that would
|
|
|
118
117
|
elsewhere under semver — a dropped dependency, a different exit code — goes into a minor here and
|
|
119
118
|
is called out in the changelog instead.
|
|
120
119
|
|
|
121
|
-
Releasing is a tag. `[tool.hatch.version]` reads the version from git, so `v4.8.0`
|
|
120
|
+
Releasing is a tag. `[tool.hatch.version]` reads the version from git, so `v4.8.0` _is_ the
|
|
122
121
|
version. Pushing the tag starts the release rather than finishing it: the workflow builds, uploads
|
|
123
122
|
to TestPyPI, and then waits — the `pypi` environment requires a reviewer, so PyPI publishing needs
|
|
124
123
|
an admin to approve it in the GitHub UI. Do not push a tag and walk away.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: django-tailwind-cli
|
|
3
|
-
Version: 4.8.
|
|
3
|
+
Version: 4.8.2
|
|
4
4
|
Summary: Django and Tailwind integration based on the prebuilt Tailwind CSS CLI.
|
|
5
5
|
Project-URL: Home, https://django-tailwind-cli.rtfd.io/
|
|
6
6
|
Project-URL: Documentation, https://django-tailwind-cli.rtfd.io/
|
|
@@ -58,30 +58,20 @@ follows the approach of the [Tailwind integration for Phoenix](https://github.co
|
|
|
58
58
|
|
|
59
59
|
- Downloads and manages the Tailwind CLI binary for your platform
|
|
60
60
|
- Rebuilds CSS on change, running under Django's own auto-reloader
|
|
61
|
-
- Produces minified production builds containing only the classes you use
|
|
62
|
-
nothing changed
|
|
61
|
+
- Produces minified production builds containing only the classes you use
|
|
63
62
|
- Includes the CSS via a `{% tailwind_css %}` template tag
|
|
64
63
|
- Supports [DaisyUI](https://daisyui.com) through [tailwindcss-cli-extra](https://github.com/dobicinaitis/tailwind-cli-extra)
|
|
65
64
|
- Targets Tailwind CSS 4.x
|
|
66
65
|
|
|
67
|
-
##
|
|
66
|
+
## Quickstart
|
|
68
67
|
|
|
69
|
-
|
|
68
|
+
In an existing Django project, install the package:
|
|
70
69
|
|
|
71
70
|
```bash
|
|
72
|
-
|
|
73
|
-
pip install django-tailwind-cli
|
|
74
|
-
|
|
75
|
-
# Using uv
|
|
76
|
-
uv add django-tailwind-cli
|
|
77
|
-
|
|
78
|
-
# Using poetry
|
|
79
|
-
poetry add django-tailwind-cli
|
|
71
|
+
python -m pip install django-tailwind-cli
|
|
80
72
|
```
|
|
81
73
|
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
Add to your `settings.py`:
|
|
74
|
+
Add the app and a static files directory to `settings.py`:
|
|
85
75
|
|
|
86
76
|
```python
|
|
87
77
|
INSTALLED_APPS = [
|
|
@@ -89,22 +79,20 @@ INSTALLED_APPS = [
|
|
|
89
79
|
"django_tailwind_cli",
|
|
90
80
|
]
|
|
91
81
|
|
|
92
|
-
# Configure static files directory — make sure it exists on disk,
|
|
93
|
-
# Django raises an error at startup if it does not.
|
|
94
82
|
STATICFILES_DIRS = [BASE_DIR / "assets"]
|
|
95
83
|
```
|
|
96
84
|
|
|
85
|
+
Create that directory before starting Django:
|
|
86
|
+
|
|
97
87
|
```bash
|
|
98
88
|
mkdir -p assets
|
|
99
89
|
```
|
|
100
90
|
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
Create or update your base template (e.g. `templates/base.html`):
|
|
91
|
+
Load the template tag in your base template and place it inside `<head>`:
|
|
104
92
|
|
|
105
|
-
```
|
|
106
|
-
<!DOCTYPE html>
|
|
93
|
+
```htmldjango
|
|
107
94
|
{% load tailwind_cli %}
|
|
95
|
+
<!DOCTYPE html>
|
|
108
96
|
<html lang="en">
|
|
109
97
|
<head>
|
|
110
98
|
<meta charset="UTF-8">
|
|
@@ -112,58 +100,32 @@ Create or update your base template (e.g. `templates/base.html`):
|
|
|
112
100
|
<title>My Django App</title>
|
|
113
101
|
{% tailwind_css %}
|
|
114
102
|
</head>
|
|
115
|
-
<body
|
|
116
|
-
|
|
117
|
-
{% block content %}{% endblock %}
|
|
118
|
-
</div>
|
|
103
|
+
<body>
|
|
104
|
+
{% block content %}{% endblock %}
|
|
119
105
|
</body>
|
|
120
106
|
</html>
|
|
121
107
|
```
|
|
122
108
|
|
|
123
|
-
|
|
109
|
+
Start Django and the Tailwind watcher together:
|
|
124
110
|
|
|
125
111
|
```bash
|
|
126
|
-
# Start Django's dev server with a parallel Tailwind watcher
|
|
127
112
|
python manage.py tailwind runserver
|
|
128
|
-
|
|
129
|
-
# Or run build and watch separately
|
|
130
|
-
python manage.py tailwind watch # In one terminal
|
|
131
|
-
python manage.py runserver # In another terminal
|
|
132
113
|
```
|
|
133
114
|
|
|
134
|
-
The
|
|
135
|
-
|
|
136
|
-
out.
|
|
137
|
-
|
|
138
|
-
First run creates a managed `<BASE_DIR>/.django_tailwind_cli/` directory for the CLI binary and an
|
|
139
|
-
auto-generated `source.css`. The directory is automatically git-ignored — no entry in your
|
|
140
|
-
project-level `.gitignore` needed.
|
|
141
|
-
|
|
142
|
-
`python manage.py tailwind setup` walks the same ground: it checks each piece in order, stops at
|
|
143
|
-
the first one that is missing with instructions, and performs the download and first build when
|
|
144
|
-
they are needed.
|
|
115
|
+
The first run downloads the CLI and creates the default source CSS. Add Tailwind classes to your
|
|
116
|
+
templates; the watcher rebuilds the stylesheet when you save them.
|
|
145
117
|
|
|
146
|
-
|
|
118
|
+
For a production build, run Tailwind before collecting static files:
|
|
147
119
|
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
| `watch` | Development file watcher (Django autoreload by default) | `python manage.py tailwind watch` |
|
|
153
|
-
| `runserver` | Django dev server + watcher (forwards any runserver flag) | `python manage.py tailwind runserver` |
|
|
154
|
-
| `config` | Show current configuration | `python manage.py tailwind config` |
|
|
155
|
-
| `troubleshoot` | Debug common issues | `python manage.py tailwind troubleshoot` |
|
|
156
|
-
| `optimize` | Performance tips for build and watch | `python manage.py tailwind optimize` |
|
|
157
|
-
| `download_cli` | Fetch the CLI binary without building | `python manage.py tailwind download_cli` |
|
|
158
|
-
| `remove_cli` | Delete the downloaded CLI binary | `python manage.py tailwind remove_cli` |
|
|
159
|
-
|
|
160
|
-
`build` takes `--force` to rebuild regardless of change detection; `build` and `watch` both take
|
|
161
|
-
`--verbose` for detailed diagnostics.
|
|
120
|
+
```bash
|
|
121
|
+
python manage.py tailwind build
|
|
122
|
+
python manage.py collectstatic --noinput
|
|
123
|
+
```
|
|
162
124
|
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
125
|
+
See the [installation guide](https://django-tailwind-cli.readthedocs.io/latest/installation.html)
|
|
126
|
+
for setup checks and optional integrations, and the
|
|
127
|
+
[workflow guide](https://django-tailwind-cli.readthedocs.io/latest/workflow.html)
|
|
128
|
+
for custom CSS, editor setup and troubleshooting.
|
|
167
129
|
|
|
168
130
|
## Requirements
|
|
169
131
|
|
|
@@ -171,78 +133,21 @@ they are needed.
|
|
|
171
133
|
- **Django:** 4.2 LTS, 5.2, 6.0, or 6.1
|
|
172
134
|
- **Platform:** Windows, macOS, Linux (automatic platform detection)
|
|
173
135
|
|
|
174
|
-
## Configuration
|
|
136
|
+
## Configuration and commands
|
|
175
137
|
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
[settings reference](https://django-tailwind-cli.readthedocs.io/latest/settings.html)
|
|
179
|
-
list.
|
|
180
|
-
|
|
181
|
-
```python
|
|
182
|
-
# Pin a specific Tailwind version instead of tracking the latest release
|
|
183
|
-
TAILWIND_CLI_VERSION = "4.1.3"
|
|
138
|
+
The defaults work with the setup above. Optional settings let you pin the Tailwind version,
|
|
139
|
+
use a system binary, add custom CSS, enable DaisyUI, or include editable-installed external apps.
|
|
140
|
+
See the [settings reference](https://django-tailwind-cli.readthedocs.io/latest/settings.html).
|
|
184
141
|
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
TAILWIND_CLI_DIST_CSS = "css/app.css"
|
|
188
|
-
|
|
189
|
-
# Enable DaisyUI
|
|
190
|
-
TAILWIND_CLI_USE_DAISY_UI = True
|
|
191
|
-
|
|
192
|
-
# Use an already-installed Tailwind binary (e.g. `brew install tailwindcss`)
|
|
193
|
-
TAILWIND_CLI_USE_SYSTEM_BINARY = True
|
|
194
|
-
|
|
195
|
-
# Auto-inject @source directives for editable-installed external apps (opt-in)
|
|
196
|
-
TAILWIND_CLI_AUTO_SOURCE_EXTERNAL_APPS = True
|
|
197
|
-
```
|
|
198
|
-
|
|
199
|
-
For production, pin the version and provide the binary yourself rather than downloading it during a
|
|
200
|
-
build:
|
|
201
|
-
|
|
202
|
-
```python
|
|
203
|
-
TAILWIND_CLI_VERSION = "4.1.3"
|
|
204
|
-
TAILWIND_CLI_AUTOMATIC_DOWNLOAD = False
|
|
205
|
-
TAILWIND_CLI_PATH = "/usr/local/bin/tailwindcss" # where your binary actually is
|
|
206
|
-
TAILWIND_CLI_DIST_CSS = "css/tailwind.min.css"
|
|
207
|
-
```
|
|
208
|
-
|
|
209
|
-
## DaisyUI
|
|
210
|
-
|
|
211
|
-
Setting `TAILWIND_CLI_USE_DAISY_UI = True` switches to the DaisyUI-enabled CLI build, which makes
|
|
212
|
-
its component classes available:
|
|
213
|
-
|
|
214
|
-
```html
|
|
215
|
-
<button class="btn btn-primary">Primary Button</button>
|
|
216
|
-
<div class="card bg-base-100 shadow-xl">
|
|
217
|
-
<div class="card-body">
|
|
218
|
-
<h2 class="card-title">Card Title</h2>
|
|
219
|
-
<p>Card content goes here.</p>
|
|
220
|
-
</div>
|
|
221
|
-
</div>
|
|
222
|
-
```
|
|
223
|
-
|
|
224
|
-
## Troubleshooting
|
|
225
|
-
|
|
226
|
-
**CSS not updating?**
|
|
227
|
-
|
|
228
|
-
```bash
|
|
229
|
-
python manage.py tailwind build --force
|
|
230
|
-
python manage.py tailwind troubleshoot
|
|
231
|
-
```
|
|
232
|
-
|
|
233
|
-
**Configuration problems?**
|
|
142
|
+
The [command reference](https://django-tailwind-cli.readthedocs.io/latest/usage.html) covers all
|
|
143
|
+
commands and options. To inspect your setup or investigate a build problem, start with:
|
|
234
144
|
|
|
235
145
|
```bash
|
|
236
146
|
python manage.py tailwind config
|
|
237
|
-
python manage.py tailwind
|
|
147
|
+
python manage.py tailwind build --verbose
|
|
148
|
+
python manage.py tailwind troubleshoot
|
|
238
149
|
```
|
|
239
150
|
|
|
240
|
-
**Classes from some templates are missing?**
|
|
241
|
-
|
|
242
|
-
Make sure every template directory is covered by an `@source` directive in your Tailwind CSS input
|
|
243
|
-
file — Tailwind CSS 4.x discovers templates exclusively through those directives. Declaring them
|
|
244
|
-
explicitly also keeps builds fast, because Tailwind only scans what you list.
|
|
245
|
-
|
|
246
151
|
## Documentation and related projects
|
|
247
152
|
|
|
248
153
|
- [Full documentation](https://django-tailwind-cli.rtfd.io/)
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
# django-tailwind-cli
|
|
2
|
+
|
|
3
|
+
<p style="display: flex; gap: 4px; flex-wrap: wrap; align-items: flex-start; line-height: 1;">
|
|
4
|
+
<img style="height: auto;" alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/django-commons/django-tailwind-cli/test.yml">
|
|
5
|
+
<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>
|
|
6
|
+
<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>
|
|
7
|
+
<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>
|
|
8
|
+
<img style="height: auto;" alt="GitHub" src="https://img.shields.io/github/license/django-commons/django-tailwind-cli">
|
|
9
|
+
<img style="height: auto;" alt="Django Versions" src="https://img.shields.io/pypi/frameworkversions/django/django-tailwind-cli">
|
|
10
|
+
<img style="height: auto;" alt="Python Versions" src="https://img.shields.io/pypi/pyversions/django-tailwind-cli">
|
|
11
|
+
<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>
|
|
12
|
+
<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>
|
|
13
|
+
</p>
|
|
14
|
+
|
|
15
|
+
[Tailwind CSS](https://tailwindcss.com) for Django without Node.js. The library downloads the
|
|
16
|
+
standalone [Tailwind CSS CLI](https://tailwindcss.com/blog/standalone-cli) and wires it into Django
|
|
17
|
+
management commands, so there is no npm, no webpack, and no separate build tool to configure. It
|
|
18
|
+
follows the approach of the [Tailwind integration for Phoenix](https://github.com/phoenixframework/tailwind).
|
|
19
|
+
|
|
20
|
+
## What it does
|
|
21
|
+
|
|
22
|
+
- Downloads and manages the Tailwind CLI binary for your platform
|
|
23
|
+
- Rebuilds CSS on change, running under Django's own auto-reloader
|
|
24
|
+
- Produces minified production builds containing only the classes you use
|
|
25
|
+
- Includes the CSS via a `{% tailwind_css %}` template tag
|
|
26
|
+
- Supports [DaisyUI](https://daisyui.com) through [tailwindcss-cli-extra](https://github.com/dobicinaitis/tailwind-cli-extra)
|
|
27
|
+
- Targets Tailwind CSS 4.x
|
|
28
|
+
|
|
29
|
+
## Quickstart
|
|
30
|
+
|
|
31
|
+
In an existing Django project, install the package:
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
python -m pip install django-tailwind-cli
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Add the app and a static files directory to `settings.py`:
|
|
38
|
+
|
|
39
|
+
```python
|
|
40
|
+
INSTALLED_APPS = [
|
|
41
|
+
# ... your other apps
|
|
42
|
+
"django_tailwind_cli",
|
|
43
|
+
]
|
|
44
|
+
|
|
45
|
+
STATICFILES_DIRS = [BASE_DIR / "assets"]
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Create that directory before starting Django:
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
mkdir -p assets
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
Load the template tag in your base template and place it inside `<head>`:
|
|
55
|
+
|
|
56
|
+
```htmldjango
|
|
57
|
+
{% load tailwind_cli %}
|
|
58
|
+
<!DOCTYPE html>
|
|
59
|
+
<html lang="en">
|
|
60
|
+
<head>
|
|
61
|
+
<meta charset="UTF-8">
|
|
62
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
63
|
+
<title>My Django App</title>
|
|
64
|
+
{% tailwind_css %}
|
|
65
|
+
</head>
|
|
66
|
+
<body>
|
|
67
|
+
{% block content %}{% endblock %}
|
|
68
|
+
</body>
|
|
69
|
+
</html>
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
Start Django and the Tailwind watcher together:
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
python manage.py tailwind runserver
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
The first run downloads the CLI and creates the default source CSS. Add Tailwind classes to your
|
|
79
|
+
templates; the watcher rebuilds the stylesheet when you save them.
|
|
80
|
+
|
|
81
|
+
For a production build, run Tailwind before collecting static files:
|
|
82
|
+
|
|
83
|
+
```bash
|
|
84
|
+
python manage.py tailwind build
|
|
85
|
+
python manage.py collectstatic --noinput
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
See the [installation guide](https://django-tailwind-cli.readthedocs.io/latest/installation.html)
|
|
89
|
+
for setup checks and optional integrations, and the
|
|
90
|
+
[workflow guide](https://django-tailwind-cli.readthedocs.io/latest/workflow.html)
|
|
91
|
+
for custom CSS, editor setup and troubleshooting.
|
|
92
|
+
|
|
93
|
+
## Requirements
|
|
94
|
+
|
|
95
|
+
- **Python:** 3.10+
|
|
96
|
+
- **Django:** 4.2 LTS, 5.2, 6.0, or 6.1
|
|
97
|
+
- **Platform:** Windows, macOS, Linux (automatic platform detection)
|
|
98
|
+
|
|
99
|
+
## Configuration and commands
|
|
100
|
+
|
|
101
|
+
The defaults work with the setup above. Optional settings let you pin the Tailwind version,
|
|
102
|
+
use a system binary, add custom CSS, enable DaisyUI, or include editable-installed external apps.
|
|
103
|
+
See the [settings reference](https://django-tailwind-cli.readthedocs.io/latest/settings.html).
|
|
104
|
+
|
|
105
|
+
The [command reference](https://django-tailwind-cli.readthedocs.io/latest/usage.html) covers all
|
|
106
|
+
commands and options. To inspect your setup or investigate a build problem, start with:
|
|
107
|
+
|
|
108
|
+
```bash
|
|
109
|
+
python manage.py tailwind config
|
|
110
|
+
python manage.py tailwind build --verbose
|
|
111
|
+
python manage.py tailwind troubleshoot
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
## Documentation and related projects
|
|
115
|
+
|
|
116
|
+
- [Full documentation](https://django-tailwind-cli.rtfd.io/)
|
|
117
|
+
- [Tailwind CSS documentation](https://tailwindcss.com)
|
|
118
|
+
- [DaisyUI components](https://daisyui.com)
|
|
119
|
+
- [tailwindcss-cli-extra](https://github.com/dobicinaitis/tailwind-cli-extra) — the DaisyUI-enabled CLI build
|
|
120
|
+
- [Django Extensions](https://django-extensions.readthedocs.io/) — provides `runserver_plus`
|
|
121
|
+
- [Tailwind CSS IntelliSense](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss) — VS Code extension
|
|
122
|
+
- [Django Commons](https://github.com/django-commons)
|
|
123
|
+
|
|
124
|
+
## Contributing
|
|
125
|
+
|
|
126
|
+
Contributions are welcome.
|
|
127
|
+
[CONTRIBUTING.md](https://github.com/django-commons/django-tailwind-cli/blob/main/CONTRIBUTING.md)
|
|
128
|
+
covers the development setup ([mise](https://mise.jdx.dev/) provisions Python, `uv`, and
|
|
129
|
+
`pre-commit`), how to run the tests, and what a pull request should look like. Please read the short
|
|
130
|
+
section at the top of it before opening an issue or a pull request — it explains what makes one easy
|
|
131
|
+
to act on.
|
|
132
|
+
|
|
133
|
+
## License
|
|
134
|
+
|
|
135
|
+
This software is licensed under [MIT license](https://github.com/django-commons/django-tailwind-cli/blob/main/LICENSE).
|