PyCharm (parcours avancé)

PyCharm est un IDE complet de JetBrains. Tu n’en as pas besoin pour te lancer avec Pgzero ou Pygame, mais si tu veux continuer à progresser comme programmeur, c’est un pas utile. Pense à un débogueur intégré, à la complétion de code intelligente et à de puissants outils de refactoring.

Quand changer ?

Continue simplement à travailler avec Thonny tant que ça te va bien. N’envisage PyCharm que si tu veux :

  • inspecter des variables pendant que ton code est en pause (débogueur),
  • renommer rapidement des fonctions ou des variables dans tout ton projet (refactoring), ou
  • une autocomplétion qui connaît aussi les types de tes variables.

Pour les débutants et la plupart des sessions de la dojo, Thonny est largement suffisant.

Installer PyCharm Community

Télécharge l’édition Community gratuite sur jetbrains.com/pycharm. Choisis Community, pas Professional. Professional est payant et tu n’en as pas besoin.

  1. Va sur la page de téléchargement et clique sur Community-Free.
  2. Lance le programme d’installation et garde tous les réglages par défaut.
  3. Démarre PyCharm. Tu ne dois pas créer de compte JetBrains.

Créer un nouveau projet et configurer l’interpréteur

Quand tu démarres PyCharm pour la première fois, tu choisis New Project.

PyCharm 2024.1 ou plus récent avec uv :

Si tu as déjà uv sur ton système (voir le guide Thonny), PyCharm le reconnaît automatiquement. Choisis dans Python version l’option 3.13, 3.14 ou 3.15 et laisse PyCharm créer un environnement uv.

Version plus ancienne ou sans uv avec venv :

  1. Choisis comme Interpreter type l’option Virtualenv.
  2. Sélectionne dans Base interpreter l’installation de Python sur ton système (le plus souvent python3 ou python3.x).
  3. Laisse la case Create a main.py welcome script cochée ou décoche-la. Ça n’a pas d’importance.

Clique ensuite sur Create. PyCharm crée l’environnement et ouvre le projet.

Installer des paquets

Tu installes pgzero, pygame-ce et pygbag via les réglages :

  1. Ouvre File → Settings (sur macOS : PyCharm → Preferences).
  2. Va dans Project: <nom> → Python Interpreter.
  3. Clique en bas à droite sur l’icône +.
  4. Cherche pgzero dans le champ de recherche et clique sur Install Package. Fais de même pour pygame-ce et pygbag.
  5. Ferme la fenêtre quand les trois sont terminés.

Vérifie que tout a réussi : à droite dans la liste, tu vois maintenant pgzero, pygame-ce et pygbag avec leurs numéros de version.

Remarque

Le bouton Install Package pour pgzero ne fonctionne pas sur Python 3.14 ou 3.15 ? C’est parce que pgzero entraîne l’ancien pygame. Utilise alors le terminal intégré avec uv add pgzero pygame-ce et mets [tool.uv] exclude-dependencies = ["pygame"] dans ton pyproject.toml. Voir aussi Installer Thonny + Pgzero.

Configuration d’exécution pour Pgzero

Pgzero fonctionne autrement qu’un script Python normal : tu le démarres comme un module et tu passes le nom de ton fichier comme argument.

  1. Clique en haut sur Add Configuration… (ou ouvre Run → Edit Configurations…).
  2. Clique sur l’icône + et choisis Python.
  3. Remplis :
    • Name : Pgzero
    • Run : mets le choix sur Module name (pas Script path)
    • Module name : pgzero
    • Parameters : main.py
    • Working directory : le dossier de ton projet (s’il est encore vide, clique sur l’icône de dossier et choisis ton dossier de projet)
  4. Clique sur OK.

Sélectionne ensuite la configuration Pgzero dans le menu déroulant en haut et appuie sur le bouton vert de lecture pour lancer ton jeu.

Configuration d’exécution pour Pygame

Pygame, tu le démarres bien comme un script normal :

  1. Ouvre à nouveau Run → Edit Configurations… et clique sur + → Python.
  2. Remplis :
    • Name : Pygame
    • Run : laisse le choix sur Script path
    • Script path : navigue jusqu’à main.py dans ton dossier de projet
    • Working directory : ton dossier de projet
  3. Clique sur OK.

Choisis la configuration Pygame dans le menu déroulant et appuie sur le bouton de lecture.

Voilà. Tu as maintenant deux configurations d’exécution prêtes à l’emploi : une pour les jeux Pgzero et une pour les jeux Pygame. Change simplement de configuration dans le menu déroulant en haut selon ce que tu es en train de construire.

Astuces utiles

  • Utiliser le débogueur : place un point d’arrêt en cliquant à gauche d’un numéro de ligne (point rouge). Démarre ensuite ta configuration avec le bouton bug au lieu du bouton de lecture. PyCharm met en pause à cette ligne pour que tu puisses regarder tes variables.
  • Import automatique : si PyCharm souligne en rouge un nom que tu viens d’écrire, appuie sur Alt+Enter pour ajouter automatiquement la bonne instruction import en haut.
  • Terminal : en bas, tu peux ouvrir un terminal intégré (View → Tool Windows → Terminal). Pratique pour uv add ou pour exécuter pygbag et publier.