ruslingua

Name	ruslingua JSON
Version	1.0.1 JSON
	download
home_page	https://github.com/DedInc/ruslingua
Summary	It's a Python library for retrieving various linguistic information about Russian words
upload_time	2025-07-14 17:28:51
maintainer	None
docs_url	None
author	Maehdakvan
requires_python	>=3.6
license	None
keywords
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # RusLingua 📚

RusLingua is a Python library for retrieving various linguistic information about Russian words. It provides a simple API to get synonyms, antonyms, cognate words, and definitions.

## Features

- Get synonyms of a word 👥
- Get antonyms of a word 👎
- Get cognate words (words with a common root) 🌳
- Get definitions from dictionaries 📖

## Quickstart

### Synchronous Usage
```python
from ruslingua import RusLingua

ruslingua = RusLingua()

synonyms = ruslingua.get_synonyms('дом')
antonyms = ruslingua.get_antonyms('дом')
cognates = ruslingua.get_cognate_words('дом')
definition = ruslingua.get_definition('дом')

print(synonyms)
print(antonyms)
print(cognates)
print(definition)
```

### Asynchronous Usage
```python
import asyncio
from ruslingua import AsyncRusLingua

async def main():
    ruslingua = AsyncRusLingua()

    synonyms = await ruslingua.get_synonyms('дом')
    antonyms = await ruslingua.get_antonyms('дом')
    cognates = await ruslingua.get_cognate_words('дом')
    definition = await ruslingua.get_definition('дом')

    print(synonyms)
    print(antonyms)
    print(cognates)
    print(definition)

if __name__ == "__main__":
    asyncio.run(main())
```

## Installation 

```
pip install ruslingua
```

## Usage

### Synchronous

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('дом')
cognates = ruslingua.get_cognate_words('дом')
definition = ruslingua.get_definition('дом')
```

### Asynchronous

Import the `AsyncRusLingua` class and use it with `asyncio`:

```python
import asyncio
from ruslingua import AsyncRusLingua

async def main():
    ruslingua = AsyncRusLingua()
    # ... use the methods as shown in the quickstart ...

if __name__ == "__main__":
    asyncio.run(main())
```

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 🌳
- [gramota.ru](https://gramota.ru) - definitions 📖

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/DedInc/ruslingua",
    "name": "ruslingua",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": null,
    "keywords": null,
    "author": "Maehdakvan",
    "author_email": "visitanimation@google.com",
    "download_url": "https://files.pythonhosted.org/packages/09/56/d6f9f230699fb710e32b3be88b9336b0926b6133d1057a131e5c43476390/ruslingua-1.0.1.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, 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 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### Synchronous Usage\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\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(cognates)\r\nprint(definition)\r\n```\r\n\r\n### Asynchronous Usage\r\n```python\r\nimport asyncio\r\nfrom ruslingua import AsyncRusLingua\r\n\r\nasync def main():\r\n    ruslingua = AsyncRusLingua()\r\n\r\n    synonyms = await ruslingua.get_synonyms('\u0434\u043e\u043c')\r\n    antonyms = await ruslingua.get_antonyms('\u0434\u043e\u043c')\r\n    cognates = await ruslingua.get_cognate_words('\u0434\u043e\u043c')\r\n    definition = await ruslingua.get_definition('\u0434\u043e\u043c')\r\n\r\n    print(synonyms)\r\n    print(antonyms)\r\n    print(cognates)\r\n    print(definition)\r\n\r\nif __name__ == \"__main__\":\r\n    asyncio.run(main())\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\n### Synchronous\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\ncognates = ruslingua.get_cognate_words('\u0434\u043e\u043c')\r\ndefinition = ruslingua.get_definition('\u0434\u043e\u043c')\r\n```\r\n\r\n### Asynchronous\r\n\r\nImport the `AsyncRusLingua` class and use it with `asyncio`:\r\n\r\n```python\r\nimport asyncio\r\nfrom ruslingua import AsyncRusLingua\r\n\r\nasync def main():\r\n    ruslingua = AsyncRusLingua()\r\n    # ... use the methods as shown in the quickstart ...\r\n\r\nif __name__ == \"__main__\":\r\n    asyncio.run(main())\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- [gramota.ru](https://gramota.ru) - definitions \ud83d\udcd6\r\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "It's a Python library for retrieving various linguistic information about Russian words",
    "version": "1.0.1",
    "project_urls": {
        "Bug Tracker": "https://github.com/DedInc/ruslingua/issues",
        "Homepage": "https://github.com/DedInc/ruslingua"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "a29a07bfdcbe604164be781922a923bb82b2c3c9e545c82c4fc531c9b6037dd2",
                "md5": "268f3ea7788b160792c53fb8e16cc092",
                "sha256": "e6cbd4531768a6a2f76873f3517525c7de976a25b5f2f9c656d32fe26222234b"
            },
            "downloads": -1,
            "filename": "ruslingua-1.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "268f3ea7788b160792c53fb8e16cc092",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6",
            "size": 4157,
            "upload_time": "2025-07-14T17:28:50",
            "upload_time_iso_8601": "2025-07-14T17:28:50.788182Z",
            "url": "https://files.pythonhosted.org/packages/a2/9a/07bfdcbe604164be781922a923bb82b2c3c9e545c82c4fc531c9b6037dd2/ruslingua-1.0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "0956d6f9f230699fb710e32b3be88b9336b0926b6133d1057a131e5c43476390",
                "md5": "6bdc767349b85f228328a945827b71ff",
                "sha256": "2bd85f02a01b83612faa128a54dcf24a18933c5239899fb339e5a6f4286a2493"
            },
            "downloads": -1,
            "filename": "ruslingua-1.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "6bdc767349b85f228328a945827b71ff",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 3865,
            "upload_time": "2025-07-14T17:28:51",
            "upload_time_iso_8601": "2025-07-14T17:28:51.823267Z",
            "url": "https://files.pythonhosted.org/packages/09/56/d6f9f230699fb710e32b3be88b9336b0926b6133d1057a131e5c43476390/ruslingua-1.0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-14 17:28:51",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "DedInc",
    "github_project": "ruslingua",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "ruslingua"
}