Premier projet

8.1 Analyse de l'interface de l'IDE

Alors, on a créé un nouveau projet. Voyons un peu ce qu'on a devant nous.

1. Arborescence des dossiers et fichiers du projet :

Ici, c'est le contenu du dossier de notre projet – pythonProject.

2. Le fichier actuellement ouvert :

C'est juste le contenu du fichier main.py, la syntaxe du code est mise en surbrillance.

3. En haut — le menu principal :

Boutons utiles en haut à droite :

• « Triangle vert » — bouton pour lancer le projet.
• « Bug » — bouton pour démarrer le mode debug.
• « Loupe » — recherche dans le projet.
• « Roue dentée » — paramètres.

4. À gauche, vous voyez le menu latéral :

Il y a plusieurs boutons utiles, notamment le bouton Terminal.

5. Barre de statut :

À gauche de la barre de statut, c'est le chemin du fichier actuellement ouvert. À droite — son codage : CRLF, UTF-8.

Et tout à fait à droite, c'est la version actuelle de Python — Python 3.12.x, sur laquelle notre projet s'exécutera. C'est pratique de jeter un œil ici si vous avez plusieurs versions différentes de Python installées sur votre ordinateur et il y a des projets qui tournent sur d'autres versions.

8.2 Analyse du projet

Un projet standard se compose de fichiers affichés dans le panneau de gauche. Ces fichiers peuvent être divisés conditionnellement en 4 parties.

Fichiers de code Python. Ces fichiers ont l\'extension .py et PyCharm les marque avec une icône bleue et jaune. Dans notre projet, il n\'y a actuellement qu\'un seul fichier de ce type — main.py

Fichiers statiques. C\'est ainsi qu\'on appelle les fichiers qui contiennent des données, mais pas de code. Il peut s\'agir de fichiers texte, d\'images, de fichiers multimédias, etc. Pour l\'instant, il n\'y en a pas dans notre projet.

Environnement virtuel Python. Le dossier nommé .venv (abréviation de Virtual Environment) contient les fichiers Python, ainsi que plusieurs utilitaires de service. C\'est également ici que le gestionnaire de paquets pip téléchargera les bibliothèques tierces que vous voudrez utiliser.

Bibliothèques tierces (External libraries). Il n\'y en a pas dans notre projet pour le moment, mais lorsque vous les téléchargerez, PyCharm les affichera certainement ici.

8.3 Environnement virtuel .venv

Parlons un peu plus en détail de l\'environnement virtuel. .venv est un module en Python qui offre la possibilité de créer différents environnements virtuels légers et isolés pour les projets Python. C\'est un outil qui permet de gérer les dépendances du projet en les isolant des bibliothèques système. Imaginez que c\'est une pièce isolée pour votre projet, où il peut garder ses jouets et outils personnels sans déranger les autres habitants de la maison.

Techniquement, cela fonctionne simplement : une copie de l\'interpréteur Python et un espace séparé pour les bibliothèques sont créés dans le dossier du projet. Cela garantit que si vous installez une version spécifique d\'une bibliothèque pour un projet, elle ne cassera pas un autre projet qui a besoin d\'une version plus ancienne. L\'utilisation d\'un environnement virtuel est une règle de bonne conduite qui sauve des conflits de versions interminables.

Gestion de l\'environnement dans PyCharm

PyCharm s\'occupe généralement de cela lui-même et crée tout automatiquement. Mais il arrive que vous ayez supprimé accidentellement le dossier nécessaire ou que vous vouliez simplement repartir de zéro. Savoir gérer ces paramètres manuellement est une compétence utile.

Création d\'un environnement

Dans le coin inférieur droit s\'affiche l\'état de la connexion du langage Python. Si vous y voyez une inscription comme Python 3.XX, cela signifie que l\'installation a réussi. L\'environnement de développement voit l\'interpréteur et est prêt à exécuter vos commandes.

S\'il est écrit No interpreter, cliquez sur cette inscription.

1. Dans le menu qui apparaît, sélectionnez Add New Interpreter puis Add Local Interpreter.
2. Dans les paramètres à gauche, sélectionnez Environment. Au centre, assurez-vous que la case Generate New est cochée.
3. Appuyez sur OK. L\'éditeur créera un nouveau dossier .venv et basculera immédiatement le projet dessus. Vous avez maintenant un système absolument propre sans déchets inutiles.

