Configuración del SDK de Python
Requisitos previos
Antes de comenzar a desarrollar la lógica de tu aplicación con el SDK de Python de Catalyst en tu entorno local, asegúrate de tener el siguiente administrador de paquetes y entorno de programación instalados en tu máquina local:
- Pip - Administrador de paquetes de Python
- Python versión 3.9 Puedes instalar Python desde su sitio web oficial y el administrador de paquetes pip se instalará automáticamente en tu sistema local. Asegúrate de instalar el paquete pip manualmente si instalas Python desde otras fuentes. Puedes consultar la documentación de instalación de pip para instalar pip.
Note: Si tienes otras versiones de Python instaladas en tu máquina local (cualquier versión que no sea Python 3.9), entonces la ejecución de las funciones de Python en tu directorio se omitirá cuando la aplicación esté siendo servida o desplegada. Estas funciones de Python también se excluyen cuando haces pull de las funciones desde la consola al CLI.
Si estás creando funciones de Python en un proyecto existente de Catalyst en tu directorio local, puedes instalar los requisitos previos mencionados anteriormente y proceder a configurar la función. Los pasos para configurar una función de Python en un directorio de proyecto existente se proporcionan en esta página de ayuda. Para aprender sobre la inicialización de una función de Python durante la inicialización del proyecto de Catalyst, consulta esta página de ayuda.
### Instalación del SDK Cuando inicializas un proyecto de Catalyst en el CLI y creas o configuras una función de Python en un directorio de proyecto existente en tu entorno local, el paquete del SDK de Python (zcatalyst-sdk) se instalará automáticamente dentro del directorio de funciones de tu proyecto actual. Un archivo de función principal y un archivo de configuración se generarán automáticamente con el código base en el directorio de tu función por defecto cuando creas una función Serverless de Catalyst de cualquier stack de programación. Para funciones de Python, también se creará un archivo adicional llamado requirements.txt. Este archivo contiene la lista de dependencias instaladas que se necesitan para implementar la función de Python. Por defecto, contiene la entrada para el paquete del SDK de Python de Catalyst (zcatalyst-sdk), cuando creas la función de Python desde el CLI. Cuando necesites instalar dependencias externas, deberás agregar el nombre de la dependencia manualmente en el archivo requirements.txt.
Note: Si es la primera vez que inicializas una función de Python, necesitarás configurar adicionalmente la información de ruta de Python instalado en tu sistema. Puedes configurar esta información en un archivo de configuración específico que está presente en tu sistema local como un archivo oculto. La ruta deberá configurarse usando el comando del CLI config:set <key=value>. Puedes obtener más información sobre este comando en esta página de ayuda.
Puedes usar el siguiente comando para instalar el SDK de Python de Catalyst globalmente en tu sistema:
copy
pip install zcatalyst-sdk
### Inicialización del SDK Después de que el SDK de Python esté instalado en el directorio de tu función, puedes comenzar a codificar la función de Python. Primero debes inicializar el SDK dentro del código de la función, usando el método initialize() para acceder a los componentes de Catalyst del proyecto actual. Los métodos de inicialización para los tipos de funciones de Catalyst se proporcionan a continuación: **Basic I/O Functions**
copy
import zcatalyst_sdk
def handler(context, basicio):
app = zcatalyst_sdk.initialize()
#Esta variable app se usa para acceder a los componentes de Catalyst.
#Tu lógica de negocio va aquí
Advanced I/O Functions
copy
import zcatalyst_sdk
def handler(request: Request):
app = zcatalyst_sdk.initialize()
#Esta variable app se usa para acceder a los componentes de Catalyst.
#Tu lógica de negocio va aquí
Event Functions
copy
import zcatalyst_sdk
def handler(event, context):
app = zcatalyst_sdk.initialize()
#Esta variable app se usa para acceder a los componentes de Catalyst.
#Tu lógica de negocio va aquí
Cron Functions
copy
import zcatalyst_sdk
def handler(cron_details, context):
app = zcatalyst_sdk.initialize()
#Esta variable app se usa para acceder a los componentes de Catalyst.
#Tu lógica de negocio va aquí
Cuando inicializas el paquete del SDK dentro de la función, devuelve un objeto Python como respuesta. Este objeto se puede usar para llamar a los métodos específicos del componente definidos en las clases de Python y acceder a los componentes de Catalyst requeridos.
Note : Puedes crear funciones de Python tanto desde la consola web como desde el CLI, según tu preferencia. Sin embargo, solo puedes subir el paquete de la función desde local y no puedes codificarlo directamente en la consola por ahora. Proporcionaremos soporte para editores en línea en el futuro.
### Inicialización con alcances Catalyst te permite inicializar el SDK en un proyecto usando los siguientes alcances: * **Admin**: Tienes acceso sin restricciones a todos los componentes y sus respectivas funcionalidades. Por ejemplo, tienes acceso completo al Data Store para realizar todas las operaciones como Read, Write, Delete, etc. * **User**: Puedes restringir el acceso a componentes y funcionalidades específicas. Por ejemplo, puedes proporcionar solo acceso de Read al Data Store.
Note:
* No es obligatorio que inicialices los proyectos con alcances. Por defecto, un proyecto que se inicializa tendrá privilegios de Admin. * Asegúrate de haber inicializado el SDK de Catalyst con el alcance apropiado mientras diseñas tu lógica de negocio. Los permisos que defines para tu alcance controlan las acciones de tu usuario final. * Para aprender más sobre los alcances de las operaciones del SDK que se pueden realizar en varios componentes, consulta la Tabla de alcances * Dependiendo de cómo diseñes tu lógica de negocio, puedes decidir si tus usuarios finales pueden realizar acciones de Admin o User. Esto se decide basándose en el rol asignado a tu usuario final cuando se registra en tu aplicación en Catalyst Authentication. Los permisos para los roles se pueden configurar en la sección Scopes & Permissions o Bucket Permissions de Data Store y Stratus respectivamente. * Catalyst Stratus es un nuevo componente de almacenamiento de objetos en modo Early Access. Este componente es una actualización significativa del componente actual Cloud Scale File Store. Puedes obtener más información sobre el componente Stratus aquí.
Para usar el componente Stratus en modo Early Access, envíanos un correo electrónico a support@zohocatalyst.com.
Los fragmentos del SDK a continuación te permitirán inicializar el SDK usando el alcance *Admin* o *User*:
**Admin Scope**
* No es obligatorio que inicialices los proyectos con alcances. Por defecto, un proyecto que se inicializa tendrá privilegios de Admin. * Asegúrate de haber inicializado el SDK de Catalyst con el alcance apropiado mientras diseñas tu lógica de negocio. Los permisos que defines para tu alcance controlan las acciones de tu usuario final. * Para aprender más sobre los alcances de las operaciones del SDK que se pueden realizar en varios componentes, consulta la Tabla de alcances * Dependiendo de cómo diseñes tu lógica de negocio, puedes decidir si tus usuarios finales pueden realizar acciones de Admin o User. Esto se decide basándose en el rol asignado a tu usuario final cuando se registra en tu aplicación en Catalyst Authentication. Los permisos para los roles se pueden configurar en la sección Scopes & Permissions o Bucket Permissions de Data Store y Stratus respectivamente. * Catalyst Stratus es un nuevo componente de almacenamiento de objetos en modo Early Access. Este componente es una actualización significativa del componente actual Cloud Scale File Store. Puedes obtener más información sobre el componente Stratus aquí.
Para usar el componente Stratus en modo Early Access, envíanos un correo electrónico a support@zohocatalyst.com.
copy
import zcatalyst_sdk
def handler(request: Request):
app = zcatalyst_sdk.initialize(scope='admin')
#Esta variable app se usa para acceder a los componentes de Catalyst.
#Puedes consultar la documentación del SDK para ejemplos de código.
#Tu lógica de negocio va aquí
User Scope
copy
import zcatalyst_sdk
def handler(request: Request):
app = zcatalyst_sdk.initialize(scope='user')
#Esta variable app se usa para acceder a los componentes de Catalyst.
#Puedes consultar la documentación del SDK para ejemplos de código.
#Tu lógica de negocio va aquí
Discutiremos sobre la actualización del SDK de Python en la siguiente sección.
Última actualización 2026-03-30 13:40:30 +0530 IST
Yes
No
Thank you for your feedback!
Send your feedback to us
Skip
Submit