Introduction

Il est parfois utile d’importer des modules Python externes dans des procédures de test développées au sein du logiciel Introspect ESP. De même, il peut s’avérer utile d’exporter des méthodes de test ou des procédures de test complètes depuis le logiciel Introspect ESP afin de les utiliser dans des scripts Python externes. Cette note d’information « Technical Insights » décrit les moyens de répondre à ces deux besoins.

Importation de modules dans une procédure de test

Utilisation de la classe de composant PythonModule

Le logiciel Introspect ESP intègre une classe de composant appelée « PythonModule » ; il s’agit de la méthode recommandée pour importer des fonctions ou des modules Python externes dans les procédures de test exécutées à partir du logiciel Introspect ESP. Cette section décrit le concept de base de cette classe de composant et illustre son utilisation à l’aide d’exemples concrets.

Un composant PythonModule peut être instancié en l’ajoutant à la procédure de test logiciel Introspect ESP via le menu « Ajouter un composant ». Veuillez noter que cette classe de composant figure dans la catégorie « utilitaires » du menu, comme le montre l’image suivante.

Lorsque le composant PythonModule est instancié, le logiciel Introspect ESP effectue plusieurs actions automatisées. Tout d’abord, il ajoute le module à l’onglet « Composants », comme c’est le cas pour tous les autres composants instanciés. Ensuite, il crée un fichier .py vide dans le sous-dossier « Params » du dossier « Test Procedure » sous Windows. Le nom de ce fichier correspond au nom de la classe du composant qui a été instancié. Autrement dit, comme le montrent les deux images suivantes, le logiciel crée un module nommé pythonModule1 et un fichier correspondant nommé pythonModule1.py.

Par défaut, le fichier pythonModule1.py est vide, et le logiciel Introspect ESP lance généralement un éditeur de code pour permettre à l’utilisateur de modifier ce fichier. C’est à ce moment-là que du code externe peut être ajouté. Dans l’exemple suivant, nous présentons deux déclarations de fonction : l’une pour créer une méthode d’impression personnalisée et la seconde pour calculer une suite de Fibonacci. Comme vous pouvez le constater, n’importe quel code Python peut être inséré dans ce fichier, y compris des déclarations de fonction, des appels de fonction et des importations de bibliothèques.

Une fois le fichier pythonModule1.py enregistré, vous pouvez revenir au logiciel Introspect ESP sans plus jamais avoir à vous soucier du code source. À la place, nous importons le contenu du fichier en ajoutant l’appel pythonModule1.run() dans le volet principal « Test Procedure ». Une fois le fichier importé de cette manière, nous pouvons appeler n’importe quelle fonction qui y a été déclarée. Par exemple, l’image suivante montre comment appeler le calculateur de la suite de Fibonacci déclaré dans l’exemple ci-dessus ; l’image suivante présente quant à elle le journal d’exécution de la procédure de test, confirmant que le fichier Python externe a bien été importé et que la fonction de la suite de Fibonacci a été exécutée.

Placer un fichier Python dans le dossier « params »

Si vous souhaitez importer un fichier Python existant sans avoir à en coller le contenu dans un fichier vierge, il vous suffit de placer ce fichier dans le sous-dossier « Params » de votre dossier cible Introspect ESP Software. Lorsque vous procédez ainsi, le logiciel Introspect ESP Software crée automatiquement une instance de la classe de composant PythonModule. Dans l’exemple suivant, nous plaçons un fichier nommé « mySecondPythonModule.py » dans le dossier « Params », comme le montre l’image ci-dessous.

Le fichier lui-même ne comporte qu’une seule ligne, qui correspond à une instruction d’importation de la bibliothèque Python intégrée « uuid » ; elle n’est incluse ici qu’à titre d’exemple.

En ouvrant la procédure de test dans le logiciel Introspect ESP, on constate que la classe `PythonModule` est automatiquement instanciée, comme le montre l’image suivante.

