results = nelson.unittest.run(targets, Name, Value)
results = nelson.unittest.run(plan, Name, Value)
| Paramètre | Description |
|---|---|
| targets | nom de module, dossier, nom de fichier, tableau de cellules de cibles, TestSuite ou TestPlan. |
| Name, Value | options d'execution : Workers, Timeout, StopOnFail, Retry, RetryOnlyOn, LogDir, Format, OutputFile et Launcher. |
| Paramètre | Description |
|---|---|
| results | structure TestRunResult avec status, summary, cases normalises, diagnostics, registry et donnees brutes de compatibilite. |
nelson.unittest.run execute chaque test ou bench dans un processus enfant supervise. Il n'existe pas de mode d'execution in-process pour les tests ou les benches.
Les tests et les benches s'executent par defaut dans des processus enfants separes. Un fichier peut autoriser la reutilisation de processus avec le tag <--REUSE PROCESS-->.
Le superviseur natif utilise une file dynamique ponderee. Le tag optionnel <--WEIGHT N--> donne la priorite aux fichiers plus lourds sans modifier leur ordre stable d'affichage.
Le tag optionnel <--TIMEOUT N--> remplace le delai d'execution par fichier (en secondes) pour un seul fichier ; l'option globale Timeout, lorsqu'elle est definie, reste prioritaire.
Les resultats sont affiches progressivement dans l'ordre de decouverte des que les resultats precedents sont disponibles. Chaque ligne contient son statut et son temps d'execution.
Si un worker reutilisable crashe ou ne retourne aucun resultat, le runner relance une fois le test par le chemin isole. Un timeout est rapporte directement.
Sans tag GUI ou ADV-CLI, le launcher isole est nelson-cli, y compris lorsque le processus parent est graphique.
L'option Launcher choisit le backend graphique des tests tagues ADV-CLI : 'default' (les executables historiques) ou 'webview', qui execute ces tests via nelson-adv-cli --webview afin que les figures soient rendues par le backend web headless (RenderWeb). Les tags CLI et GUI ne sont pas affectes. La valeur est aussi lue depuis la variable d'environnement NELSON_UNITTEST_LAUNCHER, pratique en integration continue.
results = nelson.unittest.run('core', 'Workers', 4, 'Format', 'json', ...
'OutputFile', [tempdir(), 'core.json']);