# RusLingua 📚
RusLingua is a Python library for retrieving various linguistic information about Russian words. It provides a simple API to get synonyms, antonyms, word associations, cognate words, and definitions.
## Features
- Get synonyms of a word 👥
- Get antonyms of a word 👎
- Get word associations ðŸ’
- Get cognate words (words with a common root) 🌳
- Get definitions from dictionaries 📖
## Quickstart
```python
from ruslingua import RusLingua
ruslingua = RusLingua()
synonyms = ruslingua.get_synonyms('дом')
antonyms = ruslingua.get_antonyms('дом')
associations = ruslingua.get_associations('дом')
cognates = ruslingua.get_cognate_words('дом')
definition = ruslingua.get_definition('дом')
print(synonyms)
print(antonyms)
print(associations)
print(cognates)
print(definition)
```
## Installation
```
pip install ruslingua
```
## Usage
Import the RusLingua class and instantiate it:
```python
from ruslingua import RusLingua
ruslingua = RusLingua()
```
Then call the methods with a word to get the linguistic information:
```python
synonyms = ruslingua.get_synonyms('дом')
antonyms = ruslingua.get_antonyms('дом')
associations = ruslingua.get_associations('дом')
cognates = ruslingua.get_cognate_words('дом')
definition = ruslingua.get_definition('дом')
```
The methods return lists of strings.
## Credits
RusLingua retrieves data from various sources:
- [jeck.ru](https://jeck.ru) - synonyms 👥
- [razbiraem-slovo.ru](https://razbiraem-slovo.ru) - antonyms 👎 and cognate words 🌳
- [wordassociations.net](https://wordassociations.net) - word associations ðŸ’
- [gramota.ru](https://gramota.ru) - definitions 📖
Raw data
{
"_id": null,
"home_page": "https://github.com/DedInc/ruslingua",
"name": "ruslingua",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "",
"author": "Maehdakvan",
"author_email": "visitanimation@google.com",
"download_url": "https://files.pythonhosted.org/packages/da/58/10fc43b0b85d426e86936b6c1de486cb1e5d225781c7f903199f747a5fbb/ruslingua-1.0.0.tar.gz",
"platform": null,
"description": "# RusLingua \ud83d\udcda\r\n\r\nRusLingua is a Python library for retrieving various linguistic information about Russian words. It provides a simple API to get synonyms, antonyms, word associations, cognate words, and definitions.\r\n\r\n## Features\r\n\r\n- Get synonyms of a word \ud83d\udc65\r\n- Get antonyms of a word \ud83d\udc4e\r\n- Get word associations \ud83d\udcad\r\n- Get cognate words (words with a common root) \ud83c\udf33\r\n- Get definitions from dictionaries \ud83d\udcd6\r\n\r\n## Quickstart\r\n\r\n```python\r\nfrom ruslingua import RusLingua\r\n\r\nruslingua = RusLingua()\r\n\r\nsynonyms = ruslingua.get_synonyms('\u0434\u043e\u043c')\r\nantonyms = ruslingua.get_antonyms('\u0434\u043e\u043c')\r\nassociations = ruslingua.get_associations('\u0434\u043e\u043c')\r\ncognates = ruslingua.get_cognate_words('\u0434\u043e\u043c') \r\ndefinition = ruslingua.get_definition('\u0434\u043e\u043c')\r\n\r\nprint(synonyms) \r\nprint(antonyms)\r\nprint(associations)\r\nprint(cognates)\r\nprint(definition)\r\n```\r\n\r\n## Installation \r\n\r\n```\r\npip install ruslingua\r\n```\r\n\r\n## Usage\r\n\r\nImport the RusLingua class and instantiate it:\r\n\r\n```python\r\nfrom ruslingua import RusLingua\r\n\r\nruslingua = RusLingua()\r\n```\r\n\r\nThen call the methods with a word to get the linguistic information:\r\n\r\n```python \r\nsynonyms = ruslingua.get_synonyms('\u0434\u043e\u043c')\r\nantonyms = ruslingua.get_antonyms('\u0434\u043e\u043c')\r\nassociations = ruslingua.get_associations('\u0434\u043e\u043c')\r\ncognates = ruslingua.get_cognate_words('\u0434\u043e\u043c')\r\ndefinition = ruslingua.get_definition('\u0434\u043e\u043c') \r\n```\r\n\r\nThe methods return lists of strings.\r\n\r\n## Credits \r\n\r\nRusLingua retrieves data from various sources:\r\n\r\n- [jeck.ru](https://jeck.ru) - synonyms \ud83d\udc65\r\n- [razbiraem-slovo.ru](https://razbiraem-slovo.ru) - antonyms \ud83d\udc4e and cognate words \ud83c\udf33\r\n- [wordassociations.net](https://wordassociations.net) - word associations \ud83d\udcad\r\n- [gramota.ru](https://gramota.ru) - definitions \ud83d\udcd6\r\n",
"bugtrack_url": null,
"license": "",
"summary": "",
"version": "1.0.0",
"project_urls": {
"Bug Tracker": "https://github.com/DedInc/ruslingua/issues",
"Homepage": "https://github.com/DedInc/ruslingua"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "661ee37994f25990b98642c2a9cbff7559114871f7852b5d15ca7f7ffa91f4c1",
"md5": "0a52ba6c16715790a41a1104f12f6c10",
"sha256": "fd3260aea74f8ff7fec268dd774697d7a0ba5ed3c14df155bf296b36edaf7798"
},
"downloads": -1,
"filename": "ruslingua-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0a52ba6c16715790a41a1104f12f6c10",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 3859,
"upload_time": "2024-01-10T15:40:18",
"upload_time_iso_8601": "2024-01-10T15:40:18.131498Z",
"url": "https://files.pythonhosted.org/packages/66/1e/e37994f25990b98642c2a9cbff7559114871f7852b5d15ca7f7ffa91f4c1/ruslingua-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "da5810fc43b0b85d426e86936b6c1de486cb1e5d225781c7f903199f747a5fbb",
"md5": "0bf3aab602fe49494343e36a1a087576",
"sha256": "55bb9207ae133c0c271d6a7f98f586903f83529b80159c50b71335f64d5003c9"
},
"downloads": -1,
"filename": "ruslingua-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "0bf3aab602fe49494343e36a1a087576",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 3622,
"upload_time": "2024-01-10T15:40:20",
"upload_time_iso_8601": "2024-01-10T15:40:20.274548Z",
"url": "https://files.pythonhosted.org/packages/da/58/10fc43b0b85d426e86936b6c1de486cb1e5d225781c7f903199f747a5fbb/ruslingua-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-10 15:40:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "DedInc",
"github_project": "ruslingua",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "ruslingua"
}