djlintr 0.5.9__tar.gz

djlintr-0.5.9/.envrc

@@ -0,0 +1 @@
+use flake

djlintr-0.5.9/.github/dependabot.yml

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

djlintr-0.5.9/.github/workflows/ci.yml

@@ -0,0 +1,137 @@
+name: CI & Release
+
+on:
+  push:
+    branches: [ main ]
+    tags: [ 'v*' ]
+  pull_request:
+    branches: [ main ]
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy, rustfmt
+      - name: Rust Cache
+        uses: Swatinem/rust-cache@v2
+      - name: Run lint
+        run: make lint
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+      - name: Rust Cache
+        uses: Swatinem/rust-cache@v2
+      - name: Run tests
+        run: cargo test
+
+  parity:
+    name: Linter Parity
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+      - name: Rust Cache
+        uses: Swatinem/rust-cache@v2
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: '3.12'
+      - name: Install djlint
+        run: make install-djlint
+      - name: Fetch test data
+        run: make fetch-test-data
+      - name: Run parity comparison
+        run: make compare-lint
+      - name: Run format parity comparison
+        run: make compare-reformat
+
+  build:
+    name: Build (${{ matrix.target }})
+    needs: [lint, test, parity]
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-musl
+            artifact_name: djlintr-linux-amd64
+          - os: macos-latest
+            target: x86_64-apple-darwin
+            artifact_name: djlintr-macos-amd64
+          - os: macos-latest
+            target: aarch64-apple-darwin
+            artifact_name: djlintr-macos-arm64
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
+            artifact_name: djlintr-windows-amd64.exe
+
+    steps:
+      - uses: actions/checkout@v6
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.target }}
+      
+      - name: Install musl-tools
+        if: matrix.target == 'x86_64-unknown-linux-musl'
+        run: sudo apt-get install -y musl-tools
+
+      - name: Rust Cache
+        uses: Swatinem/rust-cache@v2
+        with:
+          key: ${{ matrix.target }}
+
+      - name: Build
+        run: cargo build --release --target ${{ matrix.target }}
+
+      - name: Rename binary
+        shell: bash
+        run: |
+          if [ "${{ matrix.os }}" = "windows-latest" ]; then
+            mv target/${{ matrix.target }}/release/djlintr.exe ${{ matrix.artifact_name }}
+          else
+            mv target/${{ matrix.target }}/release/djlintr ${{ matrix.artifact_name }}
+          fi
+
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v7
+        with:
+          name: ${{ matrix.artifact_name }}
+          path: ${{ matrix.artifact_name }}
+
+  release:
+    name: Create Release
+    needs: build
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          path: artifacts
+          merge-multiple: true
+      
+      - name: Create Release
+        uses: softprops/action-gh-release@v3
+        with:
+          files: artifacts/*
+          generate_release_notes: true
+          draft: false
+          prerelease: false

djlintr-0.5.9/.github/workflows/pypi.yml

@@ -0,0 +1,80 @@
+name: Build and Publish Python Wheels
+
+on:
+  push:
+    tags: [ 'v*' ]
+
+jobs:
+  build-wheels:
+    name: Build Wheels (${{ matrix.target }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64
+          - os: ubuntu-latest
+            target: aarch64
+          - os: macos-latest
+            target: x86_64
+          - os: macos-latest
+            target: aarch64
+          - os: windows-latest
+            target: x86_64
+
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up QEMU
+        if: matrix.os == 'ubuntu-latest' && matrix.target == 'aarch64'
+        uses: docker/setup-qemu-action@v3
+        
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist
+          sccache: 'true'
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}-${{ matrix.target }}
+          path: dist
+
+  build-sdist:
+    name: Build sdist
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+          
+      - name: Upload sdist
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-sdist
+          path: dist
+
+  pypi-publish:
+    name: Publish to PyPI
+    needs: [build-wheels, build-sdist]
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+          path: dist
+          
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true

djlintr-0.5.9/.gitignore

@@ -0,0 +1,6 @@
+/target
+venv
+.direnv
+djlint-python
+venv
+temp_reformat

djlintr-0.5.9/AGENTS.md

@@ -0,0 +1,132 @@
+# Agent Guide: djlintr
+
+This document provides guidance for AI agents on how to develop, test, and release `djlintr`.
+
+## Project Overview
+
+`djlintr` is a fast HTML template linter and formatter, ported from the Python tool `djlint` to Rust. It aims for high performance and compatibility with the original tool.
+
+## Development Workflow
+
+### Building the Project
+
+You can build the project using standard Cargo commands or the provided `Makefile`.
+
+```bash
+# Debug build
+make build
+# or
+cargo build
+
+# Release build
+make release
+# or
+cargo build --release
+```
+
+### Running the CLI
+
+```bash
+cargo run -- [OPTIONS] <PATHS>...
+```
+
+### Testing
+
+Always run tests before submitting changes.
+
+```bash
+# Run all tests
+make test
+# or
+cargo test
+
+# Run a specific test file
+cargo test --test <test_name>
+```
+
+### Linting and Formatting
+
+Ensure the code adheres to Rust standards. **You MUST NOT consider a task finished until `make lint` passes.**
+
+```bash
+# Run clippy and check formatting (used in CI)
+make lint
+
+# Apply formatting
+make fmt
+```
+
+## Parity Testing
+
+A key goal is parity with the original Python `djlint`. There is a specialized setup for comparing lint results.
+
+1.  **Install djlint in a venv:**
+    ```bash
+    make install-djlint
+    ```
+2.  **Fetch test data:**
+    ```bash
+    make fetch-test-data
+    ```
+3.  **Run parity comparison:**
+    ```bash
+    make compare-lint
+    ```
+    This script compares the output of `djlintr` against `djlint` on a set of templates.
+
+## Release Process
+
+We use `cargo-release` for managing versions and tags.
+
+1.  **Preparation:**
+    - Ensure you are on the `main` branch.
+    - Ensure all tests, lint, and parity checks pass.
+    - Check that `CHANGELOG.md` is updated.
+
+2.  **Execute Release:**
+    Run `cargo release` to bump the version, create a git tag, and push to the repository.
+    **Note:** `consolidate-commits` must be set to `false` in `Cargo.toml` for `{{version}}` placeholders to render correctly in commit messages.
+    ```bash
+    # Dry run
+    cargo release <patch|minor|major> --execute --dry-run
+    
+    # Real release
+    cargo release <patch|minor|major> --execute
+    ```
+
+3.  **CI Automation:**
+    Once a tag (e.g., `v0.5.2`) is pushed, the GitHub Actions workflow (`.github/workflows/ci.yml`) will:
+    - Run the full test suite.
+    - Build release binaries for Linux (x64), macOS (x64, ARM64), and Windows (x64).
+    - Create a new GitHub Release and upload the binaries.
+
+## Architectural Notes
+
+- **Linter Rules:** Located in `src/linter/mod.rs`.
+- **Formatter Logic:** Located in `src/formatter/`.
+- **Configuration:** Handled in `src/config.rs`, supporting `.djlintrc` and `pyproject.toml`.
+- **Parallelism:** Uses `rayon` for fast file processing.
+
+
+## TDD
+
+When implementing new features or fixing bugs in the rust code, always
+use strict red/green TDD. This means:
+
+- start by adding a simple test case for the new feature or bugfix. pick
+  one aspect, happy path, edge case, etc. and focus on that.
+- (red) run the tests to verify that the new test fails (but other existing
+  tests should continue to pass)
+- implement a simple solution to get the new test passing
+- (green) run tests again to check that the test now passes (and that all
+  other existing tests continue to pass)
+- refactor the new code to make it cleaner
+- verify that the tests pass again
+- repeat this process until you are confident that the entire new
+  feature is implemented, the bug is fixed, etc.
+
+IMPORTANT: DO NOT delete tests after finishing the process. If a test
+is outdated or misleading, you must explain this to the user and get
+explicit permission to remove or update it. You MAY run
+individual tests instead of the entire suite to speed up the process,
+but the entire suite must pass before you are done.

djlintr-0.5.9/CHANGELOG.md

@@ -0,0 +1,100 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- **Python Packaging**: Added `maturin` configuration and a PyPI release GitHub action. `djlintr` can now be installed as a Python package via `pip install djlintr` or `uv pip install djlintr`.
+
+## [0.5.8] - 2026-05-16
+
+### Fixed
+
+- **Tokenizer**: Improved tag identification to correctly handle quoted attribute values containing `>` characters (e.g. Alpine.js arrow functions), ensuring parity with `djlint` and preventing false-positive `H012` errors.
+
+## [0.5.7] - 2026-05-16
+
+### Fixed
+
+- **H037 (Duplicate Attribute)**: Refined duplicate attribute detection to achieve full parity with `djlint`.
+
+## [0.5.3] - 2026-05-16
+
+### Fixed
+
+- **H014 (Blank Lines)**: Strip newlines from reported match string to prevent extra blank lines in CLI output.
+
+## [0.5.1] - 2026-05-16
+
+### Fixed
+- **100% Parity Reached**: Reproduced a specific `djlint` regex quirk for `H037` (duplicate attributes) that allowed it to jump across tags when nested quotes are present in template tags.
+- **H014 (Blank Lines)**: Refined regex and ignored-block logic to match `djlint` exactly.
+- **H030/H031 (Document Rules)**: Implemented a "commented out html" parity hack to match `djlint`'s document-level rule suppression.
+
+## [0.5.0] - 2026-05-16
+
+### Added
+- **Ignored Blocks Logic**: Implemented `ignored_ranges` to skip linting inside `<script>`, `<style>`, `<pre>`, and `<textarea>` tags, as well as HTML comments, matching `djlint`'s behavior.
+- **CLI & Config Alignment**: Added support for `--include` and `--ignore` flags.
+- **New Regression Test Suite**: Added `tests/parity_regressions.rs` covering major fixes and behavioral changes.
+
+### Changed
+- **Tokenizer & Offsets**: Updated the `Tokenizer` to include the byte `offset` for each token, improving lint error location accuracy.
+- **H008 (Double Quotes)**: Restricted to specific attributes (`class`, `id`, `src`, etc.) to match `djlint`.
+- **H010 (Lowercase Attributes)**: Now only checks actual attribute names, ignoring uppercase content within values.
+- **H020 (Empty Tag Pairs)**: Skips whitespace between tags and requires the opening tag to have no attributes.
+- **H025 (Orphan Tags)**: Replaced simple counter with a robust stack-based check for nested orphans.
+- **H014 (Blank Lines)**: Improved masking of template tags before regex matching for better parity.
+- **Default Rules**: Aligned rules disabled by default with `djlint` (`H017`, `H035`, `H036`, `H030`, `H031`).
+
+## [0.4.1] - 2026-05-12
+
+### Fixed
+- Internal lint error (clippy manual-pattern-char-comparison) in `src/linter/mod.rs`.
+
+## [0.4.0] - 2026-05-10
+
+### Added
+- Profile support (`--profile`) to match Python djlint's rule exclusion logic. Supported profiles: `html`, `django`, `jinja`, `nunjucks`, `handlebars`, `golang`, `angular`, and `all`.
+- Default profile is `html`, which correctly excludes template-specific rules (`T`, `D`, `J`, etc.) by default, achieving parity with Python djlint.
+
+### Changed
+- Simplified `T003` (named endblocks) implementation to match Python's regex exactly, removing the incorrect one-liner exception.
+
+## [0.3.0] - 2026-05-10
+
+### Added
+- Support for `max-attribute-length` configuration option and CLI flag to control attribute wrapping.
+
+## [0.2.0] - 2026-05-10
+
+### Added
+- Support for `custom_blocks` configuration option and CLI flag.
+- Support for re-indenting Django/Jinja tags: `{% else %}`, `{% elif %}`, and `{% empty %}`.
+- New `LICENSE` file (BSD 3-Clause).
+- New `README.md` with installation and usage instructions.
+- New `CHANGELOG.md` to track project changes.
+
+### Changed
+- Improved Django/Jinja tag indentation logic to only indent known block tags or user-defined custom blocks, preventing incorrect indentation for self-closing tags like `{% url %}`.
+- Updated project version to v0.2.0.
+
+## [0.1.1] - 2026-05-10
+
+### Added
+- Basic HTML/Template tokenizer.
+- Basic indentation logic.
+- Initial linter rule engine with several HTML and Template rules.
+- Parallel file processing support using `rayon`.
+- CLI implementation using `clap`.
+- Configuration support for `.djlintrc` and `pyproject.toml`.
+
+## [0.1.0] - 2026-05-09
+
+### Added
+- Initial project setup and infrastructure.