django-tailwind-cli 4.2.4__tar.gz → 4.4.0__tar.gz

{django_tailwind_cli-4.2.4 → django_tailwind_cli-4.4.0}/.github/workflows/release.yml

@@ -14,9 +14,9 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: "3.x"
     - name: Install pypa/build
@@ -44,12 +44,12 @@ jobs:
       id-token: write  # IMPORTANT: mandatory for trusted publishing
     steps:
     - name: Download all the dists
-      uses: actions/download-artifact@v4
+      uses: actions/download-artifact@v5
       with:
         name: python-package-distributions
         path: dist/
     - name: Publish distribution 📦 to PyPI
-      uses: pypa/gh-action-pypi-publish@release/v1.12
+      uses: pypa/gh-action-pypi-publish@release/v1.13
 
   github-release:
     name: >-
@@ -65,12 +65,12 @@ jobs:
 
     steps:
     - name: Download all the dists
-      uses: actions/download-artifact@v4
+      uses: actions/download-artifact@v5
       with:
         name: python-package-distributions
         path: dist/
     - name: Sign the dists with Sigstore
-      uses: sigstore/gh-action-sigstore-python@v3.0.0
+      uses: sigstore/gh-action-sigstore-python@v3.0.1
       with:
         inputs: >-
           ./dist/*.tar.gz
@@ -110,12 +110,12 @@ jobs:
 
     steps:
     - name: Download all the dists
-      uses: actions/download-artifact@v4
+      uses: actions/download-artifact@v5
       with:
         name: python-package-distributions
         path: dist/
     - name: Publish distribution 📦 to TestPyPI
-      uses: pypa/gh-action-pypi-publish@release/v1.12
+      uses: pypa/gh-action-pypi-publish@release/v1.13
       with:
         repository-url: https://test.pypi.org/legacy/
         skip-existing: true

{django_tailwind_cli-4.2.4 → django_tailwind_cli-4.4.0}/.github/workflows/test.yml

@@ -11,13 +11,13 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
           allow-prereleases: true

{django_tailwind_cli-4.2.4 → django_tailwind_cli-4.4.0}/.pre-commit-config.yaml

@@ -1,5 +1,5 @@
 default_language_version:
-  python: python3.9
+  python: python3.10
 
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
@@ -16,30 +16,35 @@ repos:
       - id: check-json
 
   - repo: https://github.com/charliermarsh/ruff-pre-commit
-    rev: "v0.11.2"
+    rev: "v0.12.3"
     hooks:
       - id: ruff
       - id: ruff-format
 
   - repo: https://github.com/asottile/pyupgrade
-    rev: v3.19.1
+    rev: v3.20.0
     hooks:
     - id: pyupgrade
-      args: [--py39-plus]
+      args: [--py310-plus]
 
   - repo: https://github.com/adamchainz/django-upgrade
-    rev: "1.23.1"
+    rev: "1.25.0"
     hooks:
     - id: django-upgrade
       args: [--target-version, "4.2"]
 
   - repo: https://github.com/adamchainz/djade-pre-commit
-    rev: "1.3.2"
+    rev: "1.4.0"
     hooks:
     -   id: djade
         args: [--target-version, "4.2"]
 
   - repo: https://github.com/owenlamont/uv-secure
-    rev: 0.9.0
+    rev: 0.11.1
     hooks:
       - id: uv-secure
+
+  - repo: https://github.com/RobertCraigie/pyright-python
+    rev: v1.1.403
+    hooks:
+    - id: pyright

{django_tailwind_cli-4.2.4 → django_tailwind_cli-4.4.0}/CHANGELOG.md

@@ -1,5 +1,55 @@
 # Changelog
 
+## Unreleased
+
+## 4.4.0 (2025-09-21)
+
+### 🔧 Technical Improvements
+- **Type safety**: Fixed all pyright typing errors for better code quality and maintainability
+- **Code cleanup**: Removed unused functions and improved type annotations throughout codebase
+- **Dependencies**: Removed requests dependency, replaced with custom HTTP implementation
+- **Exception handling**: Fixed exception naming to follow Python conventions and avoid builtin shadowing
+- **Test coverage**: Added comprehensive HTTP module tests, improving coverage from 82% to 85%
+- **Error handling**: Complete test coverage for network timeouts, connection errors, and edge cases
+- **VS Code integration**: Added PyLance ignore comments for test files accessing private methods
+- **Django 6.0 support**: Added Django 6.0 to testing matrix and version compatibility
+
+## 4.3.0 (2025-07-12)
+
+### 🎯 New Features
+- **Interactive setup command**: `python manage.py tailwind setup` for guided configuration
+- **Configuration viewer**: `python manage.py tailwind config` to inspect current settings
+- **Troubleshooting guide**: `python manage.py tailwind troubleshoot` for common issues
+- **Performance tips**: `python manage.py tailwind optimize` for optimization guidance
+- **Enhanced verbose mode**: `--verbose` flag for detailed build and watch diagnostics
+
+### ⚡ Performance Improvements
+- **Smart rebuilds**: File modification checks prevent unnecessary CSS rebuilds
+- **Version caching**: 1-hour cache reduces GitHub API requests
+- **Process optimization**: Improved `tailwind runserver` with better signal handling
+- **File operations**: Optimized I/O with caching and content comparison
+
+### 🛠️ Developer Experience
+- **Better error messages**: Actionable solutions for configuration and system issues
+- **Colorized output**: Visual feedback with emojis and progress indicators
+- **Help text improvements**: Detailed examples and use cases for all commands
+- **Template scanning**: Enhanced discovery with error handling and performance metrics
+
+### 📚 Documentation & Resources
+- **Comprehensive README**: Step-by-step quick start and feature overview
+- **Advanced guides**: CONFIGURATION.md and DEVELOPMENT.md for production deployments
+- **Inline documentation**: Detailed docstrings and usage examples throughout codebase
+
+### 🧪 Quality Assurance
+- **Comprehensive testing**: 58+ new tests covering integration workflows and error scenarios
+- **Cross-platform support**: Windows, macOS, and Linux compatibility testing
+- **89% test coverage**: Robust validation of all major functionality
+
+### 🔧 Technical Improvements
+- **Python 3.10+ minimum**: Updated supported Python versions to 3.10-3.14
+- **Refactored internals**: Better maintainability with focused, single-responsibility functions
+- **Type safety**: Improved with `PlatformInfo` and `VersionCache` data structures
+
 ## 4.2.4
 
 - Merged pull request [#161](https://github.com/django-commons/django-tailwind-cli/pull/161) by [@adamghill](https://github.com/adamghill) which fixed the [prefix handling for staticfiles diretories](https://docs.djangoproject.com/en/5.2/ref/settings/#prefixes-optional).

django_tailwind_cli-4.4.0/CLAUDE.md

@@ -0,0 +1,212 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+`django-tailwind-cli` is a Django package that provides seamless integration between Django and Tailwind CSS 4.x using the precompiled Tailwind CSS CLI, eliminating the need for Node.js.
+
+## Development Setup and Commands
+
+### Required Tools
+- Python 3.10-3.14
+- [uv](https://docs.astral.sh/uv/) - Modern Python package manager
+- [just](https://github.com/casey/just) - Command runner (optional but recommended)
+
+### Common Development Commands
+
+```bash
+# Setup development environment
+just bootstrap
+
+# Install/upgrade dependencies
+just upgrade
+
+# Run linting and formatting
+just lint
+
+# Run tests
+just test          # Run pytest with coverage
+just test-all      # Run full test matrix with tox
+
+# Documentation
+just serve-docs    # Serve docs locally with mkdocs
+```
+
+### Without `just` (using uv directly)
+```bash
+# Create virtual environment
+uv venv
+
+# Install all dependencies
+uv sync --all-extras
+
+# Run tests
+uv run pytest
+
+# Run tox test matrix
+uvx --with tox-uv tox
+
+# Run linting
+uvx --with pre-commit-uv pre-commit run --all-files
+```
+
+## Code Architecture
+
+### Package Structure
+```
+src/django_tailwind_cli/
+├── apps.py                     # Django app configuration
+├── config.py                   # Central configuration (Config class)
+├── management/commands/        # Django management commands
+│   └── tailwind.py            # Main command: build, watch, runserver
+├── templates/tailwind_cli/     # Template files
+├── templatetags/              # Template tags ({% tailwind_css %})
+└── utils/                     # Utility modules for CLI download, etc.
+```
+
+### Key Components
+
+1. **Configuration System** (`config.py`):
+   - `Config` class centralizes all settings
+   - Reads from Django settings with sensible defaults
+   - Handles CLI paths, CSS paths, and command configurations
+
+2. **Management Commands** (`management/commands/tailwind.py`):
+   - `tailwind build`: Production CSS build
+   - `tailwind watch`: Development mode with auto-rebuild
+   - `tailwind runserver`: Combined Django runserver + Tailwind watch
+
+3. **Template Integration**:
+   - `{% load tailwind_cli %}` - Load template tags
+   - `{% tailwind_css %}` - Include CSS in templates
+   - Base template provided at `tailwind_cli/base.html`
+
+4. **CLI Management**:
+   - Automatic download of Tailwind CSS CLI binaries
+   - Support for custom CLI paths
+   - Platform-specific binary selection
+
+## Testing
+
+The project uses pytest with Django integration:
+- Test files in `tests/` directory
+- Configuration in `tests/settings.py`
+- Run with coverage: `uv run pytest --cov`
+- Full matrix testing: `uvx --with tox-uv tox`
+
+## Important Settings
+
+Key Django settings for configuration:
+- `TAILWIND_CLI_PATH`: Custom path to Tailwind CLI
+- `TAILWIND_CSS_PATH`: Output CSS file location
+- `TAILWIND_CONFIG_FILE`: Path to tailwind.config.js
+- `STATICFILES_DIRS`: Must be configured for asset collection
+
+## Development Workflow
+
+1. Make changes to the code
+2. Run `just lint` to check formatting and linting
+3. Run `just test` to ensure tests pass
+4. For multi-version testing, run `just test-all`
+5. Update documentation if needed
+
+## Version Support
+
+- Python: 3.10-3.14
+- Django: 4.0-6.0
+- Tailwind CSS: 4.x only (use v2.21.1 for Tailwind 3.x)
+
+## Commit Message Guidelines
+
+**⚠️ CRITICAL REQUIREMENT: NO CLAUDE REFERENCES**
+- **NEVER include any Claude Code references, marketing info, or AI-generated footers in commit messages**
+- **NEVER add "Generated with Claude Code", "Co-Authored-By: Claude", or any similar lines**
+- **Commit messages must be completely clean and professional - no AI tool attribution whatsoever**
+- **This is a strict project requirement and violations will require commit message rewrites**
+
+Use conventional commit format with the following structure:
+
+```
+type(scope): brief description
+
+- Bullet point describing key change
+- Another bullet point for significant addition
+- Additional points as needed
+```
+
+### Commit Types
+- **feat**: New feature
+- **fix**: Bug fix
+- **docs**: Documentation changes
+- **style**: Code style changes (formatting, missing semicolons, etc.)
+- **refactor**: Code refactoring without changing functionality
+- **test**: Adding or modifying tests
+- **chore**: Maintenance tasks (deps updates, build changes, etc.)
+- **ci**: CI/CD configuration changes
+- **perf**: Performance improvements
+
+### Project Scopes
+- **config**: Configuration handling (config.py)
+- **management**: Management commands
+- **templatetags**: Template tags functionality
+- **templates**: HTML template files
+- **build**: Build command functionality
+- **watch**: Watch mode functionality
+- **runserver**: Development server integration
+- **download**: CLI download functionality
+- **deps**: Dependencies
+- **ci**: Continuous integration
+- **docs**: Documentation
+- **tests**: Test suite
+- **daisyui**: DaisyUI integration
+- **staticfiles**: Static files handling
+
+### Example Commits
+```
+feat(management): add purge command for cleaning CSS
+
+- Add new purge subcommand to remove unused styles
+- Support custom purge configuration
+- Integrate with existing build process
+
+fix(config): handle prefixed staticfile directories
+
+- Correctly resolve paths when STATIC_URL has prefix
+- Add validation for malformed configurations
+
+chore(deps): bump django-typer to 2.1.2
+
+- Update minimum version for security fix
+- Adjust type hints for new API
+```
+
+### Important Notes
+- Keep commit messages focused on the technical changes made
+- Use bullet points to describe key modifications and their impact
+- Follow conventional commit format consistently
+- Be concise but descriptive about what changed and why
+
+## Changelog Requirements
+
+**IMPORTANT**: Every time you are asked to commit changes, you MUST also update the CHANGELOG.md file:
+
+1. **Update CHANGELOG.md**: Add a compact entry under the "## Unreleased" section describing the changes
+2. **Format**: Use the existing changelog format with appropriate categories:
+   - 🎯 **New Features**: For new functionality
+   - ⚡ **Performance Improvements**: For optimization changes
+   - 🛠️ **Developer Experience**: For DX improvements
+   - 🔧 **Technical Improvements**: For internal code improvements
+   - 🐛 **Bug Fixes**: For fixes
+   - 📚 **Documentation**: For docs changes
+3. **Keep it concise**: One or two bullet points maximum describing the key change
+4. **Focus on user impact**: Describe what changed from a user's perspective, not implementation details
+
+### Example Changelog Entry
+```markdown
+## Unreleased
+
+### 🔧 Technical Improvements
+- **Type safety**: Fixed all pyright typing errors for better code quality
+- **Code cleanup**: Removed unused functions and improved type annotations
+```