Documentation de Galen Framework

Prise en main de Galen Framework

Qu'est-ce que c'est Galen Framework ?

Galen Framework est un framework de tests fonctionnels responsive pour les sites web, il est écrit en Java et possède son propre langage GSPEC pour écrire les tests. Il est basé sur Selenium https://www.selenium.dev/

Installer Galen

Outils nécessaires

Notice :

Pour utiliser Galen, il est nécessaire de posséder Java 1.8 ou plus (télécharger ici https://www.java.com/fr/download/help/download_options_fr.html.

Installer avec NPM

Si vous utilisez NPM, vous pouvez installer Galen avec la commande suivante :

sudo npm install -g galenframework-cli

Installation manuelle

Installer dans Linux et OS X

Téléchargez le fichier depuis le site de téléchargement http://galenframework.com/download/ et décompressez le dans un répertoire. Placez vous dans le répertoire et tapez la commande suivante :

sudo ./install.sh

Pour vérifier que Galen est bien installé, tapez la commande suivante :

galen -v

Vous devriez visualiser la version installée de Galen.

Mettre a jour Galen dans Linux et OS X

Il n'existe pas de commande spéciale pour mettre a jour Galen, il suffit de taper la commande suivante et la dernière version disponible sera téléchargé sur votre machine. Suivez les étapes d'installation et vous devriez avoir la nouvelle version de Galen fonctionnelle :

sudo ./install.sh

Configuration

Configuration de projet

Galen vous permet de configurer chaque projet d'une manière différente. Il suffit de créer un fichier avec le nom galen.config dans votre répertoire de test ou sinon vous pouvez exécuter la commande suivante et Galen créera le fichier pour vous :

galen config

Configuration globale

Si vous souhaitez avoir une configuration globale pour tous vos projets de test, il suffit de taper la commande suivante :

galen config --global

La commande générera un fichier de configuration basique .galen.config dans votre répertoire. Il est important de configurer tous les pilotes externes que vous aurez besoin pour exécuter les tests dans différents navigateurs. Par exemple, si vous voulez utiliser Mozilla Firefox, il faudra déclarer le pilote geckodriver dans le fichier galen.config de cette façon :

$.webdriver.gecko.driver=/path/to/your/geckodriver

Important :

Il est indispensable de posséder les pilotes des navigateurs que vous utiliserez pour effectuer les tests, sans ces derniers les tests ne marcheront pas.

Voici quelques liens pour télécharger les differents pilotes pour les navigateurs :

• Mozilla Firefox : https://github.com/mozilla/geckodriver/releases
• Google Chrome : https://chromedriver.chromium.org/
• Opera : https://github.com/operasoftware/operachromiumdriver/releases
• Microsoft Edge : https://developer.microsoft.com/fr-fr/microsoft-edge/tools/webdriver/
• Safari : https://developer.apple.com/documentation/webkit/testing_with_webdriver_in_safari

Une fois le pilote téléchargé, placez-le dans un répertoire et retenez son chemin pour le mettre dans le fichier de configuration galen.config. $. ce préfixe signifie que cette propriété est défini au niveau du système, vous pouvez également l'utiliser pour configurer d'autres pilotes.

Exemple de configuration

galen.range.approximation=3
galen.browser.headless = true
galen.browser.screenshots.fullPage = false
galen.browser.screenshots.fullPage.scrollTimeout = 50
galen.browser.screenshots.fullPage.scrollWait = 20
galen.default.browser=firefox
spec.colorscheme.precision = 256
spec.colorscheme.testrange = 6
galen.browserFactory.selenium.runInGrid = true
galen.browserFactory.selenium.grid.url = http://localhost:4444/wd/hub 
galen.browserFactory.selenium.grid.browser = Firefox
galen.browserFactory.selenium.grid.browserVersion = 16
galen.browserFactory.selenium.grid.platform = XP
galen.use.fail.exit.code = true
galen.spec.image.tolerance = 30
galen.spec.image.error = 0px
galen.spec.global.visibility = true
galen.test.file.ext = .test
galen.test.js.file.ext = .test.js