# General Translation Python SDKs: msg
URL: https://generaltranslation.com/fr/docs/python/reference/functions/msg.mdx
---

title: msg
description: Enregistre un message avec ses options de traduction sous forme de chaîne encodée dans General Translation Python. Référence de l’API pour msg.

---

Enregistre un message avec ses options de traduction et renvoie une chaîne encodée qui pourra être décodée ultérieurement. Utilisez-le lorsque vous composez un message à un endroit et le traitez à un autre.

## Vue d’ensemble [#overview]

Appelez `msg` avec une chaîne source et toutes les variables ou options réservées nécessaires. Sans argument nommé, elle renvoie le message inchangé. Avec des options, elle renvoie une chaîne encodée `{interpolated}:{base64options}` que [`m_fallback`](/docs/python/reference/functions/m-fallback), [`decode_msg`](/docs/python/reference/functions/decode-msg) et [`decode_options`](/docs/python/reference/functions/decode-options) peuvent lire.

```python
from gt_i18n import msg

msg("Save", _context="button")
```

Signature :

```python
msg(message: str, **kwargs: object) -> str
```

Importez `msg` depuis `gt_i18n`. Il n’est pas réexporté par les packages du framework.

## Fonctionnement [#how-it-works]

* **Raccourci sans options.** Lorsque `kwargs` est vide, la fonction renvoie `message` tel quel.
* **Interpolation.** La fonction interpole le message avec les variables utilisateur (clés réservées exclues) pour le préfixe lisible par l’humain.
* **Encodage.** Elle calcule le hachage du message (ou réutilise un `__hash` fourni), puis encode en base64 un payload JSON d’options incluant tous les kwargs ainsi que `__source` et `__hash`, et renvoie `"{interpolated}:{encoded}"`.
* **Tolérance aux erreurs.** Si l’interpolation échoue, la fonction renvoie le message d’origine.

## Paramètres [#parameters]

| Paramètre             | Description                                                                          | Type             | Facultatif | Par défaut |
| --------------------- | ------------------------------------------------------------------------------------ | ---------------- | ---------- | ---------- |
| [`message`](#message) | La chaîne source au format ICU MessageFormat.                                        | `str`            | Non        | —          |
| [`kwargs`](#kwargs)   | Variables d’interpolation et options GT réservées (`_context`, `_id`, `_max_chars`). | arguments nommés | Oui        | —          |

### `message` [#message]

**Type** `str` · **Obligatoire**

La chaîne source au format ICU MessageFormat à enregistrer.

### `kwargs` [#kwargs]

**Type** arguments nommés · **Facultatif**

Variables d’interpolation et options réservées `_context`, `_id` et `_max_chars`, qui sont prises en compte dans le calcul du hachage. Toutes les clés sont conservées dans le payload encodé.

## Renvoie [#returns]

**Type** `str`

Le message inchangé lorsqu’aucune option n’est fournie, sinon une chaîne `{interpolated}:{base64options}` encodée.

## Exemple [#example]

```python
from gt_i18n import msg, decode_msg, decode_options

encoded = msg("Hi, {name}!", name="Bob", _id="greet")
decode_msg(encoded)      # "Hi, Bob!"
decode_options(encoded)  # {"name": "Bob", "_id": "greet", "__source": "Hi, {name}!", "__hash": "..."}
```