{
    "info": {
        "author": "Aid Ahmetovic",
        "author_email": "aidahmetovic91@gmail.com",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 5 - Production/Stable",
            "Intended Audience :: Developers",
            "Intended Audience :: Education",
            "Intended Audience :: Information Technology",
            "Intended Audience :: Science/Research",
            "License :: OSI Approved :: MIT License",
            "Programming Language :: Python :: 3",
            "Topic :: Text Processing :: General"
        ],
        "description": "## Python wrapper for obtaining synonyms in the German language from OpenThesaurus\n\n[![Codacy Badge](https://api.codacy.com/project/badge/Grade/2a302faa81aa41ed8647d917c268f5cd)](https://www.codacy.com?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=Aid91/py_openthesaurus&amp;utm_campaign=Badge_Grade)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n[![Build Status](https://travis-ci.org/Aid91/py_openthesaurus.svg?branch=master)](https://travis-ci.org/Aid91/py_openthesaurus)\n\nWhen working in Natural Language Processing (NLP) area, synonyms can be an essential part of the data augmentation process. The task of obtaining synonyms for the German language is currently limited since there are no easily accessible lexical databases for the German language. Compared to the WordNet\nlexical database for the English language, which is available as an **nltk** package,  [GermaNet](http://www.sfs.uni-tuebingen.de/GermaNet/) represents only one German lexical database alternative. However, to use **GermaNet** for further research purposes, it is necessary to obtain the license manually. \n\nThis repository represents a Python wrapper implementation for obtaining synonyms in a faster and easier way, using the German synonym database and API from [OpenThesaurus](https://www.openthesaurus.de/).\n\n### Installation\n\nThe library can be installed from PyPI:\n\n```pip install py-openthesaurus```\n\n### Download open-thesaurus database dump\n\nDownload the official open-thesaurus database dump from the following [link](https://www.openthesaurus.de/export/openthesaurus_dump.tar.bz2).\nIf the link is not working, please visit the following [page](https://www.openthesaurus.de/about/download) and download the up-to-date database dump.\n\n### Setup mysql and import open-thesaurus database dump\n\nTo install mysql-server on Ubuntu run:\n\n```console\nsudo apt-get update\nsudo apt-get install mysql-server\n```\n\nCreate a new database:\n\n```console\nmysql -u user_name -p\nmysql> create database database_name;\nmysql> exit\n```\n\nExtract the downloaded database dump file to import it using the following command:\n\n```console\nmysql -u user_name -p database_name < openthesaurus_dump.sql\n```\n\nTo use the `mysqlclient` library in Python on Ubuntu, install the following dependencies:\n\n```console\nsudo apt-get install python3-pip python3-dev libmysqlclient-dev\n```\n\nThis library, as a dependency, uses `mysqlclient` Python library. For support on other systems, please check the following [link](https://stackoverflow.com/questions/25865270/how-to-install-python-mysqldb-module-using-pip?answertab=votes#tab-top).\n\n### Usage\n\nAs a Python library, retrieving results from a previously imported database:\n\n```python\nfrom py_openthesaurus import OpenThesaurusDb\n\nopen_thesaurus = OpenThesaurusDb(host=\"host\", user=\"user\", passwd=\"passwd\", db_name=\"database_name\")\n\n# to get the short version of synonyms as a list\nsynonyms = open_thesaurus.get_synonyms(word=\"M\u00fcnchen\")\n\n# to get the long version of synonyms as a list\nsynonyms_long = open_thesaurus.get_synonyms(word=\"M\u00fcnchen\", form=\"long\")\n```\n\nAs a Python library, retrieving results from a web end-point:\n\n```python\nfrom py_openthesaurus import OpenThesaurusWeb\n\nopen_thesaurus = OpenThesaurusWeb()\n\n# to get the short version of synonyms as a list\nsynonyms = open_thesaurus.get_synonyms(word=\"M\u00fcnchen\")\n\n# to get the long version of synonyms as a list\nsynonyms_long = open_thesaurus.get_synonyms(word=\"M\u00fcnchen\", form=\"long\")\n```\n\nAs a command-line tool (which currently obtains results from a web API):\n\n```console\nusage: py_openthesaurus [-h] [--form {long,short}] --word WORD\n\nGet synonyms of German words from www.openthesaurus.de\n\noptional arguments:\n  -h, --help           show this help message and exit\n  --form {long,short}  Defaults to form=short which means that short versions\n                       of synonyms will be returned, without nach/zu\n                       prefixes/suffixes. On the other hand, form=long returns\n                       the full versions of synonyms, including nach/zu, sich\n                       prefixes/suffixes.\n\nrequired arguments:\n  --word WORD          A word from which synonyms will be obtained\n\n```\n\n### Acknowledgments\n\n* [OpenThesaurus](https://www.openthesaurus.de/) for developing a German synonym database with API from which synonyms for the German language can be obtained\n\n### Licence\n\nEven though this project is under MIT license, please check information about **OpenThesaurus** licensing and API limitations (only 60 requests per minute are currently supported) from the following [link](https://www.openthesaurus.de/about/api), in the case your software will need an exhaustive amount of web API requests in a short period of time. \n\n\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/Aid91/py_openthesaurus",
        "keywords": "Natural Language Processing,NLP,German",
        "license": "MIT",
        "maintainer": "",
        "maintainer_email": "",
        "name": "py-openthesaurus",
        "package_url": "https://pypi.org/project/py-openthesaurus/",
        "platform": "",
        "project_url": "https://pypi.org/project/py-openthesaurus/",
        "project_urls": {
            "Homepage": "https://github.com/Aid91/py_openthesaurus"
        },
        "release_url": "https://pypi.org/project/py-openthesaurus/1.0.5/",
        "requires_dist": [
            "mysqlclient (==2.0.3)"
        ],
        "requires_python": ">=3.5",
        "summary": "Python wrapper for obtaining synonyms in the German language from OpenThesaurus",
        "version": "1.0.5",
        "yanked": false,
        "yanked_reason": null
    },
    "last_serial": 9373546,
    "releases": {
        "1.0.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "a5c8310de93e0657269eac9df3d97da7",
                    "sha256": "36781aa59ac36e5c1d91e0908c512c945e0bc038f8667cad4661b98afdcdd35b"
                },
                "downloads": -1,
                "filename": "py_openthesaurus-1.0.0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "a5c8310de93e0657269eac9df3d97da7",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.5",
                "size": 5992,
                "upload_time": "2019-10-04T12:13:52",
                "upload_time_iso_8601": "2019-10-04T12:13:52.323683Z",
                "url": "https://files.pythonhosted.org/packages/cb/1c/fe626a24d8605943ee078a53b5053180edf403b5555eb4cc048df7462a0c/py_openthesaurus-1.0.0-py3-none-any.whl",
                "yanked": false,
                "yanked_reason": null
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "4541b43cf90ff3b4013ff3aac328dd58",
                    "sha256": "f9619cb530a2d8d04f0cd5942055a89eb3136977aa9b73053152a6a1541cef0d"
                },
                "downloads": -1,
                "filename": "py_openthesaurus-1.0.0.tar.gz",
                "has_sig": false,
                "md5_digest": "4541b43cf90ff3b4013ff3aac328dd58",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.5",
                "size": 4067,
                "upload_time": "2019-10-04T12:13:54",
                "upload_time_iso_8601": "2019-10-04T12:13:54.802783Z",
                "url": "https://files.pythonhosted.org/packages/e8/18/0e1ad0cb6c22ef9d14542a0a4407024f41440e1b16f93df0f6faee39f52d/py_openthesaurus-1.0.0.tar.gz",
                "yanked": false,
                "yanked_reason": null
            }
        ],
        "1.0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "07f48cf7866114e2090b14d6c3430a44",
                    "sha256": "28dd0f3df2a1613639d9a2014fc998cc3bd89491a7d655c32d83b31481af7e90"
                },
                "downloads": -1,
                "filename": "py_openthesaurus-1.0.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "07f48cf7866114e2090b14d6c3430a44",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.5",
                "size": 5991,
                "upload_time": "2019-10-04T12:19:20",
                "upload_time_iso_8601": "2019-10-04T12:19:20.393450Z",
                "url": "https://files.pythonhosted.org/packages/f3/b5/471c66b3cb30d57839ce5435c11842e0b175d5077d7eb1fe4817a616ee0a/py_openthesaurus-1.0.1-py3-none-any.whl",
                "yanked": false,
                "yanked_reason": null
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "d5aed5fd1d8546bb76f7ddbec219145b",
                    "sha256": "cd83ab705cf62d9f10bd78fa88c2ce7cce00af78d4f70e1acd547dcb84e5d30a"
                },
                "downloads": -1,
                "filename": "py_openthesaurus-1.0.1.tar.gz",
                "has_sig": false,
                "md5_digest": "d5aed5fd1d8546bb76f7ddbec219145b",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.5",
                "size": 4066,
                "upload_time": "2019-10-04T12:19:22",
                "upload_time_iso_8601": "2019-10-04T12:19:22.214781Z",
                "url": "https://files.pythonhosted.org/packages/73/17/61b0ab8c4c1c40733727dcf1f237aa3e532a9a807108734c8c7a66bd6c99/py_openthesaurus-1.0.1.tar.gz",
                "yanked": false,
                "yanked_reason": null
            }
        ],
        "1.0.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "e7f1954e65ab7cf32b331f6aa2a2734e",
                    "sha256": "bbad67259f0bafba90f29c1e113964a4e57d49d283f40bfe4decea773e1a77a6"
                },
                "downloads": -1,
                "filename": "py_openthesaurus-1.0.2-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "e7f1954e65ab7cf32b331f6aa2a2734e",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.5",
                "size": 5989,
                "upload_time": "2019-10-22T15:44:28",
                "upload_time_iso_8601": "2019-10-22T15:44:28.895455Z",
                "url": "https://files.pythonhosted.org/packages/1d/37/76e40f5c09f4e0af9f9c1dae218021b6d750679390365dada85dd6353f5a/py_openthesaurus-1.0.2-py3-none-any.whl",
                "yanked": false,
                "yanked_reason": null
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "7f32ea4052239b4c93041ffdc0157779",
                    "sha256": "e9475c8fbcd775c72ff22958a712c81432059d2f0ee245ea98bbef49b6aa9ee5"
                },
                "downloads": -1,
                "filename": "py_openthesaurus-1.0.2.tar.gz",
                "has_sig": false,
                "md5_digest": "7f32ea4052239b4c93041ffdc0157779",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.5",
                "size": 4054,
                "upload_time": "2019-10-22T15:44:30",
                "upload_time_iso_8601": "2019-10-22T15:44:30.310647Z",
                "url": "https://files.pythonhosted.org/packages/38/cc/5418464e98504b5d7cb56ce31a81c0d98c430d4ed053f399f59ec5a5192e/py_openthesaurus-1.0.2.tar.gz",
                "yanked": false,
                "yanked_reason": null
            }
        ],
        "1.0.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "b5b96f7f3b72d27bf0a2cf4f733042e2",
                    "sha256": "dfd1e0cc12f74a79354f2d39406748866cb61c78e5ccc2ccfdf086759ba16e97"
                },
                "downloads": -1,
                "filename": "py_openthesaurus-1.0.3-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "b5b96f7f3b72d27bf0a2cf4f733042e2",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.5",
                "size": 6056,
                "upload_time": "2019-10-23T08:37:57",
                "upload_time_iso_8601": "2019-10-23T08:37:57.845251Z",
                "url": "https://files.pythonhosted.org/packages/55/33/a43c2c7f77d0205073a3affffad65ccbbab3e0dad564275a689cff01d034/py_openthesaurus-1.0.3-py3-none-any.whl",
                "yanked": false,
                "yanked_reason": null
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "a1e2c51f6624d3859912947452359285",
                    "sha256": "1a868f3040245e97ad4f75ee0357d2545906a3f2100b342d1486102c09d657a1"
                },
                "downloads": -1,
                "filename": "py_openthesaurus-1.0.3.tar.gz",
                "has_sig": false,
                "md5_digest": "a1e2c51f6624d3859912947452359285",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.5",
                "size": 4114,
                "upload_time": "2019-10-23T08:37:59",
                "upload_time_iso_8601": "2019-10-23T08:37:59.604863Z",
                "url": "https://files.pythonhosted.org/packages/15/5c/6cfd2e7cee42ed14032e3d97f2b2dedc3be8f20d12e88c0f756522f8886c/py_openthesaurus-1.0.3.tar.gz",
                "yanked": false,
                "yanked_reason": null
            }
        ],
        "1.0.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "331d69e027ede6de0f860b50a077661c",
                    "sha256": "69513b76cecc075b02799d402db9c3d647a84a255d0a1015ea8455e64cc8cb12"
                },
                "downloads": -1,
                "filename": "py_openthesaurus-1.0.4-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "331d69e027ede6de0f860b50a077661c",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.5",
                "size": 7787,
                "upload_time": "2019-11-27T09:31:18",
                "upload_time_iso_8601": "2019-11-27T09:31:18.093993Z",
                "url": "https://files.pythonhosted.org/packages/b6/04/f5bdfe964ed36cf6c4c3beb2170855eb559bdf01eb30e0c748c15b76dc84/py_openthesaurus-1.0.4-py3-none-any.whl",
                "yanked": false,
                "yanked_reason": null
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "4f4184193c77af92d4710cd08979410f",
                    "sha256": "9bc803f4ac518727e4e410928c397af724efbcb9f3938b5396aba9363afdbbae"
                },
                "downloads": -1,
                "filename": "py_openthesaurus-1.0.4.tar.gz",
                "has_sig": false,
                "md5_digest": "4f4184193c77af92d4710cd08979410f",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.5",
                "size": 5697,
                "upload_time": "2019-11-27T09:31:19",
                "upload_time_iso_8601": "2019-11-27T09:31:19.947844Z",
                "url": "https://files.pythonhosted.org/packages/1b/b5/3ba6c2f2ce0b7240c85bb55043177e0812681cccaeddf785f1579a34491e/py_openthesaurus-1.0.4.tar.gz",
                "yanked": false,
                "yanked_reason": null
            }
        ],
        "1.0.4a0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "b6d1b1cc2692c5de8ebdee291d090757",
                    "sha256": "d3a8c8db68daeab92d875e29eaed6af6e3917ff99b03f6c7140194c660f36297"
                },
                "downloads": -1,
                "filename": "py_openthesaurus-1.0.4a0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "b6d1b1cc2692c5de8ebdee291d090757",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.5",
                "size": 7734,
                "upload_time": "2019-10-24T11:11:03",
                "upload_time_iso_8601": "2019-10-24T11:11:03.189143Z",
                "url": "https://files.pythonhosted.org/packages/6b/66/91e73e71606500dbc2949f651318356867a7e61db3f26ae85d02821a4720/py_openthesaurus-1.0.4a0-py3-none-any.whl",
                "yanked": false,
                "yanked_reason": null
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "077c592cb3d72b473ee82659f1c3b568",
                    "sha256": "f8cb9b2f79e29eebacd4041435e24db54b1077b855b255a3e0f30ae9ed05229a"
                },
                "downloads": -1,
                "filename": "py_openthesaurus-1.0.4a0.tar.gz",
                "has_sig": false,
                "md5_digest": "077c592cb3d72b473ee82659f1c3b568",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.5",
                "size": 5586,
                "upload_time": "2019-10-24T11:11:04",
                "upload_time_iso_8601": "2019-10-24T11:11:04.509118Z",
                "url": "https://files.pythonhosted.org/packages/65/2b/c603f53f65d68143070edcc54f76400c80e43eefd9b6da9405fa21a2e00d/py_openthesaurus-1.0.4a0.tar.gz",
                "yanked": false,
                "yanked_reason": null
            }
        ],
        "1.0.5": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "5ab786399ff6c9e581602b065acb3fe1",
                    "sha256": "068d466b1d898fb9d109494227d38f51caa0fbb9568c08692cf2aacaf353ba33"
                },
                "downloads": -1,
                "filename": "py_openthesaurus-1.0.5-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "5ab786399ff6c9e581602b065acb3fe1",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.5",
                "size": 7783,
                "upload_time": "2021-02-10T11:35:10",
                "upload_time_iso_8601": "2021-02-10T11:35:10.567377Z",
                "url": "https://files.pythonhosted.org/packages/20/92/2f54f974aee078e37ca964478ce40beb7853d060865f81df9516c3309df0/py_openthesaurus-1.0.5-py3-none-any.whl",
                "yanked": false,
                "yanked_reason": null
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "b014c1d6c52a1d3d99627648e0eccedf",
                    "sha256": "8b557cdf2a2b9b5f46f8d5d448ad1e818ebdd0683f896ca2304ded6ff4cde94a"
                },
                "downloads": -1,
                "filename": "py_openthesaurus-1.0.5.tar.gz",
                "has_sig": false,
                "md5_digest": "b014c1d6c52a1d3d99627648e0eccedf",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.5",
                "size": 6553,
                "upload_time": "2021-02-10T11:35:11",
                "upload_time_iso_8601": "2021-02-10T11:35:11.767928Z",
                "url": "https://files.pythonhosted.org/packages/7e/41/60c9c28a9161a0e336d88e9574de72387637ee988547d0d80f75beb70a0a/py_openthesaurus-1.0.5.tar.gz",
                "yanked": false,
                "yanked_reason": null
            }
        ],
        "1.0.5a0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "f979a720eab7568083efdedb9e0d077e",
                    "sha256": "3cc859d52b690361e5ef2d42acd73ff9c8674c6aad1d4d0f12d91f6eae20b00a"
                },
                "downloads": -1,
                "filename": "py_openthesaurus-1.0.5a0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "f979a720eab7568083efdedb9e0d077e",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">=3.5",
                "size": 7813,
                "upload_time": "2021-02-10T11:32:07",
                "upload_time_iso_8601": "2021-02-10T11:32:07.398697Z",
                "url": "https://files.pythonhosted.org/packages/d1/7b/ecf252197db91ce3f9b5af4fa7ad829c90e03f8be2689dd245323d7b1430/py_openthesaurus-1.0.5a0-py3-none-any.whl",
                "yanked": false,
                "yanked_reason": null
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "7c49c951879b974aabb81e2312c78b0e",
                    "sha256": "05cb1be30e73cdc09eb4b0c828f0cc8395bcef5d4315848e384f809b238f6684"
                },
                "downloads": -1,
                "filename": "py_openthesaurus-1.0.5a0.tar.gz",
                "has_sig": false,
                "md5_digest": "7c49c951879b974aabb81e2312c78b0e",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">=3.5",
                "size": 6564,
                "upload_time": "2021-02-10T11:32:08",
                "upload_time_iso_8601": "2021-02-10T11:32:08.739684Z",
                "url": "https://files.pythonhosted.org/packages/5d/db/327fcf91ad78e133ebe12039d38c0c439122a84692233fab104c359d3564/py_openthesaurus-1.0.5a0.tar.gz",
                "yanked": false,
                "yanked_reason": null
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "5ab786399ff6c9e581602b065acb3fe1",
                "sha256": "068d466b1d898fb9d109494227d38f51caa0fbb9568c08692cf2aacaf353ba33"
            },
            "downloads": -1,
            "filename": "py_openthesaurus-1.0.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "5ab786399ff6c9e581602b065acb3fe1",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.5",
            "size": 7783,
            "upload_time": "2021-02-10T11:35:10",
            "upload_time_iso_8601": "2021-02-10T11:35:10.567377Z",
            "url": "https://files.pythonhosted.org/packages/20/92/2f54f974aee078e37ca964478ce40beb7853d060865f81df9516c3309df0/py_openthesaurus-1.0.5-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "b014c1d6c52a1d3d99627648e0eccedf",
                "sha256": "8b557cdf2a2b9b5f46f8d5d448ad1e818ebdd0683f896ca2304ded6ff4cde94a"
            },
            "downloads": -1,
            "filename": "py_openthesaurus-1.0.5.tar.gz",
            "has_sig": false,
            "md5_digest": "b014c1d6c52a1d3d99627648e0eccedf",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.5",
            "size": 6553,
            "upload_time": "2021-02-10T11:35:11",
            "upload_time_iso_8601": "2021-02-10T11:35:11.767928Z",
            "url": "https://files.pythonhosted.org/packages/7e/41/60c9c28a9161a0e336d88e9574de72387637ee988547d0d80f75beb70a0a/py_openthesaurus-1.0.5.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "vulnerabilities": []
}