Introduction et prise en main

Robot Framework¶

Présentation de Robot Framework¶

Introduction à l’outil et ses fonctionnalités¶

• Robot Framework est un framework open source de test d’acceptation et d’automatisation basé sur une syntaxe en mots-clés

• Il est écrit en Python mais permet d’interfacer des bibliothèques dans d’autres langages (Java, .NET, etc.)

• Il est principalement utilisé pour :

  • les tests fonctionnels d’applications web, desktop ou API

  • l’automatisation de processus répétitifs

• Il repose sur une architecture modulaire avec des bibliothèques standards (SeleniumLibrary, BuiltIn, OperatingSystem, etc.)

• Il permet une écriture de tests lisible, proche du langage naturel, facilitant la collaboration entre développeurs, testeurs et métiers

• Il supporte l’exécution de tests en ligne de commande, via des outils CI/CD, ou avec des interfaces comme RIDE ou VS Code

Avantages et cas d’utilisation¶

• Avantages

  • Syntaxe simple et lisible, adaptée aux débutants

  • Extensible avec des bibliothèques personnalisées

  • Compatible avec de nombreux outils tiers (Selenium, Appium, RESTinstance, etc.)

  • Intégration facile dans des pipelines DevOps (Jenkins, GitLab CI, Azure DevOps)

  • Génération automatique de rapports HTML clairs et détaillés

• Cas d’utilisation

  • Tests d’interface utilisateur web avec SeleniumLibrary

  • Tests d’API REST avec la bibliothèque RequestsLibrary ou RESTinstance

  • Automatisation de tâches système ou de scripts batch

  • Tests de régression dans des projets agiles

  • Validation de processus métiers dans des chaînes CI/CD

Exemple¶

*** Settings ***
Library           BuiltIn

*** Test Cases ***
Afficher Un Message Simple
    Log    Bonjour, ceci est un test Robot Framework

Synthèse¶

Installation du module Browser¶

Instructions détaillées pour l’installation¶

• Prérequis

  • Python 3.7 ou supérieur

  • Accès à un terminal

  • Node.js (requis par Playwright)

• Étapes d’installation

  • Installer Robot Framework :

    pip install robotframework

  • Installer la bibliothèque Browser :

    pip install robotframework-browser

  • Installer les dépendances Playwright :

    rfbrowser init

Configuration initiale et vérification de l’installation¶

• Vérifier l’installation

  • Tester la version de Robot Framework :

    robot --version

  • Vérifier que rfbrowser est bien installé :

    rfbrowser --help

• Créer un test simple avec Browser

  • Exemple de fichier test_browser.robot :

    *** Settings ***
    Library    Browser
    
    *** Test Cases ***
    Ouvrir Une Page Web
        New Browser    headless=false
        New Page    https://robotframework.org
        Take Screenshot
        Close Browser

• Exécuter le test

  robot test_browser.robot

• Résultat attendu

  • Le navigateur s’ouvre, charge la page, prend une capture d’écran, puis se ferme

  • Un rapport HTML est généré avec les résultats

Synthèse¶

Concepts de base et méthodologie¶

Le robot s’appuie sur plusieurs éléments indispensables:

• Des éléments de paramétrage qui seront fonction des éléments à tester. Ils peuvent être globaux ou locaux et peuvent, si besoin, faire appel à des fonctions py ou java.

• Des variables ou constantes telles que l’on pourrait les retrouver dans tout type de langage

• Des mots-clés fournis soit par le framework, soit construit à partir des mots-clés du framework

• Des éléments à tester s’appuyant sur les mots-clés et les variables définies en amont

Point Importants

• Séparateur obligatoire : les éléments d’une ligne (mots-clés, arguments) sont séparés par tabulation (et non des espaces)

• Philosophie :

  • Favoriser la lisibilité et la clarté

  • Réutiliser les mots-clés pour éviter la duplication

  • Structurer les tests avec des mots-clés personnalisés pour refléter les étapes métier

Structure des scripts¶

Dans l’ordre les balises indispensables sont:

• *** Settings *** : importation des bibliothèques, ressources, variables

• *** Variables *** : définition de variables globales

• *** Test Cases *** : définition des scénarios de test

• *** Keywords *** : définition de mots-clés personnalisés

• Exemple de structure

  *** Settings ***
  Library    Browser                      # Intègre les mots-clés de la librarie Browser 
  
  *** Variables ***
  ${URL}     https://example.com          # Déclaration de la variable URL
  
  *** Test Cases ***
  Vérifier_Accès_Page                     # Nom du test
      Ouvrir_La_Page    ${URL}            # Exécution du mot-clé `Ouvrir_La_Page`
      Vérifier_Le_Titre    Example Domain # Exécution du mot-clé `Vérifier_Le_Titre`
  
  *** Keywords ***
  Ouvrir_La_Page                          # Création du mot-clé `Ouvrir_La_Page`
      New Browser    headless=true
      New Page    ${URL}
  
  Vérifier_Le_Titre                       # Création du mot-clé `Vérifier_Le_Titre`
      Get Title    ==    Example Domain

Analyse des logs et reportings¶

• Fichiers générés après exécution

  • log.html : journal détaillé de l’exécution (étape par étape)

  • report.html : synthèse des résultats (succès/échecs)

  • output.xml : fichier brut pour intégration CI/CD

• Utilisation des rapports

  • Identifier les tests échoués et les erreurs associées

  • Naviguer dans les mots-clés pour comprendre le déroulement

  • Utiliser les captures d’écran (avec Take Screenshot) pour les tests UI

• Bonnes pratiques

  • Nommer clairement les cas de test

  • Ajouter des messages explicites avec Log ou Should Be Equal As Strings

  • Utiliser Tags pour filtrer les tests dans les rapports