Jenkinsfile

// Jenkinsfile - declarative pipeline for the Selenium + Pytest + Allure
// framework. Written for a Windows Jenkins agent (matches the drivers/
// folder and manually installed browser binaries the framework expects).
// Tested against Jenkins 2.375.3 with the Pipeline, Git, and Allure
// Jenkins plugins installed.

pipeline {
    agent any

    parameters {
        choice(name: 'BROWSER', choices: ['chrome', 'firefox', 'edge'],
               description: 'Browser to run the tests against')
        booleanParam(name: 'HEADLESS', defaultValue: true,
                      description: 'Run the browser in headless mode')
    }

    options {
        timestamps()
        disableConcurrentBuilds()
    }

    // "zoho-email-credentials" is a Jenkins "Username and password"
    // credential: username = the Zoho Mail sender address, password =
    // that account's SMTP (app) password. Jenkins exposes it as the two
    // env vars below - the same EMAIL_SENDER / EMAIL_PASSWORD names
    // utils/email_report.py reads locally, so no code differs between
    // a Jenkins run and a developer's own machine.
    environment {
        ZOHO_CREDENTIALS = credentials('zoho-email-credentials')
        EMAIL_SENDER = "${ZOHO_CREDENTIALS_USR}"
        EMAIL_PASSWORD = "${ZOHO_CREDENTIALS_PSW}"
    }

    stages {
        stage('Checkout') {
            steps {
                checkout scm
            }
        }

        stage('Set Up Python Environment') {
            steps {
                bat 'python -m venv venv'
                bat 'venv\\Scripts\\pip install --upgrade pip'
                bat 'venv\\Scripts\\pip install -r requirements.txt'
            }
        }

        stage('Run Tests') {
            steps {
                script {
                    def headlessFlag = params.HEADLESS ? '--headless' : ''
                    // --send-email is the exact same flag and the exact
                    // same utils/email_report.py code a person would use
                    // running pytest locally - nothing Jenkins-specific
                    // about the email logic itself.
                    bat "venv\\Scripts\\pytest --browser=${params.BROWSER} ${headlessFlag} --send-email"
                }
            }
        }
    }

    post {
        always {
            allure includeProperties: false,
                   jdk: '',
                   results: [[path: 'reports/allure-results']]
            archiveArtifacts artifacts: 'screenshots/**, logs/**',
                              allowEmptyArchive: true
        }
    }
}