Mobile Test Reporting & CI Integration

# ══════════════════════════════════════════════════════════════
# GITHUB ACTIONS: MOBILE TEST PIPELINE
# .github/workflows/mobile-tests.yml
# ══════════════════════════════════════════════════════════════

name: Mobile Test Suite
on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main]

jobs:
  mobile-tests:
    runs-on: ubuntu-latest
    
    steps:
      - uses: actions/checkout@v4
      
      - name: Setup Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.12'
      
      - name: Install Dependencies
        run: |
          pip install Appium-Python-Client pytest pytest-html allure-pytest
      
      # Option A: BrowserStack (uses cloud devices - no local setup)
      - name: Run Mobile Tests on BrowserStack
        env:
          BROWSERSTACK_USERNAME: ${{ secrets.BS_USERNAME }}
          BROWSERSTACK_ACCESS_KEY: ${{ secrets.BS_ACCESS_KEY }}
          APP_URL: ${{ secrets.BS_APP_URL }}   # Pre-uploaded APK/IPA hash
        run: |
          pytest tests/mobile/             --alluredir=./allure-results             --html=./reports/mobile-report.html             -v             --tb=short
      
      # Option B: Local Emulator (slower, but free)  
      # - name: Start Android Emulator
      #   uses: reactivecircus/android-emulator-runner@v2
      #   with:
      #     api-level: 34
      #     script: pytest tests/mobile/ -v
      
      - name: Upload Test Reports
        if: always()
        uses: actions/upload-artifact@v4
        with:
          name: mobile-test-results
          path: |
            ./reports/
            ./allure-results/
          retention-days: 30
      
      - name: Upload Allure Report to GitHub Pages
        if: github.ref == 'refs/heads/main'
        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./allure-report

# ── MOBILE-SPECIFIC PYTEST CONFTEST WITH REPORTING ────────────
import allure
import pytest
from datetime import datetime

@pytest.fixture(scope="function")
def android_driver(request):
    from appium import webdriver
    # ... driver setup ...
    yield driver
    
    # On failure: capture screenshot and page source for report
    if request.node.rep_call.failed:
        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
        
        # Screenshot attached to Allure report
        allure.attach(
            driver.get_screenshot_as_png(),
            name=f"failure_screenshot_{timestamp}",
            attachment_type=allure.attachment_type.PNG
        )
        
        # Page source (XML dump of current screen hierarchy)
        allure.attach(
            driver.page_source,
            name=f"page_source_{timestamp}",
            attachment_type=allure.attachment_type.XML
        )
    
    driver.quit()