# python: Stockage local des traductions
URL: https://generaltranslation.com/fr/docs/python/guides/local-tx.mdx
---
title: Stockage local des traductions
description: Stockez les traductions localement au lieu de les charger depuis un CDN
---

## Que sont les traductions locales ?

Par défaut, les bibliothèques Python de GT récupèrent les traductions depuis le CDN de General Translation à l’exécution. Avec les traductions locales, vous incluez les fichiers de traduction dans votre application — aucune requête réseau externe n’est nécessaire.

<Callout>
  **Comportement par défaut :** GT utilise le stockage sur CDN par défaut. Ne passez au stockage local que si vous avez besoin des avantages spécifiques qu’il offre.
</Callout>

## Arbitrages

### Avantages des traductions locales

* **Réponses plus rapides** : aucun aller-retour réseau pour récupérer les traductions
* **Aucune dépendance à des services externes** : votre application fonctionne sans dépendre de la disponibilité du CDN
* **Fonctionne hors ligne** : les traductions font partie de votre deployment

### Inconvénients des traductions locales

* **Taille du deployment plus importante** : chaque paramètre régional pris en charge ajoute des fichiers de traduction
* **Nouveau deployment requis pour les mises à jour** : modifier une traduction nécessite un nouveau deployment

## Configuration

### Étape 1 : Configurer la CLI

Installez la CLI de GT et configurez-la pour le stockage local :

```bash
pip install gtx-cli
gt configure
```

Lorsque vous y êtes invité :

* **Enregistrer sur le CDN ?** Sélectionnez &quot;Non&quot;
* **Répertoire des traductions :** Saisissez `./translations`

### Étape 2 : Générer les traductions

```bash
gt translate
```

Cela crée des fichiers JSON dans votre répertoire `translations/` — un pour chaque paramètre régional.


### Étape 3 : Charger les traductions dans votre application

Configurez votre application pour qu’elle utilise les fichiers de traduction locaux :

<Tabs items={['Flask', 'FastAPI']}>
  <Tab value="Flask">
    ```python
    import json
    from pathlib import Path
    from flask import Flask
    from gt_flask import initialize_gt

    app = Flask(__name__)

    def load_translations(locale: str):
        path = Path('translations') / f'{locale}.json'
        if path.exists():
            return json.loads(path.read_text())
        return {}

    initialize_gt(
        app,
        default_locale='en',
        locales=['es', 'fr', 'ja'],
        load_translations=load_translations,
    )
    ```
  </Tab>

  <Tab value="FastAPI">
    ```python
    import json
    from pathlib import Path
    from fastapi import FastAPI
    from gt_fastapi import initialize_gt

    app = FastAPI()

    def load_translations(locale: str):
        path = Path('translations') / f'{locale}.json'
        if path.exists():
            return json.loads(path.read_text())
        return {}

    initialize_gt(
        app,
        default_locale='en',
        locales=['es', 'fr', 'ja'],
        load_translations=load_translations,
    )
    ```
  </Tab>
</Tabs>

## Intégration du build

Générez les traductions dans votre pipeline de deployment :

```yaml title=".github/workflows/deploy.yml"
- name: Generate Translations
  run: gt translate

- name: Deploy
  run: <YOUR_DEPLOY_COMMAND>
```

Ou dans un `Makefile` :

```makefile
deploy:
	gt translate
	<YOUR_DEPLOY_COMMAND>
```

<Callout>
  Générez toujours les traductions avant d’implémenter. Si des fichiers de traduction sont manquants, `t()` utilise la chaîne source de votre `default_locale`.
</Callout>


## Prochaines étapes

* [Commande CLI `translate`](/docs/cli/translate) — référence pour la génération de traductions
* [Approches de traduction de chaînes](/docs/python/guides/strings) — comment traduire du contenu
* [Détection du paramètre régional et middleware](/docs/python/guides/middleware) — comment fonctionne le contexte du paramètre régional