Service de synthèse vocale sans serveur AWS (Python)

texte alternatif

Site de blogs

Coordonnées | [email protected]

Caractéristiques

Un service sans serveur qui prend les fichiers texte téléchargés dans un bucket, les convertit en MP3 et envoie le résultat à une adresse e-mail
Utilise Amazon Polly
Service Python sans serveur avec une structure de fichiers recommandée.
Pipelines CI/CD basés sur des actions Github avec des linters python, une analyse de code statique, des contrôles de complexité et des formateurs de style.
Dossiers de tests unitaires, d'intégration et E2E prêts à être mis en œuvre.

Il ne s'agit pas d'un code prêt pour la production mais plutôt d'un POC avancé.

Je l'utilise pour convertir le texte de mon blog en audio pour des raisons d'accessibilité.

Il télécharge n'importe quel fichier texte du dossier /text sur S3, les transforme en fichiers .mp3 et les renvoie à une adresse e-mail.

L'adresse e-mail est codée en dur dans le fichier service/logic/email.py et peut être modifiée.

Voici un aperçu approfondi de la conception : https://www.ranthebuilder.cloud/post/serverless-empowers-accessibility-convert-text-to-speech-with-amazon-polly

Important : assurez-vous d'autoriser SES à envoyer des e-mails à l'adresse e-mail que vous choisissez https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html

Qui m'a donné cette idée ?

J'ai eu l'idée de concevoir une solution pour moi-même après avoir vu cette excellente vidéo YouTube de Johannes Koch et Jimmy Dahlqvist.

Conception

Pour la conception du service et des informations complémentaires, consultez mon article de blog ici.

Architecture

texte alternatif

Flux d'événements :

Le fichier texte est téléchargé sur S3
Une fonction Lambda est déclenchée avec un événement « créer un objet ».
La fonction Lambda lit le fichier texte et utilise le wrapper AWS Polly pour démarrer une tâche de synthèse vocale polly qui enregistrera la sortie du compartiment d'origine sous forme de fichier .mp3.
La fonction Lambda attend la fin de la tâche en interrogeant l'état de la tâche
Une fois terminée, la fonction télécharge le fichier et l'envoie en pièce jointe à un e-mail à une adresse e-mail de votre choix.

Considérations de conception

Pourquoi utiliser la fonction Lambda ? Pourquoi pas une fonction étape ?

C'est certainement une amélioration, mais ce n'était qu'un rapide POC pour automatiser mes besoins personnels et fournir un exemple de code pour un article de blog.

Dans un code de production, vous devez utiliser une machine à états de fonction étape qui attend que la tâche soit terminée.

Pourquoi dois-je envoyer le fichier par e-mail, puisqu'il est déjà dans le bucket ?

Pour mes besoins, je souhaite télécharger le fichier mp3 sur mon site Web et le supprimer de mon compte AWS personnel. Vous pouvez modifier le comportement à votre guise.

Commencer

Conditions préalables

Docker - installez Docker. Requis pour le processus d’empaquetage de la couche Lambda.
AWS CDK - Requis pour la synthèse et le déploiement de la pile AWS Cloudformation.
Python10
poésie - Assurez-vous d'exécuter poetry config --local virtualenvs.in-project true afin que toutes les dépendances soient installées dans le dossier '.venv' du projet.
Pour les machines Windows, utilisez la version Makefile_windows (renommez-la en Makefile). Makefile par défaut est pour Mac/Linux.

Création d'un environnement de développement

Exécutez make dev
Exécuter poetry install

Déployer le CDK

Créez une pile cloudformation en exécutant make deploy .

Supprimer la pile

CDK destroy peut être exécuté avec make destroy .

Préparation du code pour les relations publiques

Exécutez make pr . Cette commande exécutera toutes les vérifications requises, les hooks de pré-commit, les linters, les formats de code, flake8 et les tests, afin que vous puissiez être sûr que le pipeline de GitHub réussira.

La commande corrige automatiquement les erreurs dans le code pour vous.

S'il y a une erreur lors de la phase de pré-validation, elle est automatiquement corrigée. Cependant, il est nécessaire d'exécuter à nouveau make pr pour qu'il passe aux étapes suivantes.

Assurez-vous de valider toutes les modifications que make pr effectue pour vous.

Construction dev/lambda_requirements.txt

lambda_requirements.txt

CDK nécessite un fichier Requirements.txt afin de créer un fichier zip avec les dépendances de la couche Lambda. Il est basé sur le fichier poésie.lock du projet.

La commande ``make déployer` le générera automatiquement pour vous.

dev_requirements.txt

Ce fichier est utilisé lors de GitHub CI pour installer toutes les bibliothèques Python requises sans utiliser de poésie.

Le contenu du fichier est créé à partir du Pipfile.lock.

make deploy les commandes make deps le génèrent automatiquement.

** Comment transformer un fichier texte en parole ?

Placez un fichier texte (.txt) dans le dossier /text. Déployez la pile CDK avec la commande 'make déployer'.

Il sera téléchargé dans un compartiment S3 et transformé en fichier mp3 qui vous sera envoyé par e-mail.

L'adresse e-mail est codée en dur et peut être trouvée dans le fichier service/logic/email.py.

Lorsque vous ajoutez un nouveau fichier : vous pouvez soit le télécharger directement dans le bucket, soit l'ajouter au dossier /text et exécuter « make deploy ».