methode-de-developpement-pour-python.md

<h2>Méthodologie de développement en langage Python</h2>

**Sommaire :**

- [Installation de l'environnement Python](#installation-de-lenvironnement-python)
- [Installez Pyenv-win dans PowerShell](#installez-pyenv-win-dans-powershell)
- [Installation d'un environnement virtuel pour chaque projet](#installation-dun-environnement-virtuel-pour-chaque-projet)
- [Activer votre environnement virtuel](#activer-votre-environnement-virtuel)
- [Installation des bibliothèques Python](#installation-des-bibliothèques-python)
- [Exécuter un programme Python](#exécuter-un-programme-python)

---

<br />

## Installation de l'environnement Python

Pour exécuter les scripts Python, vous devez disposer d'un environnement Python fonctionnel.

Plusieurs options s'offrent à vous pour installer Python sur votre ordinateur :

* Téléchargez et installez Python depuis le site officiel [Python.org](https://www.python.org/downloads/), c'est la méthode la plus simple, voir l'[utilisation de Python sur Windows](https://docs.python.org/fr/3.13/using/windows.html).
* Passez par l'environnement [Anaconda](https://www.anaconda.com/products/distribution) qui est une distribution de Python qui inclut de nombreuses bibliothèques utiles dans le monde scientifique, avec l'environnement de développement [Spyder](https://www.spyder-ide.org/) et [Qt Designer](https://www.qt.io/qt-for-python).
* Utiliser un gestionnaire de versions des distributions de Python, qui vous permettra de faire plusieurs installations de Python en parallèle. Voir [pyenv-win](https://github.com/pyenv-win/pyenv-win) qui est une version de pyenv pour Windows que j'utilise.

## Installez Pyenv-win dans PowerShell

Avant toute chose, sachez que `pyenv-win` a un léger train de retard sur les dernières versions de Python, par rapport à celle que vous trouverez directement sur le site officiel <https://www.python.org/downloads/>. Donc, si vous souhaitez installer la toute dernière version de ce langage, allez directement sur le site de Python. En bonus vous pouvez consulter la [documentation et Le tutoriel Python](https://docs.python.org/fr/3.13/tutorial/index.html) de la v`3.13.1`

Voici les étapes pour installer `pyenv-win` dans PowerShell :

1. Install `pyenv-win` in PowerShell.

   ```pwsh
   Invoke-WebRequest -UseBasicParsing -Uri "https://raw.githubusercontent.com/pyenv-win/pyenv-win/master/pyenv-win/install-pyenv-win.ps1" -OutFile "./install-pyenv-win.ps1"; &"./install-pyenv-win.ps1"
   ```

2. Reopen PowerShell
3. Run `pyenv --version` to check if the installation was successful.
4. Run `pyenv install -l` to check a list of Python versions supported by pyenv-win
5. Run `pyenv install <version>` to install the supported version
6. Run `pyenv global <version>` to set a Python version as the global version
7. Check which Python version you are using and its path

   ```plaintext
   > pyenv version
   <version> (set by \path\to\.pyenv\pyenv-win\.python-version)
   ```

8. Check that Python is working

   ```plaintext
   > python -c "import sys; print(sys.executable)"
   \path\to\.pyenv\pyenv-win\versions\<version>\python.exe
   ```

## Installation d'un environnement virtuel pour chaque projet

Je vous recommande de créer un environnement virtuel dédié à chaque projet. Cela vous permettra de gérer les dépendances indépendamment des autres projets et facilitera leur déploiement.

Pour cela, vous pouvez utiliser le module `venv` de Python avec la version de Python que vous avez installée, et qui est compatible avec votre projet et les versions des bibliothèques que vous utiliserez.

Pour créer un environnement virtuel, vous pouvez exécuter la commande suivante dans un terminal.

Cette commande crée un dossier `.env` dans le répertoire courant qui contiendra l'environnement virtuel Python pour l'exécution de votre projet :

```bash
python -m venv .env
```

## Activer votre environnement virtuel

Placez-vous dans le répertoire de votre projet, puis activez l'environnement virtuel que vous avez créé.

Exécutez la commande suivante dans un terminal pour l'activer :

```bash
`source .env/bin/activate` (sous Linux/macOS) ou `> .env\Scripts\activate` (sous Windows)
```

Une autre option est d'utiliser l'extension [Python pour Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-python.python), qui vous permet de sélectionner l'environnement virtuel à utiliser pour chaque projet.

## Installation des bibliothèques Python

Pour installer les bibliothèques nécessaires, vous pouvez utiliser le gestionnaire de paquets `pip`.

Pour cela, soit vous installez les bibliothèques une par une, soit vous utilisez le fichier `requirements.txt` fourni dans le projet.

Exécutez la commande suivante dans un terminal :

```bash
pip install -r requirements.txt
```

## Exécuter un programme Python

Vous êtes maintenant prêt à exécuter un programme python depuis un terminal ou l'environnement de développement de votre choix. Ma recommandation est d'utiliser [Visual Studio Code](https://code.visualstudio.com/).

Exemple d'exécution d'un programme Python depuis un terminal :

```bash
(.env) > python src\example.py
```