DESCRIPTION.

Renomme un fichier ou un répertoire.

SYNTAXE.

os.rename ( source , destination , * , original , cible )

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

source ⇨ emplacement à renommer [ OBLIGATOIRE ]

destination ⇨ nouvelle désignation [ OBLIGATOIRE ]

* ⇨ autres options [ optionnel ]

original ⇨ descripteur de la source [ optionnel ]

cible ⇨ nouveau descripteur [ optionnel ]

REMARQUES.

source doit être un str ( ) identifiant de façon absolue ou relative le chemin d'un fichier, ou d'un répertoire, existant.

destination doit être un str ( ) valide pour désigner, de façon absolue ou relative, le chemin d'un fichier, ou d'un répertoire.

original est un attribut nommé par src_dir_fd = valeur, où valeur doit être un int ( ) identifiant un descripteur de fichier ou de répertoire ouvert, ou None, valeur par défaut.

cible est un attribut nommé par des_dir_fd = valeur, où valeur doit être un int ( ) identifiant un descripteur de fichier ou de répertoire, ou None, valeur par défaut. 

L'appel de la méthode os.rename ( ) lèvera une exception si : 

- source n'existe pas ;

- destination est un fichier existant ou un répertoire non vide ;

- source et destination sont sur des systèmes de fichier différents, sous Windows ;

- source et destination sont sur des systèmes de fichier différents, sous certains dérivés de UNIX ;

- source est un nom de fichier mais que destination s'apparente à un nom de répertoire ;

- source est un nom de répertoire mais que destination s'apparente à un nom de fichier ;

- source est un nom de répertoire mais que destination est déjà un répertoire non vide ;

- l'utilisateur n'a pas les droits d'accès suffisant, sous certains dérivés de UNIX.

original et cible ne sont disponibles que pour UNIX et la plupart des Linux. Son utilisation sous d'autres OS, tel que Windows de Microsoft, pourrait lever une exception. 

Voir la méthode os.renames ( ) pour tenter de créer ou de compléter, si besoin, l’arborescence de destination.

Voir la méthode os.replace ( ) pour renommer source en destination, en écrasant destination s'il existe déjà.

Voir la méthode shutil.move ( ), du module shutil de la bibliothèque standard, pour déplacer un fichier, ou un répertoire, vers un système de fichier différent.

EXEMPLE.

import os

ksource = "/home/login/Documents/votrefichier.txt" # indiquez un fichier existant

knouveau = "/home/login/Documents/nouveaunom.ext" # indiquez un fichier inexistant

os.rename ( ksource , knouveau )