🐍 PyCharm – IDE Python, Debugging & Data Science

Structure de Fichiers

Quand vous créez un projet, PyCharm crée une structure de dossiers :

mon-projet/
  ├── .idea/
  │   └── (Fichiers de config de PyCharm.
  │        À mettre dans .gitignore)
  │
  ├── venv/
  │   └── (Dossier de l'environnement virtuel.
  │        Toujours mettre dans .gitignore)
  │
  ├── src/ (ou app/)
  │   └── (Vos fichiers .py, "Sources Root")
  │
  └── requirements.txt

"Content Roots" (Racines)

PyCharm doit savoir où se trouve votre code source (pour les imports). Vous pouvez marquer un dossier (ex: src) comme "Sources Root" (clic droit > Mark Directory as...).

Cela permet à PyCharm de résoudre les imports import my_module au lieu de import src.my_module.

Vues Principales (Tool Windows)

• 1. Project (Alt+1) : L'arbre de vos fichiers.
• 7. Structure (Alt+7) : Les méthodes/classes du fichier actuel.
• 9. Git (Alt+9) : L'interface de version control.
• 4. Debug (Alt+5) : Le débogueur.
• 6. Python Packages : Gérer vos paquets pip.

Fenêtre "Python Packages"

En bas (ou Alt+6), l'onglet "Python Packages" vous offre une interface graphique pour :

• Voir les paquets installés dans votre vEnv.
• Installer de nouveaux paquets (ex: requests, pandas) via une barre de recherche.
• Mettre à jour ou désinstaller des paquets.

requirements.txt

C'est le standard pour lister les dépendances.

# requirements.txt
django==4.2
requests==2.31

Quand PyCharm détecte ce fichier, il vous propose :

• Notification : "Install requirements" (installe tout ce qui est listé).
• Avertissement : Si vous installez un paquet (ex: numpy) via l'UI, PyCharm vous demandera si vous voulez l'ajouter à requirements.txt.

PyCharm supporte aussi Poetry (pyproject.toml) comme alternative moderne.

Lancement des Tests

PyCharm détecte les fichiers de test (ex: test_*.py ou *_test.py) et les fonctions (ex: def test_...).

Vous pouvez lancer les tests en cliquant sur l'icône "Play" (flèche verte) dans la marge, à côté :

• D'une fonction de test (lance ce test).
• D'une classe de test (lance cette classe).
• D'un fichier (lance tout le fichier).

La Fenêtre de Résultats

PyCharm ouvre une fenêtre dédiée aux tests :

• Liste arborescente des tests (Succès / Échec / Ignoré).
• (Vert) si tout passe, (Rouge) si échec.
• Permet de voir le "stdout" (print) et les "diff" d'assertions.
• Permet de relancer uniquement les tests échoués.

Vous pouvez également "Run with Coverage" (lancer avec couverture) pour voir quelles lignes de votre code ont été (ou non) exécutées par les tests.

Fenêtre "Database"

Une fenêtre d'outil (droite) "Database" vous permet de :

• Configurer des "Data Sources" (PostgreSQL, MySQL, SQLite, Oracle...).
• Naviguer dans les schémas, tables, vues.
• Modifier les données (clic droit > Edit Data).
• Générer des diagrammes E/R.

La "Query Console"

Vous pouvez ouvrir une "Query Console" pour exécuter du SQL.

• Auto-complétion SQL contextuelle (connaît vos tables/colonnes).
• Refactoring SQL.
• Exécution de requêtes (Ctrl+Entrée).
• Historique local.

Plugins (Marketplace)

Vous pouvez étendre PyCharm via File > Settings > Plugins.

Plugins Python populaires :

• Pylint : Intégration du linter Pylint.
• Black : Intégration du formateur de code Black.
• .env files support : Coloration pour les fichiers .env.

Plugins Généraux :

• Material Theme UI : Thèmes visuels.
• Key Promoter X : Vous apprend les raccourcis.

Terminal (Alt + F12)

PyCharm intègre un terminal (bash, zsh, PowerShell...).

Avantage : Il est "conscient" de votre vEnv. Quand vous l'ouvrez, il active automatiquement l'environnement virtuel du projet. Vous pouvez taper pip install ou python en étant certain d'utiliser le bon environnement.

Scratch Files (Brouillons)

Ctrl + Alt + Shift + Insert

Crée un fichier temporaire (ex: scratch.py) pour tester un petit bout de code sans l'ajouter au projet.

Top 10 (Indispensables)

1. Shift + Shift
   (Search Everywhere)

2. Alt + Entrée
   (Show Intentions / "Baguette Magique")

3. Ctrl + N
   (Go to Class)

4. Ctrl + Shift + N
   (Go to File)

5. Alt + F7
   (Find Usages)

6. Shift + F6
   (Rename / Refactor)

7. Ctrl + B
   (Go to Declaration)

8. F8
   (Step Over - Debug)

9. Ctrl + K
   (Commit - Git)

10. Ctrl + Espace
    (Basic Completion)

Édition & Refactor

Ctrl + W / Ctrl + Shift + W
(Extend / Shrink Selection)

Ctrl + D
(Duplicate Line)

Ctrl + Y
(Delete Line)

Ctrl + /
(Comment / Uncomment Line)

Ctrl + Alt + M
(Extract Method)

Ctrl + Alt + V
(Extract Variable)

Ctrl + Alt + L
(Reformat Code)

Navigation & Vues

Alt + 1
(Project View)

Alt + 5
(Debug View)

Alt + 9
(Git View)

Alt + F12
(Terminal)

Ctrl + E
(Recent Files)