Servicio de texto a voz sin servidor de AWS (Python)

texto alternativo

sitio web de blogs

Datos de contacto | [email protected]

Características

Un servicio sin servidor que toma archivos de texto cargados en un depósito, los convierte a MP3 y envía el resultado a una dirección de correo electrónico.
Utiliza Amazon Polly
Servicio Python Serverless con una estructura de archivos recomendada.
Canalizaciones de CI/CD basadas en acciones de Github con linters de Python, análisis de código estático, comprobaciones de complejidad y formateadores de estilo.
Carpetas de pruebas unitarias, de integración y E2E listas para su implementación.

Este no es un código listo para producción, sino más bien una prueba de concepto avanzada.

Lo uso para convertir el texto de mi blog en audio por razones de accesibilidad.

Carga cualquier archivo de texto en la carpeta /text a S3, los convierte en archivos .mp3 y los envía de regreso a una dirección de correo electrónico.

La dirección de correo electrónico está codificada en el archivo service/logic/email.py y se puede cambiar.

Aquí hay una inmersión profunda en el diseño: https://www.ranthebuilder.cloud/post/serverless-empowers-accessibility-convert-text-to-speech-with-amazon-polly

Importante: asegúrese de habilitar SES para enviar correos electrónicos a la dirección de correo electrónico que elija https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html

¿Quién me dio esta idea?

Me inspiré para diseñar una solución después de ver este excelente video de YouTube de Johannes Koch y Jimmy Dahlqvist.

Diseño

Para conocer el diseño del servicio y obtener más información, consulte la publicación de mi blog aquí.

Arquitectura

texto alternativo

Flujo de eventos:

El archivo de texto se carga en S3
Una función Lambda se activa con un evento de "creación de objeto".
La función Lambda lee el archivo de texto y utiliza el contenedor AWS Polly para iniciar una tarea de texto a voz de Polly que guardará la salida del depósito de origen como un archivo .mp3.
La función Lambda espera a que se complete la tarea sondeando el estado de la tarea
Una vez completada, la función descarga el archivo y lo envía como un archivo adjunto de correo electrónico a una dirección de correo electrónico de su elección.

Consideraciones de diseño

¿Por qué uso la función Lambda? ¿Por qué no una función escalonada?

Definitivamente es una mejora, pero fue solo una prueba de concepto rápida para automatizar mis necesidades personales y proporcionar un ejemplo de código para una publicación de blog.

En un código de producción, debe utilizar una máquina de estado de función de paso que espere hasta que se complete la tarea.

¿Por qué envío el archivo por correo electrónico si ya está en el depósito?

Para mis necesidades, quiero cargar el archivo mp3 a mi sitio web y eliminarlo de mi cuenta personal de AWS. Puede modificar el comportamiento como desee.

Empezando

Requisitos previos

Docker : instala Docker. Requerido para el proceso de envasado de capas Lambda.
AWS CDK : necesario para sintetizar e implementar la pila de AWS Cloudformation.
Pitón 10
poesía: asegúrese de ejecutar poetry config --local virtualenvs.in-project true para que todas las dependencias se instalen en la carpeta '.venv' del proyecto.
Para máquinas basadas en Windows, utilice la versión Makefile_windows (cambie el nombre a Makefile). El Makefile predeterminado es para Mac/Linux.

Crear un entorno de desarrollador

Ejecute make dev
Ejecute poetry install

Implementar CDK

Cree una pila de formación en la nube ejecutando make deploy .

Eliminando la pila

CDK destroy se puede ejecutar con make destroy .

Preparando código para PR

Ejecute make pr . Este comando ejecutará todas las comprobaciones necesarias, enlaces previos a la confirmación, linters, formatos de código, flake8 y pruebas, por lo que puede estar seguro de que la canalización de GitHub pasará.

El comando corrige automáticamente los errores en el código.

Si hay un error en la etapa de confirmación previa, se soluciona automáticamente. Sin embargo, es necesario ejecutar make pr nuevamente para que continúe con las siguientes etapas.

Asegúrese de realizar todos los cambios que make pr por usted.