Installer des packages Python dans FME Form

Il peut arriver qu'un script Python nécessite l'utilisation de paquets Python non inclus dans FME. Comme FMElivre le système de gestion de paquets pip avec son interpréteur Python, il est possible d'installer ces paquets Python pour les utiliser dans FME avec pip.

Utiliser pip pour installer un package Python

Exécutez la commande suivante :

Windows: fme.exe python -m pip install <package_name>
Linux: ./fme python -m pip install <package_name> --system

Note Selon la distribution Linux, --system peut être requis ou doit être exclu.

macOS: ./fme python -m pip install <package_name>

<nom_package> est le nom du package Python à installer.

Note Lors de l'utilisation de la commande pip, il y a un avertissement concernant la version de pip. Cet avertissement peut être ignoré.

Emplacements d'installation par défaut

Par défaut, les commandes précédentes installent aux emplacements suivants :

Windows: C:\Users\<user>\Documents\FME\Plugins\Python\python<version>

Note Remplacer <utilisateur> avec le nom d'utilisateur Windows.

Linux: ~/.fme/Plugins/Python/python<version>
macOS: ~/Library/Application\ Support/FME/Plugins/Python/python<version>

<version> est le numéro majeur et le numéro mineur de la version de l'interpréteur Python utilisée par FME ; par exemple, 312 pour Python 3.12. Pour vérifier la version de l'interpréteur Python utilisée par FME, exécutez la commande :

Windows: fme.exe python --version
Linux: ./fme python --version
macOS: ./fme python --version

Note Pour modifier l'interpréteur Python utilisé par FME pour l'installation des paquets Python, définissez l'option Interpréteur Python préféré.

L'interprète Python chargé par FME a l'emplacement correspondant à la version ajouté à son chemin Python, de sorte que tous les modules à l'intérieur de cet emplacement peuvent être trouvés. Par exemple, sous Windows, lorsque FME charge un interpréteur Python 3.12, FME ajoute le chemin suivant au chemin Python de l'interpréteur :

C:\Users\<user>\Documents\FME\Plugins\Python\python312

Changer l'emplacement d'installation par défaut (avancé)

Il peut arriver que vous souhaitiez installer un paquetage Python à un autre emplacement que celui par défaut.

Pour spécifier un emplacement, utilisez l'argument ---target :

Windows: fme.exe python -m pip install <package_name> --target <package_destination_folder>
Linux : ./fme python -m pip install <nom_package> --system --target <dossier_destination_package>
macOS: ./fme python -m pip install <nom_package> --target <dossier_destination_package>

<package_destination_folder> est le dossier dans lequel installer le paquetage Python.

Par exemple, lors de l'installation d'un paquetage Python universel, vous pouvez vouloir le rendre disponible pour tous les interpréteurs Python possibles utilisés par FME.

Note Il y a deux types de packages Python :

Paquets universels contenant uniquement des fichiers .py qui fonctionnent avec différentes versions de Python.
Paquets non universels qui contiennent des fichiers liés à des versions spécifiques de Python. En général, ces paquets contiennent des binaires tels que des fichiers .pyd ou .dll.

Pour rendre un paquetage Python universel disponible pour tous les interprètes possibles, définissez <package_destination_folder> :

Windows : C:\Users\<user>\Documents\FME\Plugins\Python
Linux : ~/.fme/Plugins/Python
macOS : ~/Library/Application\ Support/FME/Plugins/Python

Note Ce chemin est ajouté pour tous les interprètes Python chargés par FME.