DESCRIPTION.

Crée un répertoire, un dossier.

SYNTAXE.

os.mkdir ( chemin , mode , * , descripteur )

os.mkdir ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

chemin ⇨ emplacement à créer [ OBLIGATOIRE ]

mode ⇨ valeur du maque [ optionnel ]

descripteur ⇨ identifiant du descripteur [ optionnel ]

REMARQUES.

chemin doit être un str ( ), ou un bytes ( ), identifiant un nom de répertoire valide. chemin peut être exprimé en : 

- chemin absolu, par exemple, sous Linux, "/home/origine/Documents" ;

- chemin relatif, par exemple, sous Linux, "./Programmes" pour le dossier Programmes dans le répertoire de travail actuel.

Si chemin existe déjà, ou si l'un de ses composants parents, est absent, l'appel de la méthode os.mkdir ( ) fera levée une exception à Python.

mode doit être un int ( ), souvent exprimé sous forme octale, qui déterminera les permissions par complétion de 0o0666 (438 en décimal) pour les fichiers et de 0o0777 (511 en décimal), valeur par défaut, pour les répertoires qui seront créés ultérieurement par les appels systèmes creat() et mkdir(), c'est-à-dire que les permissions seront obtenues par l'opération binaire 0o0777 (ou 0o0666) AND NOT masque. Autrement dit, les bits du masque sont annulés, ce qui signifie que les droits correspondant à ces bits sont supprimés.

mode ne sera pris en compte que sur les système qui l'accepte, et sera simplement ignoré sur les autres. Quand il est utilisé, il lui est premièrement appliqué le masque courant umask. Si des bits autres que les 9 derniers sont activés (c.-à-d. les 3 derniers chiffres de la représentation octale de mode), leur signification sera dépendante de la plate-forme. Sous certaines plate-formes, ils seront ignorés et vous devrez appeler explicitement os.chmod ( ) pour les modifier.

descripteur est un attribut nommé par dir_fd = valeur, où valeur doit être un int ( ) identifiant un descripteur de fichier valide, ou None, valeur par défaut. descripteur n'est disponible que pour UNIX et la plupart des Linux. Son utilisation sous d'autres OS, tel que Windows de Microsoft, lèvera une exception. 

Voir la méthode os.makedirs ( ) pour créer un nouveau répertoire, et les éléments manquants de son arborescence parentes si besoin.

Voir la méthode tempfile.mkdtemp ( ), du module tempfile de la bibliothèque standard, pour la création de répertoires temporaires.

EXEMPLE.

import os

print ( os.getcwd ( ) , "est le répertoire de travail actuel." )

print ( )

print ( "Entrez le nom du nouveau répertoire de travail" )

krepertoire = input ( "? " )

try :

os.chdir ( krepertoire )

except :

print ( "Désolé ce répertoire n'est pas valide." )

kchoix = input ( "Voulez-vous le créer (O ou N )" )

if kchoix in ( "o" , "O" ) :

os.mkdir ( krepertoire )

os.chdir ( krepertoire )

print ( "Nouveau répertoire créé." )

else :

print ( "Abandon de la procédure." )

print ( )

print ( os.getcwd ( ) , "est le répertoire de travail actuel." )