# General Translation Python SDKs: extract_variables
URL: https://generaltranslation.com/es/docs/python/reference/functions/extract-variables.mdx
---
title: extract_variables
description: Filtra las claves reservadas de GT de un dict `options` para obtener las variables proporcionadas por el usuario en General Translation Python. Referencia de la API de extract_variables.

---

Devuelve solo las variables de interpolación proporcionadas por el usuario a partir de un dict `options`, eliminando las claves reservadas de General Translation. Es el helper que usan [`t`](/docs/python/reference/functions/t), [`msg`](/docs/python/reference/functions/msg) e [`interpolate_message`](/docs/python/reference/functions/interpolate-message) para separar las variables de las opciones.

## Descripción general [#overview]

Llama a `extract_variables` con un dict de opciones. Devuelve un dict nuevo que contiene todas las claves excepto las claves reservadas de GT.

```python
from gt_i18n import extract_variables

extract_variables({"name": "Alice", "_context": "greeting"})
# → {"name": "Alice"}
```

Firma:

```python
extract_variables(options: dict[str, object]) -> dict[str, object]
```

Importa `extract_variables` desde `gt_i18n`. Los paquetes del framework no lo reexportan.

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

* **Claves reservadas.** Omite `_context`, `_id`, `_max_chars`, `__hash`, `__source` y `__fallback`.
* **Todo lo demás se conserva.** Todas las demás claves pasan tal cual, incluidas las claves de usuario que empiezan con un solo guion bajo (por ejemplo, `_name`).
* **Sin mutar.** Devuelve un `dict` nuevo; la entrada no se modifica.

## Parámetros [#parameters]

| Parámetro             | Descripción                                                                 | Tipo                | Opcional | Predeterminado |
| --------------------- | --------------------------------------------------------------------------- | ------------------- | -------- | -------------- |
| [`options`](#options) | El `dict` completo de opciones, que puede contener claves reservadas de GT. | `dict[str, object]` | No       | —              |

### `options` [#options]

**Tipo** `dict[str, object]` · **Obligatorio**

El dict completo `options`. Se eliminan las claves reservadas de GT; se conservan todas las demás entradas.

## Devuelve [#returns]

**Tipo** `dict[str, object]`

Un nuevo dict sin las claves reservadas de GT.

## Ejemplo [#example]

```python
from gt_i18n import extract_variables

extract_variables({"_context": "x", "_id": "y", "_max_chars": 10})
# → {}

extract_variables({"_name": "Alice", "_context": "greeting"})
# → {"_name": "Alice"}
```