Crear una extensión en Cliq

Ahora puedes configurar la extensión en Cliq. Como se mencionó en la introducción, esta extensión de Cliq agrupará todos los componentes de desarrollo que necesitaremos para esta configuración. Puedes obtener información detallada sobre las extensiones de Cliq en la documentación de ayuda de Cliq.

Agregaremos los siguientes componentes de Cliq para agruparlos en la extensión:

• Comando para issues: Un comando gestionado por la clase command_handler.py que obtiene los últimos diez issues abiertos en un repositorio específico.
• Comando para commits: Un comando gestionado por la clase command_handler.py que obtiene los últimos diez commits realizados en un repositorio específico.
• Función de botón para autenticar el token del webhook: Una función gestionada por la clase function_handler.py que se ejecuta cuando se hace clic en un botón del chat bot. Esta función autentica el token del webhook para GitHub.
• Bot de GitHub: Un chat bot gestionado por la clase bot_handler.py que te permite ejecutar estos comandos. El bot también incluye una acción de menú que lista tus repositorios existentes y te permite seleccionar un repositorio para ejecutar un comando.

Asegúrate de seguir los pasos a continuación para configurar la extensión de Cliq:

1. Inicia sesión en tu cuenta de Cliq y abre la consola de desarrollo de Cliq. Haz clic en Create Extension.

2. Ingresa el nombre de la extensión como “GitHubExt” e introduce una descripción como se muestra en la captura de pantalla a continuación.

Selecciona el tipo de ejecución como Catalyst Function. Elige tu organización en la que creaste el proyecto en este paso. Selecciona el proyecto GitHubBot y la función git_hub_bot_function de la lista desplegable. Esto permite que la extensión invoque la función cada vez que se accede a cualquiera de los componentes de la extensión.

Ahora podemos proceder a agregar los componentes que necesitaremos para esta extensión.

Selecciona el proyecto de Catalyst GitHubBot que creamos para este tutorial y la función GithubExtension de las listas desplegables. Esto permite que la extensión invoque la función cada vez que se accede a cualquiera de los componentes de la extensión.

Ahora podemos agregar los componentes que necesitaremos para esta extensión.

3. Haz clic en Add components y luego en Command.

4. Ingresa el nombre del comando como “issues”. Proporciona una pista para el comando como se muestra en la descripción a continuación.

En la sección Command Handlers, elige Attachments, Chat, Location y User para el Execution Handler. Habilita el Suggestion Handler y permite el acceso para Chat, Location y User. Configura el comando para que se ejecute al seleccionar solo una sugerencia. Haz clic en Add.

5. De manera similar, haz clic en el botón Add components en la configuración de la extensión nuevamente y luego en Command. Proporciona el nombre del comando como “commits”. Asegúrate de implementar la misma configuración que la del comando de issues aquí también. Haz clic en Add.

6. A continuación, agregaremos un componente Function. Proporciona el nombre de la función como “authenticate”. Escribe una descripción para la función como se muestra en la captura de pantalla a continuación.

Selecciona el Function Type como Button y haz clic en Add.

7. Finalmente, agregaremos un componente de Bot y configuraremos el nombre como “GitHub Bot”. Escribe una descripción como se muestra en la captura de pantalla a continuación.

Habilita Channel Participation y selecciona tanto Listen to messages como Send messages.

Habilita todos los handlers y selecciona todas las casillas de verificación habilitadas. Esto permitirá que el bot reconozca los mensajes en el chat y las solicitudes de webhook recibidas de GitHub.

También debes agregar una acción de menú del bot Repos que liste y seleccionar todas las casillas de verificación.

Se han agregado todos los componentes necesarios para la extensión de Cliq.

8. Haz clic en Create Extension en la página de configuración de la extensión y la extensión creada se listará en la consola de desarrollo de Cliq en la sección Cliq Extensions.

El bot de Cliq ahora estará disponible en tu cuenta de Cliq. Los comandos issues y commits, junto con la acción de menú Repos, funcionarán en el bot.

Antes de probar estos comandos, también debes habilitar las alertas para que se reciban automáticamente cada vez que se haga un push de un commit a uno de los repositorios en la cuenta de GitHub mediante un webhook.