# {py:mod}`simvx.core.i18n`

```{py:module} simvx.core.i18n
```

```{autodoc2-docstring} simvx.core.i18n
:allowtitles:
```

## Module Contents

### Classes

````{list-table}
:class: autosummary longtable
:align: left

* - {py:obj}`PluralRules <simvx.core.i18n.PluralRules>`
  - ```{autodoc2-docstring} simvx.core.i18n.PluralRules
    :summary:
    ```
* - {py:obj}`TranslationServer <simvx.core.i18n.TranslationServer>`
  - ```{autodoc2-docstring} simvx.core.i18n.TranslationServer
    :summary:
    ```
````

### Functions

````{list-table}
:class: autosummary longtable
:align: left

* - {py:obj}`tr <simvx.core.i18n.tr>`
  - ```{autodoc2-docstring} simvx.core.i18n.tr
    :summary:
    ```
* - {py:obj}`locale_from_system <simvx.core.i18n.locale_from_system>`
  - ```{autodoc2-docstring} simvx.core.i18n.locale_from_system
    :summary:
    ```
````

### Data

````{list-table}
:class: autosummary longtable
:align: left

* - {py:obj}`log <simvx.core.i18n.log>`
  - ```{autodoc2-docstring} simvx.core.i18n.log
    :summary:
    ```
* - {py:obj}`__all__ <simvx.core.i18n.__all__>`
  - ```{autodoc2-docstring} simvx.core.i18n.__all__
    :summary:
    ```
````

### API

````{py:data} log
:canonical: simvx.core.i18n.log
:value: >
   'getLogger(...)'

```{autodoc2-docstring} simvx.core.i18n.log
```

````

````{py:data} __all__
:canonical: simvx.core.i18n.__all__
:value: >
   ['TranslationServer', 'tr', 'PluralRules', 'locale_from_system']

```{autodoc2-docstring} simvx.core.i18n.__all__
```

````

`````{py:class} PluralRules
:canonical: simvx.core.i18n.PluralRules

```{autodoc2-docstring} simvx.core.i18n.PluralRules
```

````{py:method} get_plural_form(n: int | float, locale_code: str = 'en') -> str
:canonical: simvx.core.i18n.PluralRules.get_plural_form
:staticmethod:

```{autodoc2-docstring} simvx.core.i18n.PluralRules.get_plural_form
```

````

`````

`````{py:class} TranslationServer()
:canonical: simvx.core.i18n.TranslationServer

```{autodoc2-docstring} simvx.core.i18n.TranslationServer
```

```{rubric} Initialization
```

```{autodoc2-docstring} simvx.core.i18n.TranslationServer.__init__
```

````{py:method} instance() -> simvx.core.i18n.TranslationServer
:canonical: simvx.core.i18n.TranslationServer.instance
:classmethod:

```{autodoc2-docstring} simvx.core.i18n.TranslationServer.instance
```

````

````{py:method} set_locale(locale_code: str) -> None
:canonical: simvx.core.i18n.TranslationServer.set_locale

```{autodoc2-docstring} simvx.core.i18n.TranslationServer.set_locale
```

````

````{py:method} get_locale() -> str
:canonical: simvx.core.i18n.TranslationServer.get_locale

```{autodoc2-docstring} simvx.core.i18n.TranslationServer.get_locale
```

````

````{py:method} set_default_locale(locale_code: str) -> None
:canonical: simvx.core.i18n.TranslationServer.set_default_locale

```{autodoc2-docstring} simvx.core.i18n.TranslationServer.set_default_locale
```

````

````{py:method} get_default_locale() -> str
:canonical: simvx.core.i18n.TranslationServer.get_default_locale

```{autodoc2-docstring} simvx.core.i18n.TranslationServer.get_default_locale
```

````

````{py:method} get_available_locales() -> list[str]
:canonical: simvx.core.i18n.TranslationServer.get_available_locales

```{autodoc2-docstring} simvx.core.i18n.TranslationServer.get_available_locales
```

````

````{py:method} add_translation(locale_code: str, key: str, value: str) -> None
:canonical: simvx.core.i18n.TranslationServer.add_translation

```{autodoc2-docstring} simvx.core.i18n.TranslationServer.add_translation
```

````

````{py:method} add_translations(locale_code: str, entries: dict[str, str]) -> None
:canonical: simvx.core.i18n.TranslationServer.add_translations

```{autodoc2-docstring} simvx.core.i18n.TranslationServer.add_translations
```

````

````{py:method} load_csv(path: str | pathlib.Path) -> None
:canonical: simvx.core.i18n.TranslationServer.load_csv

```{autodoc2-docstring} simvx.core.i18n.TranslationServer.load_csv
```

````

````{py:method} load_json(path: str | pathlib.Path) -> None
:canonical: simvx.core.i18n.TranslationServer.load_json

```{autodoc2-docstring} simvx.core.i18n.TranslationServer.load_json
```

````

````{py:method} load_dict(data: dict[str, dict[str, str]]) -> None
:canonical: simvx.core.i18n.TranslationServer.load_dict

```{autodoc2-docstring} simvx.core.i18n.TranslationServer.load_dict
```

````

````{py:method} clear() -> None
:canonical: simvx.core.i18n.TranslationServer.clear

```{autodoc2-docstring} simvx.core.i18n.TranslationServer.clear
```

````

````{py:method} translate(key: str, **kwargs: object) -> str
:canonical: simvx.core.i18n.TranslationServer.translate

```{autodoc2-docstring} simvx.core.i18n.TranslationServer.translate
```

````

````{py:method} translate_plural(key: str, count: int | float, **kwargs: object) -> str
:canonical: simvx.core.i18n.TranslationServer.translate_plural

```{autodoc2-docstring} simvx.core.i18n.TranslationServer.translate_plural
```

````

`````

````{py:function} tr(key: str, **kwargs: object) -> str
:canonical: simvx.core.i18n.tr

```{autodoc2-docstring} simvx.core.i18n.tr
```
````

````{py:function} locale_from_system() -> str
:canonical: simvx.core.i18n.locale_from_system

```{autodoc2-docstring} simvx.core.i18n.locale_from_system
```
````