Manual:Parser tests/fr

Le plus souvent, les cas de test de l'analyseur spécifie le wikicode (l'entrée généralement) et le HTML (la sortie généralement), pour confirmer que les choses se déroulent comme on les attend. La sortie courante est comparée au résultat souhaité, et ainsi les cas de test de l'analyseur (connus également sous le nom de tests de l'analyseur) peuvent être utiles pour pointer les régressions.

Les cas de test de l'analyseur sont rangés dans le répertoire. Les extensions doivent placer leurs tests dans un répertoire.

Vous pouvez à la fois faire les tests en utilisant la suite de tests unitaires de php, ou bien utiliser parserTests.php de manière indépendante. Ainsi un test en échec de l'analyseur déclenchera une erreur de test dans Jenkins.



Syntaxe et exécution


Format de la version 2
A partir de la 1.35, les tests de l'analyseur doivent se faire avec le format version 2. En précisant la version 2 vous indiquez que les tests sont utilisables en mode nettoyé (voir la tâche T249138).

Pour indiquer que vos tests de l'analyseur sont à exécuter au format version 2, vous pouvez utiliser la section des options du début de fichier (voir ci-dessous).

Eventuellement, en tant que raccourci, vous pouvez mettre  sur la première ligne de votre fichier de test de l'analyseur.



Autoriser les accroches
Pour être sûr que la balise d'extension  soit chargée, ajoutez au début du fichier :



Ajouter des articles
Pour créer de nouveaux articles, la syntaxe est :



Structure d'un test d'analyseur
En plus de l'heure du test, un test possède un certain nombre de sections :
 * sections obligatoires :
 * sections facultatives :,  ,  ,  ,  ,  ,  ,



Sections spécifiques à l'ancien analyseur
L'ancien analyseur s'attend toujours à trouver la section  et une des sections   ou.



