Python,-gestion-des-versions-de-Python-des-paquets-(en-construction).md

@@ -6,19 +6,32 @@ On va donc ici exposer quelques bases, rappeler comment les chemins d'accès aux
 _Mots_clefs _: : installation, pip et conda, versions,
 à venir 
 -  environnement virtuel, requirements.txt, module poetry
-- Lexique : module, bibliothèque (/library), paquet(/package)
+- Lexique : module, bibliothèque (/library), paquet(/package), dépendance
 
 :construction_worker: :construction: ATTENTION, pages en restructuration
 
 </details>![Capture_PythonInterpreter](uploads/c5d2d3ebd14cecd20db408cbf2f892cd/Capture_PythonInterpreter.JPG)
 
-1. Installer Python et ses bibliothèques : classique ou conda ?
+1. Première installation de Python et ses bibliothèques : classique ou conda ?
 (à compléter)
 
-<details>
-<summary>rappels, comment installer une librairie</summary>
- Cas général, en ligne de commande : $ pip install ma_librairie Avec Anaconda ou miniconda : $ conda install ma_librairie update conda Avec un IDE, par exemple PyCharm : aller dans Files / Settings / Project / Python Interpreter ; cliquez sur le "+" en haut à gauche.
-</details>
+
+Comment installer Python :
+- Cas général, installer la dernière version stable depuis le site **python.org** 
+- Avec [Anaconda ou miniconda](https://www.anaconda.com/distribution/) : Anaconda est une distribution de Python qui comprend l'essentiel des modules utiles en sciences dans des versions compatibles entre elles : numpy, matplotlib, scipy, Jupyter Notebook...  Elle offre en outre des outils spécifiques pour installer et gérer les autres bibliothèques et les environnements virtuels. L'inconvénient est de vous charger avec des tas de modules dont vous n'aurez peut-être jamais besoin ; miniconda peut être une alternative intéressante. 
+
+>> un exemple de bibliothèque qu'on ne peut quasiment installer qu'avec conda : GeoPandas. Cette bibliothèque puissante génère des conflits avec d'autres pour des question de version des dépendances (= modules dont elle a besoin).
+
+Pour commencer, téléchargez la distribution Anaconda correspondant à votre système d’exploitation, en Python version 3 : https://www.anaconda.com/distribution/
+
+Comment installer une librairie sous Windows
+- Cas général, en ligne de commande : $ pip install ma_librairie 
+- Avec Anaconda ou miniconda : $ conda install ma_librairie update conda 
+- Avec un IDE, par exemple PyCharm (voir capture d'écran ci-dessus): dans Files / Settings / Project / Python Interpreter ; cliquez sur le "+" en haut à gauche.
+
+
+##2. Upgrader et gérer les versions
+
 
 Pour vérifier quelles bibliothèques sont installées, et en quelle **version**, vous pouvez donc consulter la liste depuis votre IDE ou taper en ligne de commande **pip freeze**. Attention, si vous voulez mettre à jour une librairie existante, il ne suffit pas de refaire la manip d'installation, il faut préciser que vous voulez l'upgrader.
 
@@ -35,14 +48,21 @@ La solution :
 * savoir ce que l'on fait, et avec quelle version de Python on travaille
 * recourir systématiquement aux **environnements virtuels**, malgré leur nom ce sont des "installations locales" 
 
-Quelques ressources :
+
+##3. Définir et travailleur dans un environnement virtuel
+
+## 4. Distribuer un code en précisant toutes les dépendances
+
+## Quelques ressources :
 
 - tuto du site [Pypi](https://packaging.python.org/tutorials/installing-packages/) qui met à disposition un catalogue de paquets
 - une fois de plus, le cours de [X. Garrido, section gérer son environnement](https://xgarrido.github.io/licence_python_teaching/pdf/01_slide_environnement.pdf)
 - [Python Doctor, en français](https://python.doctor)
 - [OpenClassRoom](https://openclassrooms.com/fr/courses/6951236-mettez-en-place-votre-environnement-python/7013349-decouvrez-les-paquets-python)
 
-### point de vocabulaire : script, module, paquets, ajouter enironnements virtuels\*\*...
+
+
+### point de vocabulaire : script, module, paquets, ajouter environnements virtuels\*\*...
 
 Un **script** est un programme sauvegardé dans un fichier **mon_code.py** (par opposition à des instructions tapées dans la console, qui seront perdues...). Quand votre programme va grossir, vous avez intérêt à structurer votre code en plusieurs fichiers, et éventuellement à utiliser du code déjà écrit dans d'autres fichiers \*.py. Vous pouvez alors importer les fonctions et/ou les variables de ces codes, considérés comme **modules**. Il faut que ces fichiers \*.py soient dans le même répertoire que votre script, ou dans un répertoire connu par Python dont la liste est le Python PATH, voir [ce tuto](https://python.doctor/page-python-path-pythonpath). Le plus simple est de les gérer avec votre IDE dans un même "projet", et dans le même répertoire, surtout si vous travaillez à plusieurs : si vous oubliez d'envoyer un des fichiers le code sera inutilisable...