Package: k-lity
K-lityK-lity est un outil pour faciliter les tests automatisés pour des sites webs.English translation available belowDisclaimerThis application is still under huge development by a french developer in a
windows and Firefox environment. You should use it only if you know what
you are doing!!! English translation is available at the end !!InstallationIl faut spécifier, si nécessaire, la ou les bases de données que vous souhaitez
utiliser dans vos tests.pip install k-lity[postgresql]Ici, nous avons souhaité utiliser postgresql (seule base de données utilisable
pour le moment).Vous aurez également besoin d'installergeckodriverpour pouvoir
piloter Firefox (seul navigateur utilisable pour le moment). Geckodriver doit
être accessible via votre PATH.Démarrage rapideAfin de lancer un premier test, vous devez créer un répertoire projet. K-lity
vous aide via la commandeklity-newproject::klity-newproject mytestVous obtenez alors un répertoire appelémytestavec cette structure ::mytest
├── configuration.yml
├── environment.py
└── steps
   └── project_steps.pyconfiguration.ymlest un fichier de configuration par défaut. Modifiez-le
pour spécifier votre propre configuration.environment.pyest un fichier python pour usage interne , n'y touchez pas.stepsest le répertoire dans lequel vous allez écrire tous vos tests.project_steps.pyest un fichier python qui contient les étapes spécifiques
à votre projet.Un premier testPour écrire votre test, vous n'avez besoin que d'un éditeur de texte. Créer un
fichierfirst_test.featuredans le répertoirestepset écrivez le test
suivant::Fonctionnalité: Premier test avec K-lity

Scénario: Un exemple avec example.org
    Etant donné que je visite le site "https://example.org"
    Alor la page contient "Example Domain"Vous pouvez alors lancer votre test depuis le répertoire parentmy_testet
voir le test se dérouler à votre écran. Logiquement, vous devriez voir Firefox
se lancer et rapidement se refermer une fois que le site example.org est chargé.> klity
first_test
  Executing testsMaintenant, vous pouvez découvrir quelques nouveautés :un fichier
(geckodriver.log) et trois répertoires ont été créés:geckodriver.logcontient les logs fournis par geckodriver.reportcontient un rapport sur vos tests.resultscontient les résultats de toutes les commandesbehaveexécutées
pour cahcune de vos fonctionnalités.Lors de la création des tests, ces
fichiers sont très importants car ils peuvent vous aider à comprendre ce qui
se passe.screenshotscontient les captures d'écran de vos tests.Plus d'informations ?Vous pouvez trouver plus d'information surnotre documentation.K-lityTool made to ease automatic testing websites.DisclaimerThis application is still under huge development by a french developer in a
windows and Firefox environment. You should use it only if you know what
you are doing!InstallationIn order to install K-lity, you need to specify the extras databases you want to
use.pip install klity[postgresql]In this case, we needed to install postgresql requirements.You'll need to havegeckodriverin order to be
able to drive Firefox (no other browser for now). It must be accessible on your
PATH.QuickstartIn order to launch a first test, you have to create a fresh test folder. K-lity
helps you by providing theklity-newprojectcommand for this:klity-newproject mytestYou'll obtain a new folder namedmytestwith this structuremytest
├── configuration.yml
├── environment.py
└── steps
   └── project_steps.pyExplanations about this structure :configuration.ymlis a default configuration file, you should use it to
set your own configurationenvironment.pyis for internal use onlystepsis a folder in which all features, scenarios, and steps should beproject_steps.pyis a python file you can use to add specific steps for
your projectFirst testIn order to write test, you only need a simple text editor. Create afirst_test.featurefile in thestepsfolder and write a first feature to
test.Feature: First test with Klity

Scenario: Example with example.org
    Given I visit "https://example.org"
    Then page contains "Example Domain"Then you can launch your test (behave should useenlanguage) from themy_testfolder and see your first test feature found and its scenario(s)
executed. You should see Firefox opening and quickly closing after example.org
being showed.> klity
first_test
  Executing testsNow you can check out some new things. Firstly, one new file (geckodriver.log)
and three new folders have been created :report,results, andscreenshots.reportfolder contains a simple report about your tests.resultsfolder contains the result of the behave command for each of your
features. While creating new tests, thoses files are very important because
this is where you can see each step of your tests.screenshotsfolder contains your testing screenshots if you did some.More informationsYou can find more information onour documentation.