Saltar a contenido

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

[project]
dependencies = [
    "tai-storage[sharepoint,data]>=0.2,<0.3",
]

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:

tai-storage rules install

Ver Reglas para asistentes.