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á