Dev

.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

@@ -0,0 +1,297 @@
+name: Appwrite SDK Build Validation
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+on: [pull_request]
+
+jobs:
+  generate-and-build:
+    name: ${{ matrix.sdk }} (${{ matrix.platform }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          # Client SDKs
+          - sdk: web
+            platform: client
+
+          - sdk: flutter
+            platform: client
+
+          - sdk: apple
+            platform: client
+
+          - sdk: android
+            platform: client
+
+          - sdk: react-native
+            platform: client
+
+          # Server SDKs
+          - sdk: node
+            platform: server
+
+          - sdk: php
+            platform: server
+
+          - sdk: python
+            platform: server
+
+          - sdk: ruby
+            platform: server
+
+          - sdk: dart
+            platform: server
+
+          - sdk: go
+            platform: server
+
+          - sdk: swift
+            platform: server
+
+          - sdk: dotnet
+            platform: server
+
+          - sdk: kotlin
+            platform: server
+
+          # Console SDKs
+          - sdk: cli
+            platform: console
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.3'
+          extensions: curl
+
+      - name: Install Composer Dependencies
+        run: composer install
+
+      - name: Generate SDK for ${{ matrix.sdk }}
+        run: php example.php ${{ matrix.sdk }} ${{ matrix.platform }}
+
+      # Language-specific setup
+      - name: Setup Node.js
+        if: matrix.sdk == 'web' || matrix.sdk == 'node' || matrix.sdk == 'cli' || matrix.sdk == 'react-native'
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Setup Flutter
+        if: matrix.sdk == 'flutter'
+        uses: subosito/flutter-action@v2
+        with:
+          channel: 'stable'
+
+      - name: Setup Swift
+        if: matrix.sdk == 'apple' || matrix.sdk == 'swift'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y wget
+          wget https://download.swift.org/swift-5.9.2-release/ubuntu2204/swift-5.9.2-RELEASE/swift-5.9.2-RELEASE-ubuntu22.04.tar.gz
+          tar xzf swift-5.9.2-RELEASE-ubuntu22.04.tar.gz
+          sudo mv swift-5.9.2-RELEASE-ubuntu22.04 /usr/share/swift
+          echo "/usr/share/swift/usr/bin" >> $GITHUB_PATH
+
+      - name: Setup Java
+        if: matrix.sdk == 'android' || matrix.sdk == 'kotlin'
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '17'
+
+      - name: Setup Python
+        if: matrix.sdk == 'python'
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Setup Ruby
+        if: matrix.sdk == 'ruby'
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.1'
+
+      - name: Setup Dart
+        if: matrix.sdk == 'dart'
+        uses: dart-lang/setup-dart@v1
+        with:
+          sdk: 'stable'
+
+      - name: Setup Go
+        if: matrix.sdk == 'go'
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.21'
+
+      - name: Setup .NET
+        if: matrix.sdk == 'dotnet'
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '8.0.x'
+
+      - name: Build SDK
+        working-directory: examples/${{ matrix.sdk }}
+        run: |
+          case "${{ matrix.sdk }}" in
+            web|node)
+              npm install
+              npm run build
+              ;;
+            cli)
+              npm install
+              npm run linux-x64
+              ;;
+            react-native)
+              npm install
+              npm run build || echo "No build script, checking syntax only"
+              ;;
+            flutter)
+              flutter pub get
+              dart analyze --no-fatal-warnings
+              ;;
+            apple|swift)
+              swift build
+              ;;
+            android)
+              chmod +x ./gradlew || true
+              ./gradlew build -x lint
+              ;;
+            kotlin)
+              chmod +x ./gradlew || true
+              ./gradlew build
+              ;;
+            php)
+              composer install
+              find . -name "*.php" ! -path "./vendor/*" -exec php -l {} +
+              ;;
+            python)
+              pip install -e .
+              python -m compileall appwrite/
+              ;;
+            ruby)
+              bundle install
+              ;;
+            dart)
+              dart pub get
+              dart analyze --no-fatal-warnings
+              ;;
+            go)
+              go mod tidy || true
+              go build ./...
+              ;;
+            dotnet)
+              dotnet build
+              ;;
+            *)
+              echo "Unknown SDK: ${{ matrix.sdk }}"
+              exit 1
+              ;;
+          esac
+
+      - name: Run Tests
+        working-directory: examples/${{ matrix.sdk }}
+        run: |
+          case "${{ matrix.sdk }}" in
+            web|node|cli|react-native)
+              if [ -f "package.json" ] && grep -q '"test"' package.json; then
+                # Check if test script is not a placeholder/error message
+                if grep -q '"test".*"echo.*no test' package.json; then
+                  echo "No tests configured (placeholder script found)"
+                else
+                  npm test
+                fi
+              else
+                echo "No tests configured in package.json"
+              fi
+              ;;
+            flutter)
+              if [ -d "test" ] && find test -name "*_test.dart" 2>/dev/null | grep -q .; then
+                flutter test
+              else
+                echo "No Flutter tests found"
+              fi
+              ;;
+            apple|swift)
+              if [ -d "Tests" ] && find Tests -name "*.swift" 2>/dev/null | grep -q .; then
+                swift test
+              else
+                echo "No Swift tests found"
+              fi
+              ;;
+            android)
+              if [ -d "library/src/test" ] || [ -d "app/src/test" ]; then
+                ./gradlew test
+              else
+                echo "No Android tests found"
+              fi
+              ;;
+            kotlin)
+              if [ -d "src/test" ]; then
+                ./gradlew test
+              else
+                echo "No Kotlin tests found"
+              fi
+              ;;
+            php)
+              if [ -f "vendor/bin/phpunit" ] && [ -d "tests" ]; then
+                vendor/bin/phpunit tests/
+              else
+                echo "No PHPUnit tests configured"
+              fi
+              ;;
+            python)
+              if [ -d "tests" ] || find . -maxdepth 2 -name "test_*.py" -o -name "*_test.py" 2>/dev/null | grep -q .; then
+                python -m pytest
+              else
+                echo "No pytest tests found"
+              fi
+              ;;
+            ruby)
+              if [ -d "test" ] || [ -d "spec" ]; then
+                if [ -f "Rakefile" ] && grep -q "test" Rakefile; then
+                  bundle exec rake test
+                elif [ -d "spec" ]; then
+                  bundle exec rspec
+                else
+                  echo "No Ruby tests configured"
+                fi
+              else
+                echo "No Ruby tests found"
+              fi
+              ;;
+            dart)
+              if [ -d "test" ] && find test -name "*_test.dart" 2>/dev/null | grep -q .; then
+                dart test
+              else
+                echo "No Dart tests found"
+              fi
+              ;;
+            go)
+              if find . -name "*_test.go" 2>/dev/null | grep -q .; then
+                go test ./...
+              else
+                echo "No Go tests found"
+              fi
+              ;;
+            dotnet)
+              if find . -name "*.csproj" -exec grep -l "Microsoft.NET.Test.Sdk" {} \; 2>/dev/null | grep -q .; then
+                dotnet test
+              else
+                echo "No .NET tests configured"
+              fi
+              ;;
+            *)
+              echo "No tests for SDK: ${{ matrix.sdk }}"
+              ;;
+          esac

.github/workflows/tests.yml

@@ -6,6 +6,9 @@ concurrency:
 
 on: [pull_request]
 
+env:
+  UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
+
 jobs:
   build:
     runs-on: ubuntu-latest
@@ -20,8 +23,6 @@ jobs:
           CLINode18,
           DartBeta,
           DartStable,
-          Deno1193,
-          Deno1303,
           DotNet60,
           DotNet80,
           DotNet90,
@@ -47,6 +48,7 @@ jobs:
           Ruby31,
           AppleSwift56,
           Swift56,
+          Unity2021,
           WebChromium,
           WebNode
         ]
@@ -96,7 +98,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.