os

Interaction avec le système d’exploitation : chemins, dossiers, fichiers et variables d’environnement.

Sur cette page

Exemple

#
Python
import os

path = os.path.join("cours", "python", "lecon_01.py")

print(path)
print(os.path.basename(path))
print(os.path.dirname(path))
print(os.path.splitext(path)[1])
print(os.path.exists("fichier_inexistant.txt"))
Résultatrésultat enregistré, vous pouvez le vérifier
cours/python/lecon_01.py
lecon_01.py
cours/python
.py
False

Résultat pour Linux et macOS. Sous Windows, os.path.join() utilisera des antislashs : cours\python\lecon_01.py.

Définition et utilisation

#

Le module os permet à un programme d’utiliser les fonctions du système d’exploitation de façon que le même code fonctionne sous Windows, Linux et macOS. Vous y trouverez des fonctions pour lister les dossiers (listdir()), créer et supprimer des dossiers (makedirs(), rmdir()), supprimer et renommer des fichiers (remove(), rename()) et lire le dossier courant (getcwd()).

Le sous-module os.path sert aux opérations sur les chemins écrits sous forme de chaînes. join() assemble les parties d’un chemin avec le séparateur adapté au système, basename() et dirname() séparent le nom du fichier du dossier, splitext() retire l’extension, et exists() vérifie si un fichier existe.

Le dictionnaire os.environ contient les variables d’environnement, où l’on garde la configuration et les secrets, par exemple l’adresse d’une base de données. Pour les chemins eux-mêmes, dans du nouveau code, le module pathlib est plus pratique, car il traite un chemin comme un objet.

Syntaxe

#
Syntaxe
import os

os.path.join(partie, …)
os.path.exists(chemin)
os.listdir(dossier)
os.makedirs(dossier, exist_ok=True)
os.environ.get(nom, defaut)

Plus d’exemples

#
Dossiers et fichiers
Python
import os

os.makedirs("projet/assets", exist_ok=True)
with open("projet/plan.txt", "w", encoding="utf-8") as file:
    file.write("Apprendre Python")

print(sorted(os.listdir("projet")))

os.rename("projet/plan.txt", "projet/plan_etude.txt")
print(sorted(os.listdir("projet")))

os.remove("projet/plan_etude.txt")
print(sorted(os.listdir("projet")))
Résultatrésultat enregistré, vous pouvez le vérifier
['assets', 'plan.txt']
['assets', 'plan_etude.txt']
['assets']

Le résultat suppose que le dossier projet n’existait pas auparavant. Grâce à exist_ok=True, une nouvelle exécution ne lèvera pas d’erreur.

Variables d’environnement
Python
import os

mode = os.environ.get("CODEWORLDS_MODE", "development")
debug = os.getenv("CODEWORLDS_DEBUG") == "1"

print(mode, debug)
Résultatrésultat enregistré, vous pouvez le vérifier
development False

Résultat lorsque les variables CODEWORLDS_MODE et CODEWORLDS_DEBUG ne sont pas définies. Dans un terminal Linux ou macOS, vous pouvez les définir ainsi : CODEWORLDS_DEBUG=1 python app.py.

Bonnes pratiques

#
  • Ne collez pas les chemins avec + et des barres obliques. os.path.join() ou pathlib insèrent le séparateur adapté au système.
  • Gardez les mots de passe et les clés d’API dans des variables d’environnement, et non dans le code, et lisez-les avec os.environ.get().
  • os.remove() supprime un fichier immédiatement et définitivement, sans passer par la corbeille.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.