Saltar a contenido

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=False no 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

  • modified es la fecha de modificación del fichero, en UTC.
  • created es la de creación donde el sistema la da (st_birthtime en macOS y Windows). En Linux es st_ctime, el último cambio de metadatos.
  • etag es mtime_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()