# General Translation Python SDKs: extract_variables
URL: https://generaltranslation.com/fr/docs/python/reference/functions/extract-variables.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Filtre les clés GT réservées d'un dictionnaire d'options pour obtenir les variables utilisateur dans General Translation Python. Référence API pour extract_variables.

Renvoie un nouveau dictionnaire contenant uniquement les variables d'interpolation utilisateur, en excluant les clés réservées de General Translation telles que `_context`. Il s'agit de la fonction utilitaire utilisée par [`t`](/docs/python/reference/functions/t), [`msg`](/docs/python/reference/functions/msg) et [`interpolate_message`](/docs/python/reference/functions/interpolate-message) pour séparer les variables des options.

## Vue d’ensemble [#overview]

Appelez `extract_variables` avec un dictionnaire d’options. Elle renvoie un nouveau dictionnaire contenant toutes les clés, à l’exception des clés GT réservées.

```python
from gt_i18n import extract_variables

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

Signature :

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

Importez `extract_variables` à partir de `gt_i18n`. Il n’est pas réexporté par les packages du framework.

## Fonctionnement [#how-it-works]

* **Clés réservées.** Il supprime `_context`, `_id`, `_max_chars`, `__hash`, `__source` et `__fallback`.
* **Tout le reste est conservé.** Toutes les autres clés sont conservées telles quelles, y compris les clés utilisateur qui commencent par un seul trait de soulignement (par exemple, `_name`).
* **Sans mutation.** Il renvoie un nouveau dictionnaire ; l’entrée reste inchangée.

## Paramètres [#parameters]

| Paramètre             | Description                                                                 | Type                | Facultatif | Par défaut |
| --------------------- | --------------------------------------------------------------------------- | ------------------- | ---------- | ---------- |
| [`options`](#options) | Le dictionnaire d’options complet, qui peut contenir des clés GT réservées. | `dict[str, object]` | Non        | —          |

### `options` [#options]

**Type** `dict[str, object]` · **Obligatoire**

Le dictionnaire complet des options. Les clés GT réservées sont supprimées ; toutes les autres entrées sont conservées.

## Returns [#returns]

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

Un nouveau `dict` dont les clés GT réservées ont été supprimées.

## Exemple [#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"}
```

## Sitemap

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