Local¶
El disco, con las mismas reglas que los servicios remotos. Es lo que conviene usar en los tests de un proyecto: lo que funciona en local funciona igual en SharePoint.
from tai_storage import StorageFactory
origin = StorageFactory.create_local("/datos") # o STORAGE_LOCAL_ROOT_PATH=/datos
origin = StorageFactory.create_local("datos") # relativa al directorio de trabajo
| Argumento | Variable | Por defecto | Qué es |
|---|---|---|---|
root_path |
STORAGE_LOCAL_ROOT_PATH |
— | La raíz |
create |
— | True |
Crear la raíz al conectar si no existe |
auto_connect |
— | True |
Conectar ya |
dev_mode, dev_cache_path |
— | — | La caché, rara vez útil en local |
Lo que garantiza¶
- Ninguna ruta sale de la raíz, ni con
..ni a través de un enlace simbólico. Un enlace que apunta fuera no aparece en los listados. - Toda escritura es atómica: se escribe en un temporal de la misma carpeta, se sincroniza a disco y se renombra. Un proceso que se corta a mitad de escribir un backup no deja un fichero corrupto con el nombre bueno.
overwrite=Falseno tiene carrera: el fichero final se enlaza solo si no existe, sin un hueco entre comprobar y escribir.- Reemplazar un fichero conserva sus permisos.
file = origin.get_file("backups/db.dump")
file.write_from(Path("/tmp/db.dump"), overwrite=False) # atómico; falla si ya existe
file.local_path # la ruta absoluta en el disco
Fechas y etag¶
modifiedes la fecha de modificación del fichero, en UTC.createdes la de creación donde el sistema la da (st_birthtimeen macOS y Windows). En Linux esst_ctime, el último cambio de metadatos.etagesmtime_ns-tamaño: cambia cuando cambia el fichero.
Construirlo a mano¶
from tai_storage import LocalOrigin
origin = LocalOrigin("/datos") # no toca el disco
origin.connect() # FolderNotFoundError si /datos no existe
LocalOrigin("/datos", create=True).connect() # la crea
Ejemplo: un backup rotado¶
from pathlib import Path
from tai_storage import StorageFactory
backups = StorageFactory.create_local("/var/backups/app").get_folder("diarios")
backups.upload_file(Path("/tmp/app_20261001.dump"), "app_20261001.dump")
viejos = backups.list_files(pattern=r"\.dump$")[:-7] # ordenados por ruta: los más antiguos primero
for file in viejos:
file.delete()