Saltar a contenido

Carpetas

folder = origin.get_folder("informes/2024")     # una referencia: no habla con el servicio
folder.path_str La ruta relativa a la raíz (informes/2024)
folder.name El último componente (2024)
folder.is_root Si es la raíz del origen
folder.exists() Si existe. Ante otro fallo (credenciales, red) lanza, no devuelve False
folder.get_metadata() Un FolderInfo: created, modified, extra

Listar ficheros

from datetime import datetime, timedelta

folder.list_files()                                           # los de esta carpeta
folder.list_files(recursive=True)                             # y los de sus subcarpetas
folder.list_files(pattern=r"\.xlsx?$")                        # por nombre
folder.list_files(pattern="ventas", modified_after=datetime.now() - timedelta(days=7))
Parámetro Qué hace
pattern Expresión regular buscada (re.search) en el nombre del fichero, sin distinguir mayúsculas. "ventas" encuentra Ventas_enero.csv; para la extensión, r"\.csv$"
recursive Incluir las subcarpetas
modified_after, modified_before Estrictos (> y <). Con o sin zona horaria; sin zona, hora local
created_after, created_before Igual, con la fecha de creación
  • El resultado va ordenado por ruta: con nombres que llevan la fecha (ventas_2024-01.csv), el orden es cronológico.
  • Cada fichero trae ya sus metadatos: file.size y file.modified_time no hacen más peticiones.
  • Un fichero cuyo servicio no da la fecha que se filtra no pasa el filtro.
  • Un patrón que no es una expresión regular válida es un InvalidRequestError con la solución.
for file in origin.get_folder("Clientes").list_files(pattern=r"\.csv$", recursive=True):
    print(f"{file.full_path:40} {file.size:>10} {file.modified_time:%d/%m/%Y %H:%M}")

Listar carpetas

folder.list_folders()                     # las subcarpetas directas, ordenadas
folder.list_folders(pattern=r"^20\d\d$")  # las que se llaman como un año

Crear y borrar

origin.get_folder("informes/2025/enero").create()          # crea también las intermedias
origin.get_folder("informes/2025/enero").create(parents=False)   # FolderNotFoundError si falta informes/2025

create() falla con FolderAlreadyExistsError si ya existe. Normalmente no hace falta llamarlo: escribir un fichero crea las carpetas que le falten.

folder.delete()                   # FolderNotEmptyError si tiene algo
folder.delete(recursive=True)     # con todo lo que contiene
  • La raíz del origen no se puede borrar (InvalidPathError).
  • En SharePoint, lo borrado va a la papelera del sitio. En el resto, es definitivo.
  • En Azure, una carpeta deja de existir al borrar su último fichero, y create() no hace nada (ver Azure).

Subir

from pathlib import Path

folder.upload_file(Path("/tmp/informe.pdf"), "informe.pdf")       # desde una ruta local, por trozos
folder.upload_file(b"id;importe\n1;10\n", "datos.csv")             # desde bytes
with open("grande.bin", "rb") as stream:
    folder.upload_file(stream, "grande.bin")                       # desde un stream binario
folder.upload_file(Path("informe.pdf"), "informe.pdf", overwrite=True)   # reemplazar

upload_file() no sobrescribe salvo overwrite=True: es lo que se quiere al subir un backup. Devuelve el File subido.

Un str es una ruta, no un contenido

folder.upload_file("informe.pdf", …) sube el fichero local informe.pdf. Para subir un texto como contenido, folder.get_file("a.txt").write_text("…").

Atajos

folder.get_file("enero.csv")         # = origin.get_file("informes/2024/enero.csv")
folder.get_folder("enero")           # una subcarpeta
folder.delete_file("enero.csv")      # = folder.get_file("enero.csv").delete()