Saltar a contenido

Variables de entorno

StorageFactory.create_* lee del entorno lo que no se pasa como argumento, en el momento de la llamada. Un argumento manda sobre su variable. Si falta una obligatoria, el error dice cuál definir.

tai-storage no carga ficheros .env: importar la librería no lee el entorno ni el disco. Si tu proyecto usa un .env, cárgalo antes de crear el origen:

from dotenv import load_dotenv
from tai_storage import StorageFactory

load_dotenv()
origin = StorageFactory.create_sharepoint()

Local

Variable Obligatoria Qué es
STORAGE_LOCAL_ROOT_PATH si no se pasa root_path La carpeta raíz

SharePoint

Variable Obligatoria Qué es
SHAREPOINT_TENANT_ID sí El tenant de Azure AD (Directory (tenant) ID)
SHAREPOINT_CLIENT_ID sí La aplicación registrada (Application (client) ID)
SHAREPOINT_CLIENT_SECRET sí El secreto de la aplicación
SHAREPOINT_HOSTNAME sí contoso.sharepoint.com
SHAREPOINT_SITE_NAME sí El nombre del sitio en su URL (/sites/<nombre>)
SHAREPOINT_DRIVE no La biblioteca de documentos, por su nombre. Por defecto, la principal

site_path (sites o teams) no tiene variable: se pasa como argumento.

Azure Blob Storage

Variable Obligatoria Qué es
AZURE_STORAGE_CONNECTION_STRING esta, o las dos siguientes La connection string de la cuenta. Si está, manda sobre las demás
AZURE_STORAGE_ACCOUNT_NAME sin connection string El nombre de la cuenta
AZURE_STORAGE_ACCOUNT_KEY sin connection string Su clave
AZURE_STORAGE_CONTAINER no El container que hace de raíz

Con una identidad de Azure AD (account_url=), no hace falta ninguna: ver Azure.

Google Drive

Variable Obligatoria Qué es
GOOGLE_DRIVE_CREDENTIALS_PATH sí El JSON con la clave de la cuenta de servicio
GOOGLE_DRIVE_ROOT_FOLDER_ID no La carpeta raíz. Por defecto root, donde una cuenta de servicio no puede subir
GOOGLE_DRIVE_DRIVE_ID no La unidad compartida de la raíz

Leer un secreto en tu código

SecretManager es lo que usa la factoría. Sirve para lo mismo en tu proyecto:

from tai_storage import SecretManager

token = SecretManager.get_secret(None, "API_TOKEN", description="el token de la API del cliente")
# ConfigurationError si no está: «Falta el token de la API del cliente. Solución: Pásalo como argumento o define API_TOKEN=… …»

drive = SecretManager.get_secret(None, "SHAREPOINT_DRIVE", required=False)   # None si no está