# python: declare_var
URL: https://generaltranslation.com/fr/docs/python/api/declare-var.mdx
---
title: declare_var
description: Référence API de la fonction declare_var
---

## Vue d’ensemble

`declare_var` encapsule une valeur dynamique avec un marqueur de variable GT afin que les moteurs de traduction puissent conserver la variable dans le texte traduit.

```python
from gt_flask import declare_var  # ou depuis gt_fastapi import declare_var

greeting = declare_var("Alice", name="user")
```


## Référence

### Paramètres

<TypeTable
  type={{
  "variable": {
    type: 'str | int | float | bool | None',
    description: 'La valeur à insérer comme variable non traduisible.',
  },
  "name?": {
    type: 'str',
    optional: true,
    description: 'Nom de variable lisible, facultatif.',
  },
}}
/>

### Retourne

`str` — une construction `select` ICU qui enveloppe la valeur dans un marqueur de variable GT.

***

## Remarques

* Utilisez `declare_var` pour les valeurs qui changent à l’exécution (par ex., les noms d’utilisateur, les quantités).
* Voir aussi [`derive`](/docs/python/api/derive) pour les valeurs connues au moment du build.
* Utilisez [`decode_vars`](/docs/python/api/decode-vars) pour extraire à nouveau les variables d’une chaîne balisée.