# `Iuliia`
> Transliterate Cyrillic → Latin in every possible way
Transliteration means representing Cyrillic data (mainly names and geographic locations) with Latin letters. It is used for international passports, visas, green cards, driving licenses, mail and goods delivery etc.
`Iuliia` makes transliteration as easy as:
```python
>>> import iuliia
>>> iuliia.WIKIPEDIA.translate("Юлия Щеглова")
'Yuliya Shcheglova'
```
## Why use `Iuliia`
- 20 Russian transliteration schemas (all major international and national standards).
- Official Uzbek transliteration schema.
- Simple API and zero third-party dependencies.
For schema details and other information, see [iuliia.ru](https://iuliia.ru/) (in Russian).
[Limitations](https://github.com/nalgeon/iuliia/blob/master/README.md#issues-and-limitations)
## Installation
```sh
pip install iuliia
```
## Usage
Transliterate using specified schema:
```python
>>> source = "Юлия Щеглова"
>>> iuliia.ICAO_DOC_9303.translate(source)
'Iuliia Shcheglova'
```
Or pick schema by name
```python
>>> iuliia.schemas.has("wikipedia")
True
>>> schema = iuliia.schemas.get("wikipedia")
>>> schema.translate("Юлия Щеглова")
'Yuliya Shcheglova'
```
List all supported schemas:
```python
for name, schema in iuliia.schemas.items():
print("{0:<20}{1}".format(name, schema.description))
```
```text
ala_lc ALA-LC transliteration schema
ala_lc_alt ALA-LC transliteration schema
bgn_pcgn BGN/PCGN transliteration schema
bgn_pcgn_alt BGN/PCGN transliteration schema
bs_2979 British Standard 2979:1958 transliteration schema
bs_2979_alt British Standard 2979:1958 transliteration schema
gost_16876 GOST 16876-71 (aka GOST 1983) transliteration schema
gost_16876_alt GOST 16876-71 (aka GOST 1983) transliteration schema
gost_52290 GOST R 52290-2004 transliteration schema
gost_52535 GOST R 52535.1-2006 transliteration schema
gost_7034 GOST R 7.0.34-2014 transliteration schema
gost_779 GOST 7.79-2000 (aka ISO 9:1995) transliteration schema
gost_779_alt GOST 7.79-2000 (aka ISO 9:1995) transliteration schema
icao_doc_9303 ICAO DOC 9303 transliteration schema
iso_9_1954 ISO/R 9:1954 transliteration schema
iso_9_1968 ISO/R 9:1968 transliteration schema
iso_9_1968_alt ISO/R 9:1968 transliteration schema
mosmetro Moscow Metro map transliteration schema
mvd_310 MVD 310-1997 transliteration schema
mvd_310_fr MVD 310-1997 transliteration schema
mvd_782 MVD 782-2000 transliteration schema
scientific Scientific transliteration schema
telegram Telegram transliteration schema
ungegn_1987 UNGEGN 1987 V/18 transliteration schema
uz Uzbekistan cyr-lat transliteration schema
wikipedia Wikipedia transliteration schema
yandex_maps Yandex.Maps transliteration schema
yandex_money Yandex.Money transliteration schema
```
Command line:
```sh
$ iuliia icao_doc_9303 "Юлия Щеглова"
Iuliia Shcheglova
```
## Development setup
```sh
$ python3 -m venv env
$ . env/bin/activate
$ make deps schemas
$ make
```
Development tasks:
```text
make [task]
```
```text
task help
------ ----
all Run tests with coverage and linting
coverage Run tests with coverage
deps Install dependencies
lint Lint and static-check code
pull Pull code and schemas
push Push commits and tags
schemas Update schemas
test Run functional tests
timing Run performance tests
```
## Contributing
Contributions are welcome. For anything other than bugfixes, please first open an issue to discuss what you want to change.
Be sure to add or update tests as appropriate.
Use [Black](https://black.readthedocs.io/en/stable/) for code formatting.
## Release notes
See [CHANGELOG.md](CHANGELOG.md)
## License
[MIT](https://choosealicense.com/licenses/mit/)
Raw data
{
"_id": null,
"home_page": null,
"name": "iuliia",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "transliteration, cyrillic, latin, romanization",
"author": null,
"author_email": "Anton Zhiyanov <m@antonz.ru>",
"download_url": "https://files.pythonhosted.org/packages/b2/6e/dbaa45ac0396e792ce1aba72af8a1112471518bbea7fa43e186e7aeef179/iuliia-0.13.0.tar.gz",
"platform": null,
"description": "# `Iuliia`\n\n> Transliterate Cyrillic \u2192 Latin in every possible way\n\nTransliteration means representing Cyrillic data (mainly names and geographic locations) with Latin letters. It is used for international passports, visas, green cards, driving licenses, mail and goods delivery etc.\n\n`Iuliia` makes transliteration as easy as:\n\n```python\n>>> import iuliia\n>>> iuliia.WIKIPEDIA.translate(\"\u042e\u043b\u0438\u044f \u0429\u0435\u0433\u043b\u043e\u0432\u0430\")\n'Yuliya Shcheglova'\n```\n\n## Why use `Iuliia`\n\n- 20 Russian transliteration schemas (all major international and national standards).\n- Official Uzbek transliteration schema.\n- Simple API and zero third-party dependencies.\n\nFor schema details and other information, see [iuliia.ru](https://iuliia.ru/) (in Russian).\n\n[Limitations](https://github.com/nalgeon/iuliia/blob/master/README.md#issues-and-limitations)\n\n## Installation\n\n```sh\npip install iuliia\n```\n\n## Usage\n\nTransliterate using specified schema:\n\n```python\n>>> source = \"\u042e\u043b\u0438\u044f \u0429\u0435\u0433\u043b\u043e\u0432\u0430\"\n>>> iuliia.ICAO_DOC_9303.translate(source)\n'Iuliia Shcheglova'\n```\n\nOr pick schema by name\n\n```python\n>>> iuliia.schemas.has(\"wikipedia\")\nTrue\n>>> schema = iuliia.schemas.get(\"wikipedia\")\n>>> schema.translate(\"\u042e\u043b\u0438\u044f \u0429\u0435\u0433\u043b\u043e\u0432\u0430\")\n'Yuliya Shcheglova'\n```\n\nList all supported schemas:\n\n```python\nfor name, schema in iuliia.schemas.items():\n print(\"{0:<20}{1}\".format(name, schema.description))\n```\n\n```text\nala_lc ALA-LC transliteration schema\nala_lc_alt ALA-LC transliteration schema\nbgn_pcgn BGN/PCGN transliteration schema\nbgn_pcgn_alt BGN/PCGN transliteration schema\nbs_2979 British Standard 2979:1958 transliteration schema\nbs_2979_alt British Standard 2979:1958 transliteration schema\ngost_16876 GOST 16876-71 (aka GOST 1983) transliteration schema\ngost_16876_alt GOST 16876-71 (aka GOST 1983) transliteration schema\ngost_52290 GOST R 52290-2004 transliteration schema\ngost_52535 GOST R 52535.1-2006 transliteration schema\ngost_7034 GOST R 7.0.34-2014 transliteration schema\ngost_779 GOST 7.79-2000 (aka ISO 9:1995) transliteration schema\ngost_779_alt GOST 7.79-2000 (aka ISO 9:1995) transliteration schema\nicao_doc_9303 ICAO DOC 9303 transliteration schema\niso_9_1954 ISO/R 9:1954 transliteration schema\niso_9_1968 ISO/R 9:1968 transliteration schema\niso_9_1968_alt ISO/R 9:1968 transliteration schema\nmosmetro Moscow Metro map transliteration schema\nmvd_310 MVD 310-1997 transliteration schema\nmvd_310_fr MVD 310-1997 transliteration schema\nmvd_782 MVD 782-2000 transliteration schema\nscientific Scientific transliteration schema\ntelegram Telegram transliteration schema\nungegn_1987 UNGEGN 1987 V/18 transliteration schema\nuz Uzbekistan cyr-lat transliteration schema\nwikipedia Wikipedia transliteration schema\nyandex_maps Yandex.Maps transliteration schema\nyandex_money Yandex.Money transliteration schema\n```\n\nCommand line:\n\n```sh\n$ iuliia icao_doc_9303 \"\u042e\u043b\u0438\u044f \u0429\u0435\u0433\u043b\u043e\u0432\u0430\"\nIuliia Shcheglova\n```\n\n## Development setup\n\n```sh\n$ python3 -m venv env\n$ . env/bin/activate\n$ make deps schemas\n$ make\n```\n\nDevelopment tasks:\n\n```text\nmake [task]\n```\n\n```text\ntask help\n------ ----\nall Run tests with coverage and linting\ncoverage Run tests with coverage\ndeps Install dependencies\nlint Lint and static-check code\npull Pull code and schemas\npush Push commits and tags\nschemas Update schemas\ntest Run functional tests\ntiming Run performance tests\n```\n\n## Contributing\n\nContributions are welcome. For anything other than bugfixes, please first open an issue to discuss what you want to change.\n\nBe sure to add or update tests as appropriate.\n\nUse [Black](https://black.readthedocs.io/en/stable/) for code formatting.\n\n## Release notes\n\nSee [CHANGELOG.md](CHANGELOG.md)\n\n## License\n\n[MIT](https://choosealicense.com/licenses/mit/)\n",
"bugtrack_url": null,
"license": null,
"summary": "Transliterate Cyrillic \u2192 Latin in every possible way",
"version": "0.13.0",
"project_urls": {
"Source": "https://github.com/nalgeon/iuliia-py"
},
"split_keywords": [
"transliteration",
" cyrillic",
" latin",
" romanization"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c6d909fa8b6f5600cf583fd0e4a987f7f3b36bfff59b18d8177450089f138d12",
"md5": "a58610484a12477da0e46226023dc8b8",
"sha256": "83e8c18d631f2f7f9ccc2f6c7091bf74a34acf4c70d84f052d3e272a374ea1f5"
},
"downloads": -1,
"filename": "iuliia-0.13.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a58610484a12477da0e46226023dc8b8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 37117,
"upload_time": "2025-01-05T11:50:48",
"upload_time_iso_8601": "2025-01-05T11:50:48.167074Z",
"url": "https://files.pythonhosted.org/packages/c6/d9/09fa8b6f5600cf583fd0e4a987f7f3b36bfff59b18d8177450089f138d12/iuliia-0.13.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b26edbaa45ac0396e792ce1aba72af8a1112471518bbea7fa43e186e7aeef179",
"md5": "9691807c5efc422e1340ed8bc70dd389",
"sha256": "eafd883de575ca3de657466ef18310c7cbdf0f65cb0b542362ff6b29bcf35852"
},
"downloads": -1,
"filename": "iuliia-0.13.0.tar.gz",
"has_sig": false,
"md5_digest": "9691807c5efc422e1340ed8bc70dd389",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 23228,
"upload_time": "2025-01-05T11:50:51",
"upload_time_iso_8601": "2025-01-05T11:50:51.464464Z",
"url": "https://files.pythonhosted.org/packages/b2/6e/dbaa45ac0396e792ce1aba72af8a1112471518bbea7fa43e186e7aeef179/iuliia-0.13.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-05 11:50:51",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "nalgeon",
"github_project": "iuliia-py",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "iuliia"
}
JSON
