Carpetas¶
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.sizeyfile.modified_timeno 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
InvalidRequestErrorcon 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("…").