Cómo renombrar archivos y directorios en Python con os.rename() – Guía paso a paso

Cómo renombrar archivos y directorios en Python con os.rename() – Guía paso a paso

Renombrar archivos y directorios en Python

La función os.rename() de Python proporciona una forma simple y multiplataforma de renombrar archivos o directorios. Ya sea que estés limpiando convenciones de nombres o actualizando activos de proyecto, dominar este método es esencial para un manejo de archivos eficiente.

Sintaxis

os.rename(origen, destino)

Parámetros

origen: La ruta existente del archivo o directorio que deseas renombrar. Debe existir antes de la llamada.

destino: La nueva ruta (o solo el nuevo nombre si se queda en el mismo directorio). Será el nuevo nombre del archivo o directorio.

Ejemplo

import os
os.rename('guru99.txt', 'carrera.guru99.txt')

En este ejemplo, el archivo original guru99.txt se renombra a carrera.guru99.txt dentro del mismo directorio.

• Usa os.rename() para renombrar guru99.txt a carrera.guru99.txt.
• Tras la ejecución, el nuevo archivo aparece junto al original en el explorador de archivos.

Código completo funcional

import os
from os import path

def main():
    # Asegurar que el archivo origen existe
    if path.exists('guru99.txt'):
        # Resolver ruta absoluta (opcional)
        origen = path.realpath('guru99.txt')
        # Realizar el renombrado
        os.rename('guru99.txt', 'carrera.guru99.txt')

if __name__ == "__main__":
    main()

Manejo de errores

Siempre protege contra errores potenciales como FileNotFoundError o PermissionError. Envolver la llamada a rename en un bloque try/except asegura que tu script falle graciosamente:

try:
    os.rename(origen, destino)
except FileNotFoundError:
    print(f"Archivo origen {origen} no encontrado.")
except PermissionError:
    print("Permiso denegado.")
except Exception as e:
    print(f"Error inesperado: {e}")