Suppression de l\'ancien ou de l\'inutile

Parfois, les expériences mènent à une impasse, et il est plus simple de supprimer l\'environnement que d\'essayer de le réparer. Voici comment faire :

1. Cliquez à nouveau sur la version Python dans le coin inférieur droit et sélectionnez l\'élément Interpreter Settings.
2. En haut, cherchez le champ Python Interpreter. Déroulez la liste et sélectionnez l\'élément Show All.
3. Vous verrez une liste de tous les environnements que PyCharm connaît. Sélectionnez celui que vous voulez supprimer et appuyez sur le bouton avec le moins dans le menu au-dessus de la liste.
4. Point important : PyCharm va simplement « oublier » cet environnement et cesser de l\'utiliser. Pour libérer physiquement de l\'espace sur le disque, vous devez aller dans le dossier du projet via l\'explorateur habituel et supprimer le dossier .venv manuellement.

Création d\'un deuxième environnement

Erreur : « Already contains Python »

Si vous allez dans le menu d\'ajout d\'interpréteur et sélectionnez Generate new, PyCharm peut afficher un avertissement rouge et bloquer le bouton OK. Cela se produit parce que l\'éditeur, par habitude, essaie de créer un nouvel environnement dans le même dossier .venv qui est déjà occupé par votre premier environnement. Deux ensembles de bibliothèques différents ne peuvent pas cohabiter dans un seul dossier.

Comment corriger cela

Il suffit de donner au nouveau « bac à sable » un nom unique. Voici comment faire :

1. Ouvrez le menu Add Local Interpreter, comme nous l\'avons fait auparavant.
2. Sélectionnez l\'élément Generate new.
3. Regardez le champ Location. Il est fort probable que le chemin se termine par le nom standard \.venv.
4. Placez le curseur à la fin de la ligne et ajoutez simplement n\'importe quel chiffre. Changez la fin du chemin en \.venv_2 et appuyez sur Enter.
5. L\'inscription rouge disparaîtra immédiatement. Appuyez sur OK.

Maintenant, deux dossiers différents avec des paramètres existeront physiquement dans votre projet, et PyCharm basculera automatiquement vers la nouvelle version.

Comment basculer entre les environnements

Savoir jongler avec les environnements est une compétence importante. Mais il y a un piège : PyCharm ne se souvient pas toujours automatiquement de vos anciens environnements.

Il arrive souvent que vous ayez créé un deuxième environnement, et que le premier ait disparu du menu, bien que le dossier .venv soit toujours dans le projet. Dans ce cas, il suffit d\'indiquer à PyCharm où chercher l\'ancien Python. Exemple pour basculer de .venv_2 à .venv :

1. Cliquez sur la version Python dans le coin et sélectionnez Add New Interpreter -> Add Local Interpreter.
2. Dans la fenêtre qui apparaît, basculez le point sur Select Existing.
3. Dans le champ Python Path, cliquez sur l\'icône de dossier à droite.
4. Maintenant, vous devez trouver le fichier de lancement Python dans votre ancien dossier (.venv). Suivez le chemin : Votre_projet -> .venv -> Scripts (pour Windows) ou bin (pour macOS/Linux).
5. À l\'intérieur de ce dossier, sélectionnez le fichier python et appuyez sur OK.

L\'ancien environnement apparaîtra à nouveau dans les paramètres et deviendra actif. Cette méthode fonctionne sans faille, même si PyCharm a « oublié » vos paramètres.

8.4 Travailler avec le terminal

Dans PyCharm, vous pouvez travailler directement avec la ligne de commande de votre système d'exploitation. En Linux et MacOS, la ligne de commande est généralement appelée Terminal, donc dans PyCharm aussi, ça s'appelle comme ça. Ce n'est pas un caprice de PyCharm, mais un nom établi parmi les développeurs.

Pour ouvrir le Terminal vous devez cliquer sur le bouton terminal dans le menu latéral :

Vous devriez voir apparaître cette fenêtre :

Dans cette fenêtre, vous pouvez taper des commandes de votre système d'exploitation. Mais une seule nous intéresse.

Voyons quelle est la version actuelle de l'interpréteur Python que nous avons installée. Pour cela, il faut écrire :

        python --version

Voilà ce que j'obtiens :

Si vous obtenez aussi Python 3.12.x, alors vous êtes sur la bonne voie.