DESCRIPTION.

Renomme un fichier ou un répertoire, en complétant éventuellement l’arborescence du nouvel emplacement.

SYNTAXE.

os.renames ( source , destination )

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

source ⇨ emplacement à renommer [ OBLIGATOIRE ]

destination ⇨ nouvelle désignation [ OBLIGATOIRE ]

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.

L'appel de la méthode os.renames ( ) peut lever 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.rename ( ) pour renommer simplement un emplacement, sans tentative complétion.

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/Travail/votrefichier.ext" # indiquez un fichier inexistant

os.renames ( ksource , knouveau )