# General Translation Python SDKs: msg
URL: https://generaltranslation.com/it/docs/python/reference/functions/msg.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Registra un messaggio con le relative opzioni di traduzione come stringa codificata in General Translation Python. Riferimento API per msg.

Restituisce una stringa codificata che contiene un messaggio insieme alle relative opzioni di traduzione, così da poter essere decodificata e risolta in un secondo momento. Usalo quando definisci un messaggio in un punto e lo utilizzi in un altro.

## Panoramica [#overview]

Chiama `msg` con una stringa sorgente e con eventuali variabili o opzioni riservate. Senza argomenti keyword, restituisce il messaggio invariato. Con le opzioni, restituisce una stringa codificata `{interpolated}:{base64options}` che [`m_fallback`](/docs/python/reference/functions/m-fallback), [`decode_msg`](/docs/python/reference/functions/decode-msg) e [`decode_options`](/docs/python/reference/functions/decode-options) possono leggere.

```python
from gt_i18n import msg

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

Sintassi:

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

Importa `msg` da `gt_i18n`. Non è riesportato dai pacchetti del framework.

## Come funziona [#how-it-works]

* **Scorciatoia senza opzioni.** Quando `kwargs` è vuoto, restituisce `message` invariato.
* **Interpolazione.** Interpola il messaggio con le variabili dell'utente (rimuovendo le chiavi riservate) per il prefisso leggibile dall'uomo.
* **Codifica.** Calcola l'hash del messaggio (o riutilizza un `__hash` passato), quindi codifica in base64 un payload JSON delle opzioni che include tutti i `kwargs` più `__source` e `__hash`, e restituisce `"{interpolated}:{encoded}"`.
* **Gestione sicura degli errori.** Se l'interpolazione non riesce, restituisce il messaggio originale.

## Parametri [#parameters]

| Parametro             | Descrizione                                                                           | Tipo               | Facoltativo | Predefinito |
| --------------------- | ------------------------------------------------------------------------------------- | ------------------ | ----------- | ----------- |
| [`message`](#message) | La stringa sorgente in formato ICU MessageFormat.                                     | `str`              | No          | —           |
| [`kwargs`](#kwargs)   | Variabili di interpolazione e opzioni GT riservate (`_context`, `_id`, `_max_chars`). | argomenti con nome | Sì          | —           |

### `message` [#message]

**Tipo** `str` · **Obbligatorio**

La stringa sorgente in formato ICU MessageFormat da registrare.

### `kwargs` [#kwargs]

**Type** argomenti con nome · **Opzionale**

Variabili di interpolazione e opzioni riservate `_context`, `_id` e `_max_chars`, incluse nell'hash. Tutte le chiavi vengono mantenute nel payload codificato.

## Restituisce [#returns]

**Tipo** `str`

Il messaggio invariato se non vengono fornite opzioni; altrimenti, una stringa codificata `{interpolated}:{base64options}`.

## Esempio [#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": "..."}
```

## Sitemap

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