# General Translation Python SDKs: StorageAdapter
URL: https://generaltranslation.com/es/docs/python/reference/classes/storage-adapter.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Clase base abstracta para el almacenamiento de la configuración regional por petición en General Translation Python. Referencia de API para StorageAdapter.

Hereda de `StorageAdapter` 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())
```

## Sitemap

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