Automatisation de la création de documents Word avec Python et FastAPI (à l'aide de python-docx-template)

Besoin de créer des documents Word avec un contenu dynamique et d'automatiser le processus ? Python, avec la bibliothèque python-docx-template, propose une solution efficace. Ce didacticiel montre comment générer dynamiquement des documents Word, éliminant ainsi le besoin de mises à jour manuelles.

Illustrons avec un exemple de facture. La mise à jour manuelle des données de facturation est fastidieuse et peu pratique lorsqu'il s'agit de données provenant d'API. La génération dynamique résout ce problème.

Envisagez un modèle de document Word :

Les détails de l'entreprise et les listes d'articles changent fréquemment. La génération dynamique gère cette variabilité.

Pour y parvenir, modifiez le modèle pour la compatibilité Jinja2. Les fonctionnalités de création de modèles de Jinja2 (rendu conditionnel, bouclage) permettent un remplissage dynamique basé sur les données fournies.

• En savoir plus sur Jinja2 : https://www.php.cn/link/7ef6c2494e3925e414c7730d6455b50f

Le modèle compatible Jinja2 ressemble à ceci :

La syntaxe

Jinja2 (par exemple, {% if %} et {% for %}) peut sembler complexe au départ, mais elle offre un contrôle puissant. Les expressions entre {{ }} représentent des variables renseignées au moment de l'exécution. Par exemple, {% if items %} vérifie si la variable items existe avant de restituer les lignes du tableau. {% for item in items %} parcourt la liste items, générant une ligne pour chaque élément.

• En savoir plus sur les balises Jinja2 : https://www.php.cn/link/a3a8185b610d2c5e39015f64972c8705 et https://www.php.cn/link/7ef6c2494e3925e414c7730d6455b50f

Maintenant, créons un serveur FastAPI pour afficher le modèle à l'aide de Python.

1. Créez un environnement virtuel :

   <code class="language-bash">pip3 install virtualenv
   virtualenv -p python3 venv
   source venv/bin/activate</code>

2. Installer les bibliothèques :

   <code class="language-bash">pip install "fastapi[standard]" docx docxtpl pydantic requests</code>

3. Créer main.py : Commencez avec un point de terminaison FastAPI de base :

   <code class="language-python">from fastapi import FastAPI
   app = FastAPI()
   @app.get("/")
   def read_root():
       return {"Hello": "World"}</code>

   L'accès à localhost:8000 devrait renvoyer {"Hello": "World"}.

4. Importez le modèle Jinja2 : Placez votre invoice_tpl.docx modifié à la racine du projet.

5. Améliorer main.py : Le code suivant gère le rendu du modèle, la récupération des images et le calcul du montant total :

   <code class="language-bash">pip3 install virtualenv
   virtualenv -p python3 venv
   source venv/bin/activate</code>

6. Testez le point de terminaison : Envoyez une charge utile JSON (similaire à l'exemple dans le texte original) au / point de terminaison.

7. Exemples de sortie : (Les images du texte original seraient incluses ici)

Conclusion : Ce didacticiel illustre la génération dynamique de documents Word à l'aide de python-docx-template et FastAPI. La combinaison de Jinja2 et FastAPI crée un système flexible pour automatiser la création de documents. Un prochain article de blog (Partie 2) couvrira la génération de PDF.

Dépôt : https://www.php.cn/link/1df146af0948a68b1342ce39907668fe

Suivez Husein Kantarci :

• Portfolio personnel : huseink.dev
• LinkedIn : https://www.php.cn/link/50de294b9d4987a3c89b4a5cc4bdea62
• GitHub : https://www.php.cn/link/f2f9990bcda13be8771d656bf489dad5
• GitLab : https://www.php.cn/link/33bd1b801b3cf1b8eaf31d816bca2c95

N'oubliez pas de remplacer les URL des images d'espace réservé par les URL des images réelles. Le code suppose également que vous avez défini les modèles de données nécessaires (Company, BankInformation, Item, VatInformation, InvoiceContext) comme dans l'exemple d'origine.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!