Chapitre 8 - Librairies intergalactiques 💫

 

Objectif de la Mission 🎯

• Découvrir l'utilisation des librairies

Lirairies

Il est possible d'utiliser des librairies JS dans les onglets Script et/ou Tests de Bruno pour se faciliter la vie.

Librairies intégrées

Bruno propose une liste de librairie JavaScript pré-intégrées que vous pouvez utiliser directement (cf la liste exhaustive).

Le test pour valider la date du jour (vérification des champs currentDate) nous oblige à écrire beaucoup de code que l'on pourrait facilement remplacer par des fonctionnalités d'une librairie externe.

--> Utilisez la librairie intégrée Moment pour refactorer la méthode getCurrentDateFormatted utilisée dans le test sur la date du jour.

// import de la librairie Moment
const moment = require("moment")

// affichage de la date du jour au format dd/mm/yyyy
moment().format('L')

Solution

const moment = require("moment")

function getCurrentDateFormatted() {
    return moment().format('L')
}

Librairies externes

Utiliser dayjs à la place de Moment

Vous n'aimez pas la librairie Moment ? Vous préférez dayjs ?

Cela tombe bien, Bruno prend également en charge le chargement de n'importe quel module npm (cf doc).

Vous devrez simplement ajouter un fichier package.json là où votre collection est stockée sur votre ordinateur et déclarer la dépendance de la librairie désirée. Pour ce faire :

• créez un fichier package.json là où est stockée votre collection --> npm init (ou yarn init ou pnpm init)

• ajoutez la dépendance dayjs dans le package.json --> npm install dayjs (ou yarn add dayjs ou pnpm add dayjs)

• utilisez dayjs à la place de Moment --> dayjs().format('DD/MM/YYYY') pour récupérer la date du jour dans le format dd/mm/yyy

Solution

const dayjs = require("dayjs")

function getCurrentDateFormatted() {
  return dayjs().format('DD/MM/YYYY')
}

INFO

Pour prendre en compte en compte des collections qui intègrent des librairies externes dans une pipeline de delivery il faudra légèrement modifier le fichier de configuration de celle-ci en ajoutant une ligne pour installer les dépendances correspondantes.

- name: Run tests
        run: |
          cd solutions
          npm install # Installation des dépendances de la collection
          bru run chapter-7 -r --env ${{ env.ENVIRONMENT }} --output junit.xml --format junit --env-var password=${{ env.PASSWORD }}

Mettez à jour votre repository Github avec votre collection qui intègre la librairie dayjs.

N'oubliez pas de mettre à jour le fichier YAML de configuration de votre Github Actions.

C'est fini ! 😱

Et voilà, vous êtes arrivés au bout de ce workshop, félicitations 🎉

J'espère que vous avez appris tout en vous amusant, n'hésitez pas à starer (bouton ⭐️ Star en haut à droite d'une projet Github pour remercier l'auteur d'un projet) le projet sur github si celui-ci vous a apporté quelque chose.

Bonne continuation à vous, et vive la rébellion 👋