iuliia 1.0.1 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 687b0bb708b6eb6c64d055562c7e6be0b61a901c466b1bced4d7e0b4201cff1f
-  data.tar.gz: 9d45eb3171cbb1e21f43bc56dd6aa286f3425d884088a5f41ec51debaaa38e1e
+  metadata.gz: 5e2122232ec200955705f47e7049e2fa604b824f448bb1bebfc06e9eb899ec90
+  data.tar.gz: d3356ecdb05bd91e02660c5581f9dcfb1e150262321a078748afa34202c199ef
 SHA512:
-  metadata.gz: d35bd6868e309f3887fc61d1e8c4944523dd0f5560dfe0763c56171045ff99c8f93c57ce3142c4d769aa0fa6cd52b71c244f02c26579b66a7389c2621d3324cf
-  data.tar.gz: f167b6d8d86029dd462724d75483ba6d281e1e478491fb20dbd1e0e2eccc6690db33cc4658b996a57e0bdda9d33da4939cc368c477221338448580c94e24ddf4
+  metadata.gz: be4c6621c2034d8c3d99816d5aa5377c6bbfdf940638d9cb6cb1748929a1c89ad46c2ee9f1bec67465920382991672bcdadd2e1ad4fab15a6a5d59d065cfb304
+  data.tar.gz: a8b88552673e1ebde933b6a66e3d2eea91bc77fa2b46ce6f469ca5ab37d0ee806f5a908fa788d4ba20fb9e5a5d9f468c846947861b3b9c7a72afe2ff39313a12

data/iiulia.gemspec

@@ -24,11 +24,20 @@ Gem::Specification.new do |spec|
     raise 'RubyGems 2.0 or newer is required to protect against public gem pushes.'
   end
 
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features|priv)/}) }
   end
+
+  gem_dir = "#{__dir__}/"
+  `git submodule --quiet foreach pwd`.split($OUTPUT_RECORD_SEPARATOR).each do |submodule_path|
+    Dir.chdir(submodule_path) do
+      submodule_relative_path = submodule_path.sub gem_dir, ''
+      `git ls-files`.split($OUTPUT_RECORD_SEPARATOR).each do |filename|
+        spec.files << "#{submodule_relative_path}/#{filename}"
+      end
+    end
+  end
+
   spec.bindir = 'exe'
   spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
@@ -37,6 +46,8 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'rake'
   spec.add_development_dependency 'rspec'
   spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'rubocop-rake'
+  spec.add_development_dependency 'rubocop-rspec'
 
   spec.add_dependency 'json'
 end

data/lib/iuliia/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Iuliia
-  VERSION = '1.0.1'
+  VERSION = '1.0.2'
 end

data/lib/schemas/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Anton Zhiyanov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/lib/schemas/README.md

