diff --git a/README.md b/README.md index 6e93beee06d6b28c010c88447f484fb319913eb3..eb5fc5a72a5ef4d34d2d5f60537e18c6093a4a8f 100644 --- a/README.md +++ b/README.md @@ -3,9 +3,9 @@ **Bienvenue dans ce référentiel !** Vous trouverez ici une collection de liens vers mes projets Python développés au sein du service commun d'électronique. - [Objectifs](#objectifs) -- [Structure](#structure) +- [Lien vers mes projets](#lien-vers-mes-projets) - [Contribution](#contribution) -- [📄 Licence](#-licence) +- [Licence](#licence) --- @@ -14,12 +14,12 @@ ## Objectifs * Exploration de projets Python par des retours d'expérience à travers une veille technologique -* Explication de ma méthodologie de travailler avec Python +* [Explication de ma méthodologie de travail pour développer en Python][link_methodo_dev_py] -## Structure +## Lien vers mes projets * [Premier partage autour de la lecture des données de multimètres numériques de chez Keysight][link_multimeters_py] -* [Partage d'un scripts pour la recherche de valeurs de résistances pour un pont diviseur de tension][link_resistor_calculator_py] +* [Partage d'un script pour la recherche de valeurs de résistances pour un pont diviseur de tension][link_resistor_calculator_py] * Prochainement, partage de scripts pour la communication avec des cartes d'acquisition de données ## Contribution @@ -32,22 +32,26 @@ N'hésitez pas à contribuer à ce référentiel en : **Contact:** -Vous pouvez me contacter par mail à l'adresse [arnauld.biganzoli[at]laplace.univ-tlse.fr](mailto:arnauld.biganzoli@laplace.univ-tlse.fr?subject=Contact%20projets%20Python%20du%20GitLab%20Koda%20du%20SCE) +Vous pouvez me contacter par mail à l'adresse [arnauld.biganzoli[at]laplace.univ-tlse.fr](mailto:arnauld.biganzoli@laplace.univ-tlse.fr?subject=Contact%20pour%20projets%20Python%20sur%20le%20GitLab%20du%20SCE) -## 📄 Licence +## Licence -Ce projet est sous licence [CeCILL-C](https://cecill.info/licences/Licence_CeCILL-C_V1-fr.html) - -image::https://img.shields.io/badge/License-CeCILL--C-blue.svg[link="https://cecill.info/licences/Licence_CeCILL-C_V1-fr.html", alt="License CeCILL-C", title="License CeCILL-C"] +<!--  -->  -Copyright (c) 2025 LAPLACE, UMR INP-UPS-CNRS N°5213 +**Copyright (c) 2025 LAPLACE, UMR INP-UPS-CNRS N°5213** + +Ce projet est sous licence [GNU GPLv3](https://www.gnu.org/licenses/quick-guide-gplv3.fr.html) + +🆠_La GNU GPLv3 vous garantit la liberté d'utilisation, de modification et de distribution de ce projet, à l'exception de distribuer des versions à code source fermé._ + +Merci de consulter le fichier [LICENCE](LICENSE) pour plus d'informations. --- <!-- Retrouvez ce projet sur le GitLab du service commun d'électronique : --> +[link_methodo_dev_py]: https://src.koda.cnrs.fr/laplace-service-commun-electronique/membres/arnauld-biganzoli/python/gitlab-profile/-/blob/main/docs/methode-de-developpement-pour-python.md [link_multimeters_py]: https://src.koda.cnrs.fr/laplace-service-commun-electronique/membres/arnauld-biganzoli/python/visa-communication-with-digital-multimeters - [link_resistor_calculator_py]: https://src.koda.cnrs.fr/laplace-service-commun-electronique/membres/arnauld-biganzoli/python/calculateur-de-resistances-pour-pont-diviseur-de-tension diff --git a/docs/methode-de-developpement-pour-python.md b/docs/methode-de-developpement-pour-python.md index 0cf30a467dff034896bd2da64ba0916403ab51ec..3a563f61e5ecddccdd330eec5e4eee8a42d9f658 100644 --- a/docs/methode-de-developpement-pour-python.md +++ b/docs/methode-de-developpement-pour-python.md @@ -1,8 +1,9 @@ -<h2>Méthodologie de developpement en langage Python</h2> +<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) @@ -16,19 +17,48 @@ Pour exécuter les scripts Python, vous devez disposer d'un environnement Python fonctionnel. -La version de Python recommandée pour ces scripts est la version `3.12.5` - Plusieurs options s'offrent à vous pour installer Python sur votre ordinateur : -* Télécharger et installer Python depuis le site officiel [Python.org](https://www.python.org/downloads/). -* Passer par l'environnment [Anaconda](https://www.anaconda.com/products/distribution) qui est une distribution de Python qui inclut de nombreuses bibliothèques utiles dans le monde scientifique. -* Utiliser un gestionnaire des versions 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 ici. +* 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 -Pour chaque projet, je vous recommande de créer un environnement virtuel dédié. Cela vous permettra de gérer les dépendances de chaque projet de manière indépendante. +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, est qui est compatible avec votre projet et les versions des bibliothèques que vous utiliserez. +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. @@ -40,7 +70,7 @@ 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éé. +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 : @@ -64,7 +94,7 @@ pip install -r requirements.txt ## Exécuter un programme Python -Vous êtes maintenant prêt à éxé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/). +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 : diff --git a/images/Python-3.13.1-Setup-64-bit-img01.png b/images/Python-3.13.1-Setup-64-bit-img01.png new file mode 100644 index 0000000000000000000000000000000000000000..35cb4015f360f4266f65cb799d92aaa248f5fff5 Binary files /dev/null and b/images/Python-3.13.1-Setup-64-bit-img01.png differ diff --git a/images/Python-3.13.1-Setup-64-bit-img02.png b/images/Python-3.13.1-Setup-64-bit-img02.png new file mode 100644 index 0000000000000000000000000000000000000000..ad9f430a4300cd3bd995c75432973c93487a2710 Binary files /dev/null and b/images/Python-3.13.1-Setup-64-bit-img02.png differ