Metadata-Version: 2.1
Name: Locales
Version: 0.0.2
Summary: Module for multilingual solutions
Home-page: https://github.com/vffuunnyy/Locales
Author: vffuunnyy
Author-email: vffuunnyy@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown

# Locales

Locales - module for multilingual projects

## Getting Started

### Prerequisites

Locales uses only standard library **json**. You need to write the translations in *json format*

```json
{
  "languages": {
      "ru": "Р СѓСЃСЃРєРёР№", "eng": "English", "sp": "EspaГ±ol"
  },

  "messages": {
      "welcome": {
          "ru": "Р”РѕР±СЂРѕ РїРѕР¶Р°Р»РѕРІР°С‚СЊ!",
          "eng": "Welcome!"
      },
      "goodbye": {
          "ru": "РџРѕРєР°",
          "eng": "Goodbye",
          "sp": "AdiГіs"
      }
  }
}
```
Keys `languages` and `messages` required.

To generate the same file use:
```python
import Locales

Locales().example()
```

### Installing

You can install Locales using pip

```sh
$ pip install locales
```
or download `Locales.py` and drop to folder with your project

### Using

```python
import Locales

loc = Locales("filename.json")
loc.set_default_lang("eng")  # Set the language by default

print(loc.get("welcome"))
# Welcome!

print(loc.get("welcome", "ru"))
# Р”РѕР±СЂРѕ РїРѕР¶Р°Р»РѕРІР°С‚СЊ!

print(loc.get_all("goodbye")
# dict of key "goodbye"  ->  {'ru': 'РџРѕРєР°', 'eng': 'Goodbye', 'sp': 'AdiГіs'}

print(loc.get_by_name("English"))
# returns the abbreviation(key) of the language  ->  eng
```

## Authors

* **vffuunnyy** - *Initial work* - [@vffuunnyy](https://t.me/vffuunnyy)


