Contactez-nous

Installation de Robot Framework et de la librairie SeleniumLibrary (pour le web)

Apprenez à installer Robot Framework et la librairie SeleniumLibrary à l'aide de Pip. Instructions détaillées pour l'automatisation de tests web, y compris l'installation des WebDrivers.

Equiper votre environnement : Robot Framework et SeleniumLibrary

Maintenant que Python et Pip sont opérationnels sur votre système, l'installation de Robot Framework et de ses librairies devient une tâche simple et rapide. Robot Framework lui-même est un paquet Python que nous allons installer à l'aide de Pip. Pour pouvoir interagir avec les navigateurs web et automatiser des tests d'applications web, nous installerons également SeleniumLibrary, qui est l'une des librairies externes les plus populaires et les plus puissantes pour Robot Framework.

SeleniumLibrary agit comme une surcouche à la célèbre bibliothèque Selenium WebDriver, fournissant des keywords Robot Framework clairs et lisibles pour effectuer des actions de navigateur telles que l'ouverture d'URL, la saisie de texte dans des champs, le clic sur des boutons, la vérification de la présence d'éléments, etc. C'est un outil indispensable pour quiconque souhaite se lancer dans l'automatisation des tests web avec Robot Framework.

Ce sous-chapitre vous guidera à travers les commandes d'installation et les vérifications nécessaires. Nous aborderons également un point crucial pour le fonctionnement de SeleniumLibrary : l'installation des WebDrivers spécifiques aux navigateurs que vous souhaitez piloter.

Installation de Robot Framework via Pip

L'installation de Robot Framework se fait via une simple commande Pip dans votre terminal ou invite de commandes. Assurez-vous d'avoir une connexion internet active pour que Pip puisse télécharger le paquet depuis le Python Package Index (PyPI).

Ouvrez votre terminal (ou invite de commandes sur Windows) et tapez la commande suivante :

pip install robotframework

Si vous avez plusieurs versions de Python ou si `pip` n'est pas directement lié à votre installation Python 3, vous pourriez avoir besoin d'utiliser `pip3` :

pip3 install robotframework

Pip va télécharger Robot Framework et ses dépendances éventuelles, puis les installer. Une fois l'installation terminée, un message de succès devrait s'afficher.

Pour vérifier que Robot Framework a été correctement installé et est accessible, tapez la commande suivante :

robot --version

Cette commande devrait afficher la version de Robot Framework installée (par exemple, Robot Framework 4.1.3 (Python 3.9.7 on win32)). Si vous obtenez cette sortie, Robot Framework est prêt à l'emploi !

Installation de SeleniumLibrary pour l'automatisation web

De la même manière que Robot Framework, SeleniumLibrary s'installe avec Pip. Cette librairie vous permettra d'écrire des tests qui interagissent avec des navigateurs web.

Dans votre terminal, exécutez la commande :

pip install robotframework-seleniumlibrary

Ou, si nécessaire :

pip3 install robotframework-seleniumlibrary

Pip téléchargera et installera SeleniumLibrary ainsi que sa dépendance principale, la librairie Selenium pour Python.

Une fois l'installation terminée, il n'y a pas de commande de version spécifique pour SeleniumLibrary à vérifier directement depuis le terminal comme pour Robot Framework. Cependant, le fait que la commande Pip se soit terminée sans erreur est un bon indicateur. Nous vérifierons son bon fonctionnement plus tard lorsque nous écrirons nos premiers tests utilisant des keywords de cette librairie.

Installation des WebDrivers : le pont vers vos navigateurs

Pour que SeleniumLibrary (et Selenium en dessous) puisse contrôler un navigateur web (comme Chrome, Firefox, Edge, etc.), il a besoin d'un fichier exécutable spécifique appelé WebDriver. Chaque navigateur a son propre WebDriver, qui doit correspondre à la version du navigateur installé sur votre machine.

Voici les WebDrivers les plus courants :

Etapes générales pour installer un WebDriver :
  1. Vérifiez la version de votre navigateur : Allez dans les paramètres ou la section "A propos" de votre navigateur pour connaître sa version exacte (par exemple, Chrome 98.x.x.x).
  2. Téléchargez le WebDriver correspondant : Sur la page de téléchargement du WebDriver, choisissez la version qui correspond à celle de votre navigateur et à votre système d'exploitation.
  3. Placez le WebDriver dans votre PATH : C'est l'étape la plus importante. Une fois le fichier exécutable du WebDriver (par exemple, chromedriver.exe ou geckodriver) téléchargé et décompressé (s'il est dans une archive), vous devez le placer dans un répertoire qui est inclus dans la variable d'environnement PATH de votre système. Cela permettra à Selenium de le trouver automatiquement.

Des emplacements courants pour placer les WebDrivers sont :

  • Sur Windows : Un dossier comme C:\WebDriver\bin que vous ajoutez manuellement au PATH, ou directement dans le dossier d'installation de Python (par exemple, C:\Python39\Scripts), bien que la première option soit plus propre.
  • Sur macOS et Linux : Des répertoires comme /usr/local/bin ou /usr/bin sont souvent déjà dans le PATH. Vous pouvez y copier l'exécutable du WebDriver (nécessite généralement des droits d'administrateur avec `sudo`).

Alternativement, certaines librairies comme `webdriver-manager` pour Python peuvent aider à gérer automatiquement le téléchargement et la mise en cache des WebDrivers. Par exemple, pour ChromeDriver :

pip install webdriver-manager

Puis, dans un script Python (ce n'est pas directement utilisé par Robot Framework de cette manière, mais cela peut aider à s'assurer que le driver est disponible) :

from selenium import webdriver
from webdriver_manager.chrome import ChromeDriverManager

driver = webdriver.Chrome(ChromeDriverManager().install())

Bien que cette dernière méthode soit pratique pour le développement en Python pur avec Selenium, pour Robot Framework, s'assurer que l'exécutable du WebDriver est dans le PATH système est la méthode la plus directe et la plus couramment utilisée.

Une fois le WebDriver correctement placé dans le PATH, vous n'avez rien d'autre à configurer spécifiquement pour SeleniumLibrary à ce stade. Elle tentera de trouver le WebDriver approprié lors de l'exécution d'un keyword comme `Open Browser`.

Synthèse des installations et prochaines étapes

A ce stade, vous devriez avoir installé avec succès Robot Framework et SeleniumLibrary. Plus important encore, vous comprenez la nécessité des WebDrivers et savez comment les mettre en place pour les navigateurs que vous comptez automatiser. Votre environnement de base pour l'automatisation de tests est maintenant presque complet.

La prochaine étape consistera à configurer un environnement de développement intégré (IDE) pour faciliter l'écriture et la gestion de vos scripts Robot Framework. Nous nous concentrerons sur Visual Studio Code et ses extensions dédiées, qui amélioreront considérablement votre productivité.

Avec ces outils en main, vous serez fin prêt à écrire votre premier test automatisé et à voir Robot Framework et SeleniumLibrary en action.