Sections spécifiques à Parsoid
Les sections  et les différentes sections   n'ont de sens que pour les tests lancés avec Parsoid. Parsoid permet aussi une configuration supplémentaire avec des options supplémentaires spécifiques au test, dans la section des options. Parce que Parsoid permet de lancer les tests selon différents modes, ces derniers vont déterminer les sections attendues.


 * Pour les modes wt2html et html2wt, en plus de la section wikitext, au moins une des sections html, html/parsoid, html/parsoid+standalone, ou html/parsoid+integrated doit être présente.
 * Pour le mode wt2wt, seule la section wikitext est suffisante (mais le lanceur de test s'attend à trouver actuellement une section html présente).
 * Pour le mode html2html, une des sections html est suffisante.
 * Pour les modes selser, les sections wikitext et au moins une des html doivent être présentes.
 * Pour les modes manuels selser, wikitext et wikitext/edited doivent être présents ensemble.

Exemple
La syntaxe pour un test simple est la suivante :



Section de configuration
Si vous spécifiez les paramètres de configuration ici, assurez-vous qu'il n'y ait aucun espace entre les expressions parce que l'espace n'est pas supprimé par le lanceur de tests.



Section des options
Chaque option doit être sur une ligne séparée.

modifications du format
 * désactive le test.
 * exécute le test uniquement avec l'analyseur par défaut du noyau, sauf s'il existe des sections HTML spécifiques à Parsoid. Le nom php est un vestige du passé, lorsque Parsoid était une base de code Node.js.
 * ou  (objet au format JSON) active les options spécifiques à Parsoid.
 * Ex:  runs this test in only those 2 modes. By default, the test is run all available test modes for the test given the wikitext and html sections. In the common case, this defaults to running the test in modes: wt2html, wt2wt, html2wt, html2html, selser. The selser mode is an abbreviation for a test mode where the HTML section is edited in a number of automated ways which is then converted to wikitext using Parsoid's selective-serialization (selser henceforth) transformations.
 * In the JSON format object, the following keys are current recognized
 * - This is a comma separated list of Parsoid modes to run
 * - If selser is one of the test modes in the modes property, this property can optionally specify  to indicate automatic edits for this test should not be generated. If so, only manual edits as specified by the   property will be applied.
 * - This format is described separately below. This option will need to be paired with a  section in the test (see below)  that specifies the expected wikitext output when this edited HTML is converted (via selser) to wikitext by Parsoid.

This is an array of individual changes to apply to the DOM of the HTML generated by transforming wikitext. Each element of the array contains 3 or more elements: (a) jquery selector to select a DOM node (b) the type of change to apply to the selected node (c) the relevant values / content needed to apply the change specified.

More succinctly, each array element represents a jquery method call. So, [x,y,z...] becomes  So, ['fig', 'attr', 'width', '120'] is interpreted as

Right now, the following jquery methods are recognized:

See http://api.jquery.com/ for documentation of these methods.

"contents" as second argument calls the jquery .contents method on the results of the selector in the first argument, which is a good way to get at the text and comment nodes.



Sections wikicode

 * - Ceci est supposé être présent dans tous les tests qui nécessitent le wikicode à convertir en HTML (ou dans les modes html2wt et wt2wt de Parsoid, le wikicode à générer à partir des sections HTML).
 * - Cette section ne concerne que l'exécution des tests Parsoid. Pour les tests qui fournissent un ensemble manuel de modifications à appliquer au HTML généré de la section wikitext, ceci est la sortie attendue quand Parsoid reconvertit ce HTML modifié en wikicode.



Sections HTML

 * - This is the original default output section for a parser test. Parsoid only uses this section if there isn't any Parsoid-specific section available (see below). If Parsoid uses this section for a test, Parsoid will heavily normalize Parsoid's HTML output before comparing against this HTML. This is because Parsoid generates different markup for a lot of wikitext constructs. The normalization ensures the semantic attributes and properties (that don't have a rendering impact) don't cause false test failures.
 * - This section is only used by the legacy parser and Parsoid ignores this.
 * - This is the default section used by Parsoid and is used for both standalone and integrated tests if specialized sections aren't present for those modes. The test runner will minimally normalize Parsoid's output and this section to verify test pass/fails. The normalization strips some noisy attributes to prevent the need to add all this noisy output to parser tests.
 * - This Parsoid HTML section is only used in Parsoid standalone test runs (only implemented in Parsoid's test runner).
 * - This Parsoid HTML section is only used in Parsoid integrated test runs (only implemented in the MediaWiki core's test runner).



Autoriser les tests de Parsoid
Vous pouvez faire exécuter avec Parsoid tous les tests d'un fichier en utilisant l'option parsoid-compatible dans la section des options des fichiers. Vous pouvez spécifier des modes individuels, ou autoriser tous les modes en ne mettant aucune option. Par exemple  permet d'exécuter les tests Parsoid dans les modes wt2html et wt2wt. Mais  permet d'exécuter les tests Parsoid dans tous les modes (wt2html, wt2wt, html2wt, html2html, selser).

Voir l'exemple ci-dessous.



extension.json et tests de l'analyseur
Les extensions qui enregistrent leurs tests dans  et qui utilisent extension.json will auront leurs tests d'analyseur automatiquement activés. Les extensions qui se servent de l'ancien système de chargement des extensions peuvent utiliser :



Exécuter les tests avec parserTests.php
Pour exécuter les tests de l'analyseur, allez dans le répertoire de votre installation locale MediaWiki et exécutez les instructions suivantes à partir de la ligne de commande :

Pour exécuter les tests juste pour un seul fichier, utilisez le paramètre. Voir  pour les autres paramètres.



Options particulières au lanceur de test de Parsoid
Ces options ne sont pas disponibles avec le lanceur de tests de l'analyseur du noyau MediaWiki en MW 1.38 et auparavent. Vous pouvez lancer les tests en mode Parsoid via l'option. La meilleure documentation et la plus actuelle concernant toutes les options s'affiche avec :



Initialisation des paramètres de configuration globaux
Pour initialiser les variables globales par défaut pour tous les tests de l'analyseur dans une extension, utilisez l'accroche.

Pour un test donné, initialisez les paramètres de configuration ainsi :

<span id="See_also">