Robot Framework

Introduction à Robot Framework

Robot Framework est un framework open-source utilisé pour automatiser les tests. Il prend en charge des formats de fichiers lisibles par l'humain (en plain text, HTML, ou Jupyter Notebook). Il est particulièrement populaire pour les tests d'applications web, grâce à son intégration avec la bibliothèque SeleniumLibrary.

Avantages de Robot Framework

Syntaxe simple et lisible.
Extensible via des bibliothèques personnalisées.
Support multi-plateforme (Windows, macOS, Linux).
Facile à intégrer avec CI/CD (Jenkins, GitLab CI/CD, etc.).

Installation et Configuration

Prérequis

Python (version 3.6 ou supérieure) installé sur votre machine.
pip (gestionnaire de paquets Python).

Étapes d'installation


        # Installer Robot Framework
        pip install robotframework

        # Installer SeleniumLibrary
        pip install robotframework-seleniumlibrary

        # Installer le driver de votre navigateur (ex : ChromeDriver pour Chrome)

Configuration d'un Projet

Créez une structure simple pour vos tests :

tests/ : Contiendra les fichiers de test (.robot).
resources/ : Contiendra des mots-clés personnalisés ou des fichiers communs.
results/ : Stockera les rapports et journaux.

Écrire un Test Basique

Exemple de test avec SeleniumLibrary


        *** Settings ***
        Library    SeleniumLibrary

        *** Variables ***
        ${BROWSER}     chrome
        ${URL}         https://example.com

        *** Test Cases ***
        Test de Connexion
        [Documentation]    Vérifie qu'une page s'ouvre correctement.
        Open Browser    ${URL}    ${BROWSER}
        Title Should Be    Example Domain
        Close Browser

Page Object Model (POM) avec Robot Framework

Le Page Object Model est une façon d'organiser vos tests en séparant la logique des tests des détails de l'interface utilisateur. Avec Robot Framework, cela se fait en utilisant des fichiers de ressources.

Exemple

1. Fichier `LoginPage.robot` :


        *** Keywords ***
        Open Login Page
        [Arguments]    ${url}
        Open Browser    ${url}    chrome
        Wait Until Element Is Visible    id:username

        Enter Credentials
        [Arguments]    ${username}    ${password}
        Input Text    id:username    ${username}
        Input Text    id:password    ${password}

        Click Login
        Click Button    id:loginButton

2. Fichier de test utilisant la page :


        *** Settings ***
        Resource    ../resources/LoginPage.robot
        Library     SeleniumLibrary

        *** Test Cases ***
        Test de Connexion avec POM
        Open Login Page    https://example.com/login
        Enter Credentials    admin    password123
        Click Login
        Close Browser

Tests Avancés

Data-Driven Tests avec Variables


        *** Test Cases ***
        Connexion avec Données Variables
        [Template]    Connexion Template
        admin    password123
        user1    pass456
        user2    pass789

        *** Keywords ***
        Connexion Template
        [Arguments]    ${username}    ${password}
        Open Browser    https://example.com/login    chrome
        Input Text    id:username    ${username}
        Input Text    id:password    ${password}
        Click Button    id:loginButton
        Close Browser

Tests Parallèles

Avec le module Pabot, vous pouvez exécuter des tests en parallèle :


        pip install robotframework-pabot
        pabot --outputdir results tests/

Exécution et Rapports

Pour exécuter un test, utilisez la commande suivante :


        robot --outputdir results tests/

Après l'exécution, consultez :

output.xml : Résumé des tests.
report.html : Rapport HTML.
log.html : Journal détaillé des étapes.