@@ -0,0 +1,71 @@
+# `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 easy as calling `iuliia.translate()` in your favorite programming language.
+
+Why use `Iuliia`:
+
+-   20 transliteration schemas (rule sets), including all main international and Russian standards.
+-   Correctly implements not only the base mapping, but all the special rules for letter combinations and word endings (AFAIK, Iuliia is the only library which does so).
+-   Simple API and zero third-party dependencies.
+
+## Supported schemas
+
+Actual schemas:
+
+-   ALA-LC: [ala_lc.json](ala_lc.json) and [ala_lc_alt.json](ala_lc_alt.json)
+-   BGN/PCGN: [bgn_pcgn.json](bgn_pcgn.json) and [bgn_pcgn_alt.json](bgn_pcgn_alt.json)
+-   BS 2979:1958: [bs_2979.json](bs_2979.json) and [bs_2979_alt.json](bs_2979_alt.json)
+-   GOST R 52290-2004: [gost_52290.json](gost_52290.json)
+-   GOST R 7.0.34-2014: [gost_7034.json](gost_7034.json)
+-   ICAO DOC 9303: [icao_doc_9303.json](icao_doc_9303.json)
+-   ISO 9:1995 aka GOST 7.79-2000: [gost_779.json](gost_779.json) and [gost_779_alt.json](gost_779_alt.json)
+-   UNGEGN 1987 V/18: [ungegn_1987.json](ungegn_1987.json)
+-   Moscow Metro map: [mosmetro.json](mosmetro.json)
+-   Scientific: [scientific.json](scientific.json)
+-   Telegram: [telegram.json](telegram.json)
+-   Wikipedia: [wikipedia.json](wikipedia.json)
+-   Yandex.Maps: [yandex_maps.json](yandex_maps.json)
+-   Yandex.Money: [yandex_money.json](yandex_money.json)
+
+And deprecated ones:
+
+-   GOST 16876-71: [gost_16876.json](gost_16876.json) and [gost_16876_alt.json](gost_16876_alt.json)
+-   GOST R 52535.1-2006: [gost_52535.json](gost_52535.json)
+-   ISO/R 9:1954: [iso_9_1954.json](iso_9_1954.json)
+-   ISO/R 9:1968: [iso_9_1968.json](iso_9_1968.json) and [iso_9_1968_alt.json](iso_9_1968_alt.json)
+-   MVD 310-1997: [mvd_310.json](mvd_310.json) and [mvd_310_fr.json](mvd_310_fr.json)
+-   MVD 782-2000: [mvd_782.json](mvd_782.json)
+
+For schema details and other information, see <https://dangry.ru/iuliia> (in Russian).
+
+## Supported languages
+
+-   [C#](https://github.com/belianin/iuliia-cs)
+-   [Go](https://github.com/mehanizm/iuliia-go)
+-   [Java](https://github.com/massita99/iuliia-java) (Gson)
+-   [Java](https://github.com/homyakin/iuliia-java) (Jackson)
+-   [JavaScript](https://github.com/nalgeon/iuliia-js)
+-   [PHP](https://github.com/perevoshchikov/iuliia-php)
+-   **[Python](https://github.com/nalgeon/iuliia-py) ✨**
+-   [Ruby](https://github.com/adnikiforov/iuliia-rb)
+-   [Rust](https://github.com/massita99/iuliia-rust)
+-   [Swift](https://github.com/petertretyakov/Iuliia)
+
+This repo contains schema descriptions. It is not intended to be used directly. If you want to add another schema — send a PR! See [schema.jsd](schema.jsd) for JSON Schema definition and [wikipedia.json](wikipedia.json) as a reference.
+
+## Issues and limitations
+
+In general:
+
+-   Only Russian subset of Cyrillic is supported.
+-   Does not support composite Unicode characters (e.g., `Ё`, but not `Ё`).
+
+Schema-specific:
+
+-   _BS 2979:1958_. This schema defines two alternative translations for `Ы`: `Ы` → `Ȳ` (used by the Oxford University Press) and `Ы` → `UI` (used by the British Library). `iuliia` uses `Ы` → `Ȳ`.
+-   _GOST R 7.0.34-2014_. This schema defines alternatives for many letters, but does not specify when to use which. Therefore, `iuliia` uses the first of suggested translations for each such letter.
+-   _MVD-310_. This schema defines "`С` between two vowels → `SS`" rule. There is no such rule in other schemas, and MVD-310 itself is deprecated, so I decided to ignore this specific rule for the sake of code simplicity.

data/lib/schemas/ala_lc.json

@@ -0,0 +1,49 @@
+{
+    "name": "ala_lc",
+    "description": "ALA-LC transliteration schema.",
+    "url": "https://dangry.ru/iuliia/ala-lc/",
+    "mapping": {
+        "а": "a",
+        "б": "b",
+        "в": "v",
+        "г": "g",
+        "д": "d",
+        "е": "e",
+        "ё": "ё",
+        "ж": "zh",
+        "з": "z",
+        "и": "i",
+        "й": "ĭ",
+        "к": "k",
+        "л": "l",
+        "м": "m",
+        "н": "n",
+        "о": "o",
+        "п": "p",
+        "р": "r",
+        "с": "s",
+        "т": "t",
+        "у": "u",
+        "ф": "f",
+        "х": "kh",
+        "ц": "t͡s",
+        "ч": "ch",
+        "ш": "sh",
+        "щ": "shch",
+        "ъ": "ʺ",
+        "ы": "y",
+        "ь": "ʹ",
+        "э": "ė",
+        "ю": "i͡u",
+        "я": "i͡a"
+    },
+    "prev_mapping": null,
+    "next_mapping": null,
+    "ending_mapping": null,
+    "samples": [
+        [
+            "Юлия, съешь ещё этих мягких французских булок из Йошкар-Олы, да выпей алтайского чаю",
+            "I͡ulii͡a, sʺeshʹ eshchё ėtikh mi͡agkikh frant͡suzskikh bulok iz Ĭoshkar-Oly, da vypeĭ altaĭskogo chai͡u"
+        ]
+    ]
+}

data/lib/schemas/ala_lc_alt.json

@@ -0,0 +1,49 @@
+{
+    "name": "ala_lc_alt",
+    "description": "ALA-LC transliteration schema.",
+    "url": "https://dangry.ru/iuliia/ala-lc/",
+    "mapping": {
+        "а": "a",
+        "б": "b",
+        "в": "v",
+        "г": "g",
+        "д": "d",
+        "е": "e",
+        "ё": "e",
+        "ж": "zh",
+        "з": "z",
+        "и": "i",
+        "й": "i",
+        "к": "k",
+        "л": "l",
+        "м": "m",
+        "н": "n",
+        "о": "o",
+        "п": "p",
+        "р": "r",
+        "с": "s",
+        "т": "t",
+        "у": "u",
+        "ф": "f",
+        "х": "kh",
+        "ц": "ts",
+        "ч": "ch",
+        "ш": "sh",
+        "щ": "shch",
+        "ъ": "\"",
+        "ы": "y",
+        "ь": "'",
+        "э": "e",
+        "ю": "iu",
+        "я": "ia"
+    },
+    "prev_mapping": null,
+    "next_mapping": null,
+    "ending_mapping": null,
+    "samples": [
+        [
+            "Юлия, съешь ещё этих мягких французских булок из Йошкар-Олы, да выпей алтайского чаю",
+            "Iuliia, s\"esh' eshche etikh miagkikh frantsuzskikh bulok iz Ioshkar-Oly, da vypei altaiskogo chaiu"
+        ]
+    ]
+}

data/lib/schemas/bgn_pcgn.json

@@ -0,0 +1,147 @@
+{
+    "name": "bgn_pcgn",
+    "description": "BGN/PCGN transliteration schema",
+    "url": "https://dangry.ru/iuliia/bgn-pcgn/",
+    "mapping": {
+        "а": "a",
+        "б": "b",
+        "в": "v",
+        "г": "g",
+        "д": "d",
+        "е": "e",
+        "ё": "ё",
+        "ж": "zh",
+        "з": "z",
+        "и": "i",
+        "й": "y",
+        "к": "k",
+        "л": "l",
+        "м": "m",
+        "н": "n",
+        "о": "o",
+        "п": "p",
+        "р": "r",
+        "с": "s",
+        "т": "t",
+        "у": "u",
+        "ф": "f",
+        "х": "kh",
+        "ц": "ts",
+        "ч": "ch",
+        "ш": "sh",
+        "щ": "shch",
+        "ъ": "”",
+        "ы": "y",
+        "ь": "’",
+        "э": "e",
+        "ю": "yu",
+        "я": "ya"
+    },
+    "prev_mapping": {
+        "е": "ye",
+        "ае": "ye",
+        "ее": "ye",
+        "ёе": "ye",
+        "ие": "ye",
+        "йе": "ye",
+        "ое": "ye",
+        "уе": "ye",
+        "ъе": "ye",
+        "ые": "ye",
+        "ье": "ye",
+        "эе": "ye",
+        "юе": "ye",
+        "яе": "ye",
+        "ё": "yё",
+        "аё": "yё",
+        "её": "yё",
+        "ёё": "yё",
+        "иё": "yё",
+        "йё": "yё",
+        "оё": "yё",
+        "уё": "yё",
+        "ъё": "yё",
+        "ыё": "yё",
+        "ьё": "yё",
+        "эё": "yё",
+        "юё": "yё",
+        "яё": "yё",
+        "аы": "·y",
+        "еы": "·y",
+        "ёы": "·y",
+        "иы": "·y",
+        "оы": "·y",
+        "уы": "·y",
+        "ыы": "·y",
+        "эы": "·y",
+        "юы": "·y",
+        "яы": "·y",
+        "бэ": "·e",
+        "вэ": "·e",
+        "гэ": "·e",
+        "дэ": "·e",
+        "жэ": "·e",
+        "зэ": "·e",
+        "кэ": "·e",
+        "лэ": "·e",
+        "мэ": "·e",
+        "нэ": "·e",
+        "пэ": "·e",
+        "рэ": "·e",
+        "сэ": "·e",
+        "тэ": "·e",
+        "фэ": "·e",
+        "хэ": "·e",
+        "цэ": "·e",
+        "чэ": "·e",
+        "шэ": "·e",
+        "щэ": "·e"
+    },
+    "next_mapping": {
+        "йа": "y·",
+        "йу": "y·",
+        "йы": "y·",
+        "йэ": "y·",
+        "ыа": "y·",
+        "ыу": "y·",
+        "ыы": "y·",
+        "ыэ": "y·",
+        "тс": "t·",
+        "шч": "sh·"
+    },
+    "ending_mapping": null,
+    "samples": [
+        [
+            "Юлия, съешь ещё этих мягких французских булок из Йошкар-Олы, да выпей алтайского чаю",
+            "Yuliya, s”yesh’ yeshchё etikh myagkikh frantsuzskikh bulok iz Yoshkar-Oly, da vypey altayskogo chayu"
+        ],
+        [
+            "Россия, город Йошкар-Ола, улица Яна Крастыня",
+            "Rossiya, gorod Yoshkar-Ola, ulitsa Yana Krastynya"
+        ],
+        ["Елизово", "Yelizovo"],
+        ["Чапаевск", "Chapayevsk"],
+        ["Мейеровка", "Meyyerovka"],
+        ["Юрьев объезд", "Yur’yev ob”yezd"],
+        ["Белкино", "Belkino"],
+        ["Ёдва", "Yёdva"],
+        ["Змииёвка", "Zmiiyёvka"],
+        ["Айёган", "Ayyёgan"],
+        ["Воробьёво", "Vorob’yёvo"],
+        ["Кебанъёль", "Keban”yёl’"],
+        ["Озёрный", "Ozёrnyy"],
+        ["Тыайа", "Ty·ay·a"],
+        ["Сайылык", "Say·ylyk"],
+        ["Ойусардах", "Oy·usardakh"],
+        ["Йошкар-Ола", "Yoshkar-Ola"],
+        ["Бийск", "Biysk"],
+        ["Тыэкан", "Ty·ekan"],
+        ["Суык-Су", "Su·yk-Su"],
+        ["Тында", "Tynda"],
+        ["Улан-Удэ", "Ulan-Ud·e"],
+        ["Электрогорск", "Elektrogorsk"],
+        ["Руэм", "Ruem"],
+        ["Вяртсиля", "Vyart·silya"],
+        ["Ташчишма", "Tash·chishma"]
+    ]
+}

data/lib/schemas/bgn_pcgn_alt.json

@@ -0,0 +1,106 @@
+{
+    "name": "bgn_pcgn_alt",
+    "description": "BGN/PCGN transliteration schema",
+    "url": "https://dangry.ru/iuliia/bgn-pcgn/",
+    "mapping": {
+        "а": "a",
+        "б": "b",
+        "в": "v",
+        "г": "g",
+        "д": "d",
+        "е": "e",
+        "ё": "ё",
+        "ж": "zh",
+        "з": "z",
+        "и": "i",
+        "й": "y",
+        "к": "k",
+        "л": "l",
+        "м": "m",
+        "н": "n",
+        "о": "o",
+        "п": "p",
+        "р": "r",
+        "с": "s",
+        "т": "t",
+        "у": "u",
+        "ф": "f",
+        "х": "kh",
+        "ц": "ts",
+        "ч": "ch",
+        "ш": "sh",
+        "щ": "shch",
+        "ъ": "”",
+        "ы": "y",
+        "ь": "’",
+        "э": "e",
+        "ю": "yu",
+        "я": "ya"
+    },
+    "prev_mapping": {
+        "е": "ye",
+        "ае": "ye",
+        "ее": "ye",
+        "ёе": "ye",
+        "ие": "ye",
+        "йе": "ye",
+        "ое": "ye",
+        "уе": "ye",
+        "ъе": "ye",
+        "ые": "ye",
+        "ье": "ye",
+        "эе": "ye",
+        "юе": "ye",
+        "яе": "ye",
+        "ё": "yё",
+        "аё": "yё",
+        "её": "yё",
+        "ёё": "yё",
+        "иё": "yё",
+        "йё": "yё",
+        "оё": "yё",
+        "уё": "yё",
+        "ъё": "yё",
+        "ыё": "yё",
+        "ьё": "yё",
+        "эё": "yё",
+        "юё": "yё",
+        "яё": "yё"
+    },
+    "next_mapping": null,
+    "ending_mapping": null,
+    "samples": [
+        [
+            "Юлия, съешь ещё этих мягких французских булок из Йошкар-Олы, да выпей алтайского чаю",
+            "Yuliya, s”yesh’ yeshchё etikh myagkikh frantsuzskikh bulok iz Yoshkar-Oly, da vypey altayskogo chayu"
+        ],
+        [
+            "Россия, город Йошкар-Ола, улица Яна Крастыня",
+            "Rossiya, gorod Yoshkar-Ola, ulitsa Yana Krastynya"
+        ],
+        ["Елизово", "Yelizovo"],
+        ["Чапаевск", "Chapayevsk"],
+        ["Мейеровка", "Meyyerovka"],
+        ["Юрьев объезд", "Yur’yev ob”yezd"],
+        ["Белкино", "Belkino"],
+        ["Ёдва", "Yёdva"],
+        ["Змииёвка", "Zmiiyёvka"],
+        ["Айёган", "Ayyёgan"],
+        ["Воробьёво", "Vorob’yёvo"],
+        ["Кебанъёль", "Keban”yёl’"],
+        ["Озёрный", "Ozёrnyy"],
+        ["Тыайа", "Tyaya"],
+        ["Сайылык", "Sayylyk"],
+        ["Ойусардах", "Oyusardakh"],
+        ["Йошкар-Ола", "Yoshkar-Ola"],
+        ["Бийск", "Biysk"],
+        ["Тыэкан", "Tyekan"],
+        ["Суык-Су", "Suyk-Su"],
+        ["Тында", "Tynda"],
+        ["Улан-Удэ", "Ulan-Ude"],
+        ["Электрогорск", "Elektrogorsk"],
+        ["Руэм", "Ruem"],
+        ["Вяртсиля", "Vyartsilya"],
+        ["Ташчишма", "Tashchishma"]
+    ]
+}

data/lib/schemas/bs_2979.json

@@ -0,0 +1,55 @@
+{
+    "name": "bs_2979",
+    "description": "British Standard 2979:1958 transliteration schema",
+    "url": "https://dangry.ru/iuliia/bs-2979/",
+    "comments": [
+        "This schema defines two alternative translations for `Ы`:",
+        "  - `Ы` → `Ȳ` (used by the Oxford University Press)",
+        "  - `Ы` → `UI` (used by the British Library).",
+        "`iuliia` uses `Ы` → `Ȳ`."
+    ],
+    "mapping": {
+        "а": "a",
+        "б": "b",
+        "в": "v",
+        "г": "g",
+        "д": "d",
+        "е": "e",
+        "ё": "ё",
+        "ж": "zh",
+        "з": "z",
+        "и": "i",
+        "й": "ĭ",
+        "к": "k",
+        "л": "l",
+        "м": "m",
+        "н": "n",
+        "о": "o",
+        "п": "p",
+        "р": "r",
+        "с": "s",
+        "т": "t",
+        "у": "u",
+        "ф": "f",
+        "х": "kh",
+        "ц": "ts",
+        "ч": "ch",
+        "ш": "sh",
+        "щ": "shch",
+        "ъ": "ʺ",
+        "ы": "ȳ",
+        "ь": "ʹ",
+        "э": "é",
+        "ю": "yu",
+        "я": "ya"
+    },
+    "prev_mapping": null,
+    "next_mapping": null,
+    "ending_mapping": { "ий": "y", "ый": "y" },
+    "samples": [
+        [
+            "Юлия, съешь ещё этих мягких французских булок из Йошкар-Олы, да выпей алтайского чаю",
+            "Yuliya, sʺeshʹ eshchё étikh myagkikh frantsuzskikh bulok iz Ĭoshkar-Olȳ, da vȳpeĭ altaĭskogo chayu"
+        ]
+    ]
+}

data/lib/schemas/bs_2979_alt.json

@@ -0,0 +1,49 @@
+{
+    "name": "bs_2979_alt",
+    "description": "British Standard 2979:1958 transliteration schema",
+    "url": "https://dangry.ru/iuliia/bs-2979/",
+    "mapping": {
+        "а": "a",
+        "б": "b",
+        "в": "v",
+        "г": "g",
+        "д": "d",
+        "е": "e",
+        "ё": "e",
+        "ж": "zh",
+        "з": "z",
+        "и": "i",
+        "й": "i",
+        "к": "k",
+        "л": "l",
+        "м": "m",
+        "н": "n",
+        "о": "o",
+        "п": "p",
+        "р": "r",
+        "с": "s",
+        "т": "t",
+        "у": "u",
+        "ф": "f",
+        "х": "kh",
+        "ц": "ts",
+        "ч": "ch",
+        "ш": "sh",
+        "щ": "shch",
+        "ъ": "\"",
+        "ы": "y",
+        "ь": "'",
+        "э": "e",
+        "ю": "yu",
+        "я": "ya"
+    },
+    "prev_mapping": null,
+    "next_mapping": null,
+    "ending_mapping": { "ий": "y", "ый": "y" },
+    "samples": [
+        [
+            "Юлия, съешь ещё этих мягких французских булок из Йошкар-Олы, да выпей алтайского чаю",
+            "Yuliya, s\"esh' eshche etikh myagkikh frantsuzskikh bulok iz Ioshkar-Oly, da vypei altaiskogo chayu"
+        ]
+    ]
+}

data/lib/schemas/gost_16876.json

@@ -0,0 +1,49 @@
+{
+    "name": "gost_16876",
+    "description": "GOST 16876-71 (aka GOST 1983) transliteration schema",
+    "url": "https://dangry.ru/iuliia/gost-16876/",
+    "mapping": {
+        "а": "a",
+        "б": "b",
+        "в": "v",
+        "г": "g",
+        "д": "d",
+        "е": "e",
+        "ё": "ё",
+        "ж": "ž",
+        "з": "z",
+        "и": "i",
+        "й": "j",
+        "к": "k",
+        "л": "l",
+        "м": "m",
+        "н": "n",
+        "о": "o",
+        "п": "p",
+        "р": "r",
+        "с": "s",
+        "т": "t",
+        "у": "u",
+        "ф": "f",
+        "х": "h",
+        "ц": "c",
+        "ч": "č",
+        "ш": "š",
+        "щ": "ŝ",
+        "ъ": "ʺ",
+        "ы": "y",
+        "ь": "ʹ",
+        "э": "è",
+        "ю": "û",
+        "я": "â"
+    },
+    "prev_mapping": null,
+    "next_mapping": null,
+    "ending_mapping": null,
+    "samples": [
+        [
+            "Юлия, съешь ещё этих мягких французских булок из Йошкар-Олы, да выпей алтайского чаю",
+            "Ûliâ, sʺešʹ eŝё ètih mâgkih francuzskih bulok iz Joškar-Oly, da vypej altajskogo čaû"
+        ]
+    ]
+}