# TivWordNet
**TivWordNet** is a semantic network for the Tiv language, modeled after WordNet. It provides functionality to manage synsets, retrieve hypernyms and hyponyms, and work with definitions and lemmas. The package uses text files for data storage and supports basic operations for lexical semantic processing.
## Installation
To install TivWordNet, you can use `pip`:
```bash
pip install tivwordnet
Usage
Importing the Package
First, import the TivWordNet class from the package:
from tivwordnet import TivWordNet
Initialize TivWordNet
Create an instance of TivWordNet:
wn = TivWordNet()
Adding a Synset
To add a new synset, use the add_synset method:
wn.add_synset('tiv', 1, 'A language spoken by the Tiv people.')
Retrieving Synsets
To retrieve synsets for a word:
synsets = wn.get_synsets('tiv')
for synset in synsets:
print(f"Lemma: {synset.get_lemma()}")
print(f"Definition: {synset.get_definition()}")
Adding Hypernyms and Hyponyms
You can add hypernyms and hyponyms to a synset:
wn.add_hypernym('tiv', 1, 'language')
wn.add_hyponym('tiv', 1, 'Tiv language')
Retrieving Hypernyms and Hyponyms
To get hypernyms and hyponyms for a synset:
synsets = wn.get_synsets('tiv')
synset = synsets[0] if synsets else None
if synset:
hypernyms = wn.get_hypernyms(synset)
hyponyms = wn.get_hyponyms(synset)
print("Hypernyms:")
for hypernym_set in hypernyms:
for word in hypernym_set:
print(word.get_lemma())
print("Hyponyms:")
for hyponym_set in hyponyms:
for word in hyponym_set:
print(word.get_lemma())
Getting Common Hypernyms and Hyponyms
To find common hypernyms or hyponyms between two synsets:
synset1 = wn.get_synsets('tiv')[0] if wn.get_synsets('tiv') else None
synset2 = wn.get_synsets('language')[0] if wn.get_synsets('language') else None
if synset1 and synset2:
common_hypernyms = wn.get_common_hypernyms(synset1, synset2)
common_hyponyms = wn.get_common_hyponyms(synset1, synset2)
print("Common Hypernyms:")
for hypernym in common_hypernyms:
for word in hypernym:
print(word.get_lemma())
print("Common Hyponyms:")
for hyponym in common_hyponyms:
for word in hyponym:
print(word.get_lemma())
Data Files
The package uses the following text files to store data:
tivwordnet/data/tiv_synsets.txt: Contains synsets, definitions, and relations (e.g., hypernyms and hyponyms).
tivwordnet/data/tiv_definitions.txt: Contains definitions for individual words (if required for further expansion).
License
TivWordNet is distributed under the MIT License. See LICENSE for more information.
Support
For questions or issues, please open an issue on GitHub or contact support at danterkum16@gmail.com.
Contributing
Contributions are welcome! Please fork the repository and submit a pull request with your changes.
Acknowledgements
This project is inspired by WordNet and similar lexical databases.
### Explanation
1. **Installation**: Instructions for installing the package with `pip`.
2. **Usage**: Detailed examples of how to use the package to add synsets, retrieve synsets, and get hypernyms and hyponyms.
3. **Data Files**: Information on the data files used by the package.
4. **License**: Details about the license under which the package is distributed.
5. **Support**: Information on how to get help or report issues.
6. **Contributing**: Guidelines for contributing to the project.
7. **Acknowledgements**: Credits for inspiration and sources.
Raw data
{
"_id": null,
"home_page": "https://github.com/Dankummzy/tivwordnet",
"name": "tivwordnet",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": null,
"author": "Daniel Kumaga",
"author_email": "danterkum16@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/94/88/c3f380b0a386cc1c8feeea683d78671e913cfa419125219bf8a247ba6366/tivwordnet-0.1.0.tar.gz",
"platform": null,
"description": "# TivWordNet\r\n\r\n**TivWordNet** is a semantic network for the Tiv language, modeled after WordNet. It provides functionality to manage synsets, retrieve hypernyms and hyponyms, and work with definitions and lemmas. The package uses text files for data storage and supports basic operations for lexical semantic processing.\r\n\r\n## Installation\r\n\r\nTo install TivWordNet, you can use `pip`:\r\n\r\n```bash\r\npip install tivwordnet\r\n\r\nUsage\r\n\r\nImporting the Package\r\nFirst, import the TivWordNet class from the package:\r\n\r\n\r\nfrom tivwordnet import TivWordNet\r\nInitialize TivWordNet\r\n\r\nCreate an instance of TivWordNet:\r\nwn = TivWordNet()\r\n\r\n\r\nAdding a Synset\r\nTo add a new synset, use the add_synset method:\r\nwn.add_synset('tiv', 1, 'A language spoken by the Tiv people.')\r\n\r\n\r\nRetrieving Synsets\r\nTo retrieve synsets for a word:\r\nsynsets = wn.get_synsets('tiv')\r\n\r\nfor synset in synsets:\r\n print(f\"Lemma: {synset.get_lemma()}\")\r\n print(f\"Definition: {synset.get_definition()}\")\r\n\r\n\r\nAdding Hypernyms and Hyponyms\r\nYou can add hypernyms and hyponyms to a synset:\r\n\r\nwn.add_hypernym('tiv', 1, 'language')\r\nwn.add_hyponym('tiv', 1, 'Tiv language')\r\n\r\n\r\nRetrieving Hypernyms and Hyponyms\r\nTo get hypernyms and hyponyms for a synset:\r\n\r\nsynsets = wn.get_synsets('tiv')\r\nsynset = synsets[0] if synsets else None\r\n\r\nif synset:\r\n hypernyms = wn.get_hypernyms(synset)\r\n hyponyms = wn.get_hyponyms(synset)\r\n \r\n print(\"Hypernyms:\")\r\n for hypernym_set in hypernyms:\r\n for word in hypernym_set:\r\n print(word.get_lemma())\r\n \r\n print(\"Hyponyms:\")\r\n for hyponym_set in hyponyms:\r\n for word in hyponym_set:\r\n print(word.get_lemma())\r\n\r\n\r\nGetting Common Hypernyms and Hyponyms\r\nTo find common hypernyms or hyponyms between two synsets:\r\n\r\nsynset1 = wn.get_synsets('tiv')[0] if wn.get_synsets('tiv') else None\r\nsynset2 = wn.get_synsets('language')[0] if wn.get_synsets('language') else None\r\n\r\nif synset1 and synset2:\r\n common_hypernyms = wn.get_common_hypernyms(synset1, synset2)\r\n common_hyponyms = wn.get_common_hyponyms(synset1, synset2)\r\n \r\n print(\"Common Hypernyms:\")\r\n for hypernym in common_hypernyms:\r\n for word in hypernym:\r\n print(word.get_lemma())\r\n \r\n print(\"Common Hyponyms:\")\r\n for hyponym in common_hyponyms:\r\n for word in hyponym:\r\n print(word.get_lemma())\r\n\r\nData Files\r\nThe package uses the following text files to store data:\r\n\r\ntivwordnet/data/tiv_synsets.txt: Contains synsets, definitions, and relations (e.g., hypernyms and hyponyms).\r\ntivwordnet/data/tiv_definitions.txt: Contains definitions for individual words (if required for further expansion).\r\n\r\nLicense\r\nTivWordNet is distributed under the MIT License. See LICENSE for more information.\r\n\r\nSupport\r\nFor questions or issues, please open an issue on GitHub or contact support at danterkum16@gmail.com.\r\n\r\nContributing\r\nContributions are welcome! Please fork the repository and submit a pull request with your changes.\r\n\r\nAcknowledgements\r\nThis project is inspired by WordNet and similar lexical databases.\r\n\r\n### Explanation\r\n\r\n1. **Installation**: Instructions for installing the package with `pip`.\r\n2. **Usage**: Detailed examples of how to use the package to add synsets, retrieve synsets, and get hypernyms and hyponyms.\r\n3. **Data Files**: Information on the data files used by the package.\r\n4. **License**: Details about the license under which the package is distributed.\r\n5. **Support**: Information on how to get help or report issues.\r\n6. **Contributing**: Guidelines for contributing to the project.\r\n7. **Acknowledgements**: Credits for inspiration and sources.\r\n\r\n\r\n",
"bugtrack_url": null,
"license": null,
"summary": "A semantic network for the Tiv language, modeled after WordNet",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/Dankummzy/tivwordnet"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "01b3d0a84a2462a1d07a0748c4d5d78b66b22e495e4536795f593b8fbb1ec272",
"md5": "a8a1dbdf3d46bcb33796185e6f60cf03",
"sha256": "58171239ba57e1fce42d2c6d432c7159fd03c5cb344563ef7174895094f46262"
},
"downloads": -1,
"filename": "tivwordnet-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a8a1dbdf3d46bcb33796185e6f60cf03",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 3974,
"upload_time": "2024-09-01T02:17:15",
"upload_time_iso_8601": "2024-09-01T02:17:15.473216Z",
"url": "https://files.pythonhosted.org/packages/01/b3/d0a84a2462a1d07a0748c4d5d78b66b22e495e4536795f593b8fbb1ec272/tivwordnet-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9488c3f380b0a386cc1c8feeea683d78671e913cfa419125219bf8a247ba6366",
"md5": "a69e39cebb6f766bc8c004bc422ad1bb",
"sha256": "b7b1307104991ad456a2f787ea4936905d9b2a2e52b3f851af2492ddcbc99aa2"
},
"downloads": -1,
"filename": "tivwordnet-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "a69e39cebb6f766bc8c004bc422ad1bb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 3447,
"upload_time": "2024-09-01T02:17:17",
"upload_time_iso_8601": "2024-09-01T02:17:17.484390Z",
"url": "https://files.pythonhosted.org/packages/94/88/c3f380b0a386cc1c8feeea683d78671e913cfa419125219bf8a247ba6366/tivwordnet-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-01 02:17:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Dankummzy",
"github_project": "tivwordnet",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "tivwordnet"
}
JSON
