# General Translation Python SDKs: ContextVarStorageAdapter
URL: https://generaltranslation.com/it/docs/python/reference/classes/context-var-storage-adapter.mdx
---

title: ContextVarStorageAdapter
description: Adattatore di archiviazione predefinito della variabile di contesto per l'impostazione regionale della richiesta in General Translation Python. Riferimento API per ContextVarStorageAdapter.

---

Lo [`StorageAdapter`](/docs/python/reference/classes/storage-adapter) predefinito per l'impostazione regionale della richiesta, basato su un `contextvars.ContextVar`. Funziona sia in contesti multithread (Flask) sia asincroni (FastAPI), assegnando automaticamente a ogni richiesta la propria impostazione regionale isolata.

## Panoramica [#overview]

[`I18nManager`](/docs/python/reference/classes/i18n-manager) usa questo adattatore, a meno che tu non passi un `store_adapter` personalizzato. Raramente dovrai istanziarlo direttamente.

```python
from gt_i18n import ContextVarStorageAdapter, I18nManager

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

Importa `ContextVarStorageAdapter` da `gt_i18n`. Non è riesportato dai pacchetti del framework.

## Come funziona [#how-it-works]

* **Variabile di contesto.** Memorizza l'impostazione regionale in un `ContextVar` a livello di modulo, così le richieste concorrenti non vedono l'impostazione regionale delle altre.
* **Solo la chiave dell'impostazione regionale.** Gestisce solo la chiave `"locale"`; `get_item` restituisce `None` per qualsiasi altra chiave e `set_item` la ignora.
* **Predefinito non impostato.** Quando nel contesto corrente non è stata impostata alcuna impostazione regionale, `get_item("locale")` restituisce `None` e il manager torna all'impostazione regionale predefinita.

## Metodi [#members]

| Membro                         | Descrizione                                                                      | Valore restituito |
| ------------------------------ | -------------------------------------------------------------------------------- | ----------------- |
| [`get_item`](#member-get-item) | Legge l'impostazione regionale della richiesta dalla variabile di contesto.  | `str \| None`     |
| [`set_item`](#member-set-item) | Scrive l'impostazione regionale della richiesta nella variabile di contesto. | `None`            |

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

Restituisce l'impostazione regionale del contesto corrente se `key` è `"locale"`, altrimenti `None`.

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

Imposta l'impostazione regionale del contesto corrente se `key` è `"locale"`; altrimenti, non fa nulla.

## Esempio [#example]

```python
from gt_i18n import ContextVarStorageAdapter

adapter = ContextVarStorageAdapter()
adapter.set_item("locale", "es")
adapter.get_item("locale")  # "es" (all'interno dello stesso contesto)
```