# General Translation Python SDKs: ContextVarStorageAdapter
URL: https://generaltranslation.com/fr/docs/python/reference/classes/context-var-storage-adapter.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Adaptateur de stockage par défaut des variables de contexte pour le paramètre régional des requêtes dans General Translation Python. Référence API de ContextVarStorageAdapter.

Le [`StorageAdapter`](/docs/python/reference/classes/storage-adapter) par défaut pour le paramètre régional de la requête, qui s’appuie sur un `contextvars.ContextVar`. Il fonctionne aussi bien dans des contextes multithreadés (Flask) qu’asynchrones (FastAPI), en donnant automatiquement à chaque requête son propre paramètre régional isolé.

## Vue d’ensemble [#overview]

[`I18nManager`](/docs/python/reference/classes/i18n-manager) utilise cet adaptateur, sauf si vous fournissez un `store_adapter` personnalisé. Il est rare que vous ayez à l’instancier vous-même.

```python
from gt_i18n import ContextVarStorageAdapter, I18nManager

manager = I18nManager(default_locale="en", store_adapter=ContextVarStorageAdapter())
```

Importez `ContextVarStorageAdapter` depuis `gt_i18n`. Il n’est pas réexporté par les packages du framework.

## Fonctionnement [#how-it-works]

* **Variable de contexte.** Elle stocke le paramètre régional dans une `ContextVar` au niveau du module, afin que des requêtes concurrentes ne voient pas le paramètre régional les unes des autres.
* **Clé `"locale"` uniquement.** Elle ne gère que la clé `"locale"` ; `get_item` renvoie `None` pour toute autre clé, et `set_item` l’ignore.
* **Aucune valeur par défaut définie.** Lorsqu’aucun paramètre régional n’a été défini dans le contexte actuel, `get_item("locale")` renvoie `None`, et le gestionnaire utilise alors le paramètre régional par défaut.

## Méthodes [#members]

| Méthode                        | Description                                                                       | Retourne      |
| ------------------------------ | --------------------------------------------------------------------------------- | ------------- |
| [`get_item`](#member-get-item) | Récupère le paramètre régional de la requête à partir de la variable de contexte. | `str \| None` |
| [`set_item`](#member-set-item) | Écrit le paramètre régional de la requête dans la variable de contexte.           | `None`        |

### `get_item(key)` [#member-get-item]

Renvoie le paramètre régional du contexte actuel si `key` vaut `"locale"`, sinon `None`.

### `set_item(key, value)` [#member-set-item]

Définit le paramètre régional du contexte actuel lorsque `key` est égal à `"locale"` ; sinon, ne fait rien.

## Exemple [#example]

```python
from gt_i18n import ContextVarStorageAdapter

adapter = ContextVarStorageAdapter()
adapter.set_item("locale", "es")
adapter.get_item("locale")  # "es" (dans le même contexte)
```

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.