# pyenv

Modifier l'environnement par défaut de l'interpréteur Python.

## 📝 Syntaxe

* pyenv
* pe = pyenv('Version', python\_path)
* pe = pyenv(...)

## 📥 Argument d'entrée

* python\_path - une chaîne ou un vecteur de caractères : nom de l'exécutable Python ou version (sous Windows).

## 📤 Argument de sortie

* pe - objet PythonEnvironment.

## 📄 Description

Utilisez pyenv pour modifier la version par défaut ou le mode d'exécution de l'interpréteur Python, en veillant à ce que ces réglages persistent entre les sessions Nelson.

La valeur définie par pyenv est persistante entre les sessions Nelson.

Propriétés :

Version : string : version de Python

Executable : string : nom de l'exécutable Python

Library : string : fichier de bibliothèque partagée

Home : string : dossier home

Status : statut du processus : "NotLoaded" (par défaut), "Loaded", "Terminated"

ExecutionMode : mode d'exécution : "InProcess" (par défaut) ou "OutOfProcess"

Utilisez des variables d'environnement pour forcer l'environnement Python au démarrage (utile pour snapcraft ou distribution docker) :

**NELSON\_PYTHON\_VERSION** : exemple "3.10"

**NELSON\_PYTHON\_EXECUTABLE** : exemple "/usr/bin/python3"

**NELSON\_PYTHON\_LIBRARY** : exemple "libpython3.10.so.1.0"

**NELSON\_PYTHON\_HOME** : exemple "/usr"

Toutes les variables d'environnement doivent exister et être valides pour être prises en compte.

Sous Windows, la fonction pyenv('Version', '3.11') recherche dans le Registre Windows la version de Python associée à la version spécifiée. Elle recherche d'abord dans HKCU, puis dans HKLM si non trouvée.

## 💡 Exemples

```matlab
pe = pyenv
```

```matlab
if ispc()
pe = pyenv('Version', '3.12')
end
```

## 🔗 Voir aussi

[pyrun](https://nelson-9.gitbook.io/nelson/markdown/fr/python_engine/pyrun).

## 🕔 Historique

| Version | 📄 Description                                    |
| ------- | ------------------------------------------------- |
| 1.3.0   | version initiale                                  |
| 1.4.0   | environment variables to force python environment |
| 1.4.0   | On Windows find python by Windows registry.       |