Nous allons maintenant utiliser ce module dans le volet « Procédure de test ». Plus précisément, nous importons le module en exécutant la méthode `mySecondPythonModule.run()`, comme précédemment. Nous pouvons alors utiliser n’importe quelle fonction intégrée de la bibliothèque `uuid` que nous venons d’importer. Dans l’exemple suivant, nous l’utilisons pour créer un identifiant utilisateur unique, puis pour afficher cet identifiant dans la fenêtre de journalisation.

Le résultat de l’exécution de la procédure de test ci-dessus est présenté dans l’image suivante. Comme vous pouvez le constater, le module Python a été importé avec succès sans encombrer la fenêtre de la procédure de test.

Importation manuelle de fichiers Python

Outre la classe PythonModule, il est possible d’importer manuellement des fichiers dans les procédures de test créées au sein du logiciel Introspect ESP. Cela s’effectue à l’aide de constructions courantes du langage Python. Par exemple, l’image suivante illustre l’importation de la bibliothèque uuid directement depuis la procédure de test.

Veuillez noter que le logiciel Introspect ESP recherche automatiquement les fichiers Python externes dans le chemin d’accès suivant :

<Compte utilisateur>\Documents\Introspect\PythonCode

Tout fichier stocké dans ce répertoire peut être importé très simplement à l’aide de l’appel

importer nom_fichier

Exportation d’une procédure de test

Utilisation de la classe de composant TestAsPythonScript

Le logiciel Introspect ESP intègre une classe de composants appelée « TestAsPythonScript » ; il s’agit d’un utilitaire de génération automatique de code qui vous permet d’exporter des algorithmes développés au sein du logiciel Introspect ESP afin de les utiliser dans des scripts Python externes. L’avantage de cet outil est qu’il se charge automatiquement de l’initialisation des facteurs de forme, de la création des contextes de composants et de la connexion au matériel. Cette section décrit le concept de base de cette classe de composant.

Un composant TestAsPythonScript peut être instancié en l’ajoutant à la procédure de test logiciel Introspect ESP via le menu « Ajouter un composant ». Veuillez noter que cette classe de composant figure dans la catégorie « utilitaires » du menu, comme le montre l’image suivante.

REMARQUE : la fonction « TestAsPythonScript » a été introduite dans la version 3.6.79 du logiciel Introspect ESP et n’est pas disponible dans les versions antérieures.

Lorsque le composant « TestAsPythonScript » est instancié, il est ajouté au volet « Composants » comme n’importe quelle autre classe de composant. Cependant, contrairement aux autres classes de composant, cette classe ne dispose d’aucune méthode appelable. De ce fait, le volet « Procédure de test » n’est pas modifié, comme le montre la capture d’écran suivante. À la place, le logiciel Introspect ESP utilise l’existence du composant testAsPythonScript1 comme déclencheur pour enregistrer un fichier Python de sortie pouvant être utilisé dans des scripts externes. Ce fichier de sortie est une représentation exacte de la procédure de test qui a été modifiée depuis le logiciel.

Le code généré automatiquement pour la procédure de test ci-dessus figure à la page suivante. Comme vous pouvez le constater, tous les aspects liés à l’instanciation externe des composants Introspect sont gérés automatiquement.

Exportation manuelle des classes de composants

Les classes de composants ESP d’Introspect peuvent être instanciées dans des scripts Python externes en suivant les instructions fournies dans la note d’application :

Utilisation des composants dans des scripts Python externes.pdf

Cette note d’application se trouve dans le dossier « Doc » de l’installation d’Introspect ESP.

Conclusion

Grâce aux composants intégrés « PythonModule » et « TestAsPythonScript » du logiciel Introspect ESP, les utilisateurs peuvent désormais importer facilement des fonctions ou des modules Python externes dans leurs procédures de test et exporter des scripts destinés à une utilisation externe. Ce logiciel primé a permis d’améliorer l’efficacité des procédures de test de nombreux ingénieurs. Pour en savoir plus sur le logiciel Introspect ESP, cliquez ici.

Pour plus d’informations sur nos produits, veuillez contacter info@introspect.ca.