Voir la source de SiteWeb:Tests de la migration Drupal 6

[[Catégorie:SiteWebHistorique]]

Cette page est conservée a titre historique.

[[La migration de Drupal 5 à Drupal 6]] est scriptée pour permettre de la répéter facilement et mettre en place un site de test.

Deux phases de test sont prévues. Lors de la [https://agir.april.org/issues/128 première phase], les membres les plus actifs et les plus impliqué de l'April ont accès au site. L'objectif est de trouver et corriger les problèmes les plus graves et/ou de sécurité. Tandis que la [https://agir.april.org/issues/130 seconde phase] est ouverte à tous.

== Tester le site ==
* Le site de préproduction est disponible à l'adresse http://preprod.april.org.
* La liste des problèmes connus est accessible à l'adresse https://agir.april.org/projects/siteweb/issues?query_id=8
* Une liste des test réalisé est disponible en bas de page. Merci de la mettre à jour avec les tests réalisés, au moins ceux qui ne mettent aucune anomalie en évidence.
* L'intégration de gDTC et gDTC-Auth devrait être fonctionnel.
* Alexandrie n'est par pas porté

== Rapporter les problèmes ==

* Les anomalies rencontrées lors de tests doivent être rapportées sous forme de ''demandes'' (aka. ''bug report'') pour le projet SiteWeb sur le [https://agir.april.org/ Gestionnaire de projets de l'April]. 
* La création de demande se fait depuis l'URL suivante https://agir.april.org/projects/siteweb/issues/new
*;Tracker
*:Utilisez '''anomalie'''.
*;Sujet
*:Entrez une description brève du problème rencontré, en un phrase
*;Description
*:Entrez une  description détaillée du problème. Il est particulièrement important de donner un maximum d'information sur le comportement attendus et les étapes nécessaire pour y parvenir. Gardez à l'esprit que vous écrivez pour un lecteur qui ne connait pas le site de l'April dans les détails, qui ne sait pas comment une page fonctionne d'''habitude'', ''normalement'' ou ''comme avant''.
*;Status
*:Utilisez '''Nouveau'''
*;Priorité
*:Utilisez '''Normal''' sauf si une autre priorité est plus approprié. Si un problème rencontré est une gène ou bloquant pour la poursuite des tests, utilisez ''Élevé'' ou ''Urgent'', voire ''Immédiat'' pour les cas le plus graves ou les failles de sécurité (ex. vous avez accès au contenu d'une page que vous ne devriez pas pouvoir voir). Inversement, pour les problèmes mineurs qui pourraient même être acceptables sur le site après la migration effective, utilisez ''Faible''.
*;Assigné à
*:N'utilisez '''pas de valeurs'''.
*;Catégorie
*:Utilisez '''Migration Drupal 6'''
* Après création d'une demande, vous pouvez la lier avec des problèmes ou tâches déjà rapportés. Entre autre
** Si c'est un problème visuel (image manquante, mauvais alignement d'éléments, etc.), vous pouvez le lier à la demande [https://agir.april.org/issues/141 #141 (Port du thème)]
** Si c'est un problème d'utilisation de gDTC, vous pouvez le lier à la demande [https://agir.april.org/issues/125 #125 (Port du module d'intégration gDTC)]
* Un script de test pour reproduire le problème et valider sa solution peut-être attaché au ticket (cf. section suivante)

== Automatisation des tests ==
Si un comportement ''anormale'' est observé sur le site de test, l'idéal est de créer un script de test qui réussi sur le site de production actuel (www.april.org) mais échoue sur staging.april.org. Un script de test permet de répéter facilement le problème et de valider sa correction. Il peut également servir comme test de régression pour éviter qu'une correction d'un problème n'en ré-introduise un autre.
* [http://www.getwindmill.com/ Windmill] permet d'automatiser les tests

=== Installation de Windmill ===

 $ sudo apt-get install python2.5
 $ wget http://peak.telecommunity.com/dist/ez_setup.py
 $ sudo python ez_setup.py
 $ sudo easy_install windmill

Voir http://wiki.github.com/windmill/windmill/installing pour plus d'information.

=== Création d'un test ===
* Lancer Windmill en mode [http://wiki.github.com/windmill/windmill/ide IDE] sur le site de production
 $ windmill firefox http://www.april.org
* Enregistrer une session d'utilisation du site via l'icône http://www.getwindmill.com/images/recbutton.png
** Le premier click démarre l'enregistrement
** Le second le stoppe
* En utilisant le menu ''Test Building'', il est possible d'ajouter des actions (''New Action'') au test
** http://www.getwindmill.com/images/record.png
** <code>open</code> permet d'ouvrir une URL spécifique (ex. "/fr/my"), les changements d'URL via la barre d'adresse ne sont pas enregistré. 
** <code>asserts.*</code> permet de vérifier des conditions telle que la présence ou non d'une élement HTML, la valeur dans un champs de formulaire, etc.
** Voir [http://wiki.github.com/windmill/windmill/controller-api Controller-API] pour une description des actions possibles et de leur paramètres
* Le bouton ''Play'' permet de rejouer le test.
* Le bouton ''save'' permet d'exporter le test sous forme de code Python. Une nouvelle fenêtre est ouverte avec le code qui peut-être copié-collé dans un fichier texte en utilisant votre éditeur de texte préféré.

=== Exécution du test sur le site de test ===
 $ windmill firefox test=foobar.py http://staging.april.org/

=== Édition d'un script de test ===
Après l'enregistrement d'un script, il peut être ''facilement'' modifié, notamment pour exploiter les structures de contrôle (boucles et conditions). Toutes les fonctionnalités du langage Python sont utilisables en plus de [http://wiki.github.com/windmill/windmill/controller-api l'API du contrôleur] Windmill.

Windmill supporte également le passage de paramètre depuis le ligne de commande en utilisant [http://code.google.com/p/functest/ functest]. Très pratique pour, par exemple, ne pas avoir à stocker les information d'authentification utilisateur (voir exemple ci-dessous).
 $ windmill firefox test=foobar.py http://staging.april.org/ paramName=paramValue


==== Exemple d'un script de test ====
 #coding=UTF-8
 from windmill.authoring import WindmillTestClient
 import functest
 
 def test_foobar():
   client = WindmillTestClient(__name__)
   #Aller à la page /foo/bar
   client.open(url=u'/foo/bar')
   client.waits.forPageLoad(timeout=u'50000')
   #Vérifier l'existence d'une élément HTML contenant du texte
   client.asserts.assertNode(jquery=u"('p:contains(foo bar)')[0]")
   #Vérifier qu'une image est affichée
   client.asserts.assertImageLoaded(jquery=u"('[src*=foobar.png]')[0]")
 
   #Connexion (login et mdp passé en paramètre)
   client.type(text=functest.registry['username'], id=u'edit-name')
   client.type(text=functest.registry['password'], id=u'edit-pass')
   client.click(value=u'Connexion')
   client.waits.forPageLoad(timeout=u'20000')
 
   #Tester si le script est exécuté sur le site www.april.org ou non
   if client.execJS(js="document.location")['output']['hostname'] == 'www.april.org':
     #Site Drupal 5
   else:
     #Site Drupal 6

== Tests réalisés ==
''Les fichiers de tests sont visibles depuis https://agir.april.org/projects/siteweb/repository/revisions/master/show/tests/windmill''
* Page d'accueil (<code>testAcceuil.py</code>)
** Contient le logo April (*/logo.png)
** Contient une nuage de tag avec les termes "Éducation", "Administrations et collectivités" et "Archive".
** Devrait contenir les titres h2 (bloc de panel) suivants Dernières actualités, Derniers communiqués, Revue de Presse, Dernières actualités, Derniers communiqués, Revue de Presse, Le mot du président, Évènements à venir, Citation du moment, Adhérez maintenant pour, Thèmes (cf. [https://agir.april.org/issues/144 #144]).
* Page "Bibliographie" (<code>testBibliographie.py</code>)
** Contient la table de matière (valide que le module ToC a été migré, valide que le module htmlcomments a été installé pour permettre l'utilisation de commentaires HTML)
** Contient les titres de views embarqués dans la page (valide le remplacement du module insert_view, cf. [https://agir.april.org/issues/142 #142])
** Contient l'image <code>=La bataille du logiciel libre.jpg</code> issu d'une page dans une des vues (validation de la migration des images)
* Pages CA (<code>testCa.py</code>, pas fonctionnelles, cf. [https://agir.april.org/issues/140 #140])
**  Pour un utilisateur non connecté
*** La page "Groupe CA" (fr/ca) est accessible
*** La page "Groupe CA" ne contient pas le titre "Tableau de bord CA"
*** La page "Tableau de bord du CA" existe mais n'est pas accessible
** Pour un utilisateur connecté
*** La page "Groupe CA" (fr/ca) est accessible
*** La page "Groupe CA" contient pas le titre "Tableau de bord CA"
*** La page "Tableau de bord du CA" est accessible
* Page de citation <code>lapril-joue-un-role-extremement-important-dans-lecosysteme-logiciel-libre-en-france</code> (<code>testCitation.py</code>)
** Contient le nom de son auteur
** Contient un lien inclus dans la ''biographie'' de l'auteur (donc contient la biographie de l'auteur).
* Menu ''primary-links'' (cf. [https://agir.april.org/issues/149 #149], <code>test_logged_as_root/test149-primary-links.py</code>)
** Contient les entrées "About us" "L'association", "Communiqués" , "FAQ", "Nos positions", "Activités", "Our positions", "Thèmes", "Revue de presse", "Help us", "Wiki", "Adhérer", "Nous aider"
* Page "Thèmes" (cf. [https://agir.april.org/issues/147 #147], <code>test147-themes.py</code>)
** La page est accessible depuis un lien "Thème" en page d'accueil
** Elle contient les liens "Économie", "Éducation", "Accessibilité", "ACTA", "Administrations et collectivités", "Aprilien", "Archive", "Associations", "Brevets"
* Le Menu en anglais ne contient "Press Information", "Contact Us", "Rester informé" et "Document - Sensibilisation" (cf. [https://agir.april.org/issues/150 #150], <code>150-english-menu.py</code>)
* Page "Espace presse" (cf. [https://agir.april.org/issues/154 #154], <code>test154-espace-presse.py</code>)
** Ne contient pas "Fatal error"
** Contient le titre "Espace presse"
* Page "Activités de l'April" (cf. [https://agir.april.org/issues/148 #148], <code>test148-activites.py</code>)
** Ne contient pas "Fatal error"
** Contient le titre "Activités de l'April"
* Contenu de menu an anglais (cf. [https://agir.april.org/issues/150 #150], <code>test150-english-menu.py</code>)
* ''Submitted by'' au lieu de ''soumis par'' (cf. [https://agir.april.org/issues/180 #180], <code>test180SubmittedBy.py</code>)
* Affichage de teaser (cf. [https://agir.april.org/issues/171 #171], <code>test171Teaser.py</code>)
* Tri sur base de la date pour les listes de thème (cf. [https://agir.april.org/issues/179 #179], <code>test179DateSort.py</code>)
* Login depuis la page ''/my'' '''Problème non corrigé''' (cf. [https://agir.april.org/issues/169 #169], <code>test169-LoginDepuisMy.py</code>)
* La liste des actualités en anglais ne présente que des contenus en français (cf. [https://agir.april.org/issues/177 #177], <code>test177LesDernieresActusEn.py</code>)
* Traduction de nom de mois (cf. [https://agir.april.org/issues/178 #178], <code>test178MonthTranslation.py</code>)
* gDTC
** Affichage du Trombinoscope gDTC (<code>test_logged/testTrombinoscope.py</code>)
** Contenu de la page  ''espace personnelle'' (<code>test_logged/testMy.py</code>)
** Contenu de l'annuaire gDTC (<code>test_logged/testAnnuaire.py</code>)
** Accessibilité de page gDTC (<code>test_logged/testTitle.py</code>)