cypress-emil/README.md

# Cypress Seed

Ce seed permet de demarrer un projet de test automatisé pour n'importe quel client ou application web en utilisant le framwork CYPRESS ==> https://www.cypress.io/

**NOTE** : Ce Repo restera un SEED qui evolura. Pour vos test faite un fork de ce seed

### Prerequis 

- node v12 ou + et npm 6.14 ou +

### Dependance

| Dependance  |  Version  |  Obligatoire  |
|---|---|---|
| __typescript__  | 3.8.3  |  X  |
| __cypress__  | 5.2.0  |  X  |
| __mochawesome__  |  6.1.1 |  X |

## Get Started

faire un git clone du projet : 
```bash
$ git clone https://gitea.ci.apside-top.fr/apside-qualite/cypress-seed.git 
```

Installer toutes les dependance avec npm  
```bash
$ cd ./cypress-seed
$ npm install 
```

Ouvrir Cypress
```bash
$  npm run cypress:open:dev 
```

![alt text](./docs/capture-open.gif "Openning cypress")


Cliquer sur ``apside.spec.ts``

Tous les test présent dans ``apside.spec.ts`` vont être joués

![alt text](./docs/capture-running.gif "Running test")


Genere les rapport mochawesome
```bash
$  npm run generate:report:dev 
```

cela va genere un repertoire ``mocha_reports`` avec un rapport detailé et beau ;-) de tous vos tests

 puis ouvrir ``output.html``

![alt text](./docs/capture-repports.png "Mocha report")

## Premier test avec Cypress

// TODO Donner 2 3 exemple de Comment créer un test

**NOTE** : 2 configuration sont actuellement disponible

## A vous de jouer 

commencez par ouvrir ``cypress.dev.json`` et changez ``baseUrl`` par l'url de l'environnement que vous voullez tester. 

Ouvrir __cypress__ puis dans votre ide ouvrir ``apside.spec.ts`` supprimer le code existant et à vous de jouer

// TODO expliquer les 2 config dev et local

# RELEASE

## 0.0.1 (_23/09/2020_)
- initialisation __cypress__ et les rapport __mochawesome__

# Liens utils
- Cypress guide : https://docs.cypress.io/guides/overview/why-cypress.html#In-a-nutshell
- Documentation API : https://docs.cypress.io/api/api/table-of-contents.html 
- Article "_Stop using Page Objects and Start using App Actions_" https://www.cypress.io/blog/2019/01/03/stop-using-page-objects-and-start-using-app-actions/