Instalación¶
tai-storage necesita Python 3.10 o posterior. El paquete base trae el núcleo y el disco local. Cada servicio, y la lectura de DataFrames, va en su propio extra, para que un proyecto que solo usa SharePoint no instale el SDK de Azure.
pip install tai-storage # núcleo y disco local
pip install "tai-storage[sharepoint]" # + SharePoint Online
pip install "tai-storage[azure]" # + Azure Blob Storage, con clave o connection string
pip install "tai-storage[azure-identity]" # + Azure con una identidad de Azure AD, sin clave
pip install "tai-storage[googledrive]" # + Google Drive
pip install "tai-storage[data]" # + leer ficheros como DataFrames
pip install "tai-storage[analysis]" # + el informe HTML de un DataFrame
pip install "tai-storage[all]" # todo lo anterior
Se combinan: pip install "tai-storage[sharepoint,data]" es lo que suele necesitar un ETL.
Qué instala cada extra¶
| Extra | Dependencias | Para |
|---|---|---|
| — | tai-alphi, click |
El núcleo, el disco local, dev_mode, los logs y el CLI |
sharepoint |
httpx, msal |
SharePoint sobre Microsoft Graph |
azure |
azure-storage-blob |
Azure Blob Storage |
azure-identity |
azure-storage-blob, azure-identity |
Azure con identidad administrada o az login |
googledrive |
httpx, google-auth |
Google Drive con una cuenta de servicio |
data |
pandas, numpy, openpyxl, xlrd, pyarrow |
Leer ficheros como DataFrames |
analysis |
pandas, numpy, plotly, jinja2 |
El informe HTML |
all |
todo | — |
Con Python 3.10 se instala pandas 2; con 3.11 o posterior, pandas 3. La librería funciona igual con los dos.
Si falta un extra¶
import tai_storage no necesita ningún extra: cada servicio y el módulo de datos se importan
cuando se usan. Si falta el extra, el error dice qué instalar:
>>> from tai_storage import StorageFactory
>>> StorageFactory.create_sharepoint()
ImportError: SharePoint y Google Drive necesitan httpx. Instala: pip install 'tai-storage[sharepoint]' o 'tai-storage[googledrive]'
>>> file.get_data().to_dataframe()
ImportError: El módulo 'data' necesita el extra data (pandas no está instalado): pip install 'tai-storage[data]'
En un proyecto con Poetry¶
Pon techo a la versión
En la serie 0.x, una versión menor puede romper la compatibilidad (la 0.2 lo hizo: ver
De la 0.1 a la 0.2). >=0.2,<0.3 recibe los arreglos sin
cambios de comportamiento.
Reglas para el asistente del proyecto¶
Si en el proyecto trabajas con un asistente de IA, instala también las reglas de uso de la versión que tienes: