Merge remote-tracking branch 'upstream/master' into fix-dart-tests

Author: Fellmonkey

.github/workflows/djlint.yml

@@ -0,0 +1,31 @@
+name: Twig Linting
+
+on:
+  pull_request:
+    paths:
+      - '**.twig'
+      - '.github/workflows/djlint.yml'
+      - 'pyproject.toml'
+  push:
+    branches:
+      - master
+    paths:
+      - '**.twig'
+      - '.github/workflows/djlint.yml'
+      - 'pyproject.toml'
+
+jobs:
+  djlint:
+    name: djLint - Twig Linter
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Run djLint linter
+        run: |
+          uvx djlint templates/ --lint

.github/workflows/sdk-build-validation.yml

@@ -173,6 +173,7 @@ jobs:
               ;;
             php)
               composer install
+              find . -name "*.php" ! -path "./vendor/*" -exec php -l {} +
               ;;
             python)
               pip install -e .

.github/workflows/tests.yml

@@ -94,7 +94,7 @@ jobs:
       - name: Setup PHP with PECL extension
         uses: shivammathur/setup-php@v2
         with:
-          php-version: ${{ matrix.php-version }}
+          php-version: '8.3'
           extensions: curl
 
       - name: Install

CONTRIBUTING.md

@@ -122,6 +122,31 @@ docker run --rm -v $(pwd):/app -w /app php:8.3-cli php example.php
 
 Check your output files at: /examples/new-lang and make sure the SDK works. When possible, add some unit tests.
 
+## Linting Twig Templates
+
+We use [djLint](https://djlint.com/) to lint Twig template files for syntax errors and common issues. The linter runs automatically on pull requests.
+
+**To lint templates locally:**
+```bash
+composer lint-twig
+```
+
+**Requirements:**
+- [uv](https://github.com/astral-sh/uv) must be installed (for running `uvx` commands)
+
+**Configuration:**
+- Located in `pyproject.toml`
+- Only linting is enabled (formatting is disabled to avoid breaking code generation)
+- Several rules are ignored as they produce false positives for code generation templates
+
+**What the linter catches:**
+- Template syntax errors
+- Missing closing tags
+- Extra blank lines
+- Basic HTML structure issues
+
+**Note:** If you encounter linting errors that seem incorrect for code generation templates, please discuss in your PR rather than disabling the linter.
+
 ## SDK Checklist
 
 It is very important for us to create a consistent structure and architecture, as well as a language-native feel for the SDKs we generate.

README.md

@@ -70,6 +70,19 @@ $sdk->generate(__DIR__ . '/examples/php'); // Generate source code
 
 ```
 
+## Linting Twig Templates
+
+This project uses [djLint](https://djlint.com/) to lint Twig template files for syntax and common issues.
+
+**Note:** Formatting is disabled as it breaks code generation syntax. Only linting is used.
+
+**Available command:**
+```bash
+composer lint-twig  # Check for linting errors
+```
+
+Requires [uv](https://github.com/astral-sh/uv) to be installed. Configuration is in `pyproject.toml`. The linter runs automatically on pull requests via GitHub Actions.
+
 ## Supported Specs
 
 * [Swagger 2](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md)

composer.json

@@ -14,7 +14,8 @@
     "scripts": {
         "test": "vendor/bin/phpunit",
         "lint": "vendor/bin/phpcs",
-        "format": "vendor/bin/phpcbf"
+        "format": "vendor/bin/phpcbf",
+        "lint-twig": "uvx djlint templates/ --lint"
     },
     "autoload": {
         "psr-4": {