# General Translation Python SDKs: StorageAdapter
URL: https://generaltranslation.com/es/docs/python/reference/classes/storage-adapter.mdx
---

title: StorageAdapter
description: Clase base abstracta para el almacenamiento de la configuración regional por petición en General Translation Python. Referencia de API para StorageAdapter.

---

Clase base abstracta para adaptadores que almacenan y leen la configuración regional por petición. Hereda de ella para controlar dónde se guarda la configuración regional actual (por ejemplo, en el contexto de la solicitud de un framework). La implementación predeterminada es [`ContextVarStorageAdapter`](/docs/python/reference/classes/context-var-storage-adapter).

## Resumen general [#overview]

`StorageAdapter` es una [clase base abstracta](https://docs.python.org/3/library/abc.html) (extiende `abc.ABC`). Define dos métodos abstractos que debes implementar y no puedes instanciarla directamente.

```python
from gt_i18n import StorageAdapter

class MyAdapter(StorageAdapter):
    def get_item(self, key: str) -> str | None:
        ...

    def set_item(self, key: str, value: str) -> None:
        ...
```

Importa `StorageAdapter` desde `gt_i18n`. No se reexporta en los paquetes del framework.

## Cómo funciona [#how-it-works]

* **Métodos abstractos.** `get_item` y `set_item` son abstractos; una subclase debe implementar ambos.
* **Clave de configuración regional.** El administrador lee y escribe la configuración regional con la clave `"locale"`. Un adaptador puede ignorar otras claves.
* **Integración.** Pasa un adaptador personalizado como `store_adapter` a [`I18nManager`](/docs/python/reference/classes/i18n-manager).

## Métodos [#members]

| Miembro                        | Descripción                                      | Devuelve      |
| ------------------------------ | ------------------------------------------------ | ------------- |
| [`get_item`](#member-get-item) | Recupera un valor almacenado mediante una clave. | `str \| None` |
| [`set_item`](#member-set-item) | Almacena un valor mediante una clave.            | `None`        |

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

**Abstracto.** Devuelve el valor almacenado para `key`, o `None` si no existe.

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

**Abstracto.** Almacena `value` bajo la clave `key`.

## Ejemplo [#example]

```python
from gt_i18n import StorageAdapter, I18nManager

class DictStorageAdapter(StorageAdapter):
    def __init__(self) -> None:
        self._data: dict[str, str] = {}

    def get_item(self, key: str) -> str | None:
        return self._data.get(key)

    def set_item(self, key: str, value: str) -> None:
        self._data[key] = value

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