{"id":16359703,"url":"https://github.com/jmsv/ety-python","last_synced_at":"2025-04-06T19:11:31.097Z","repository":{"id":32430725,"uuid":"133350735","full_name":"jmsv/ety-python","owner":"jmsv","description":"A Python module to discover the etymology of words","archived":false,"fork":false,"pushed_at":"2024-05-02T11:38:54.000Z","size":37651,"stargazers_count":145,"open_issues_count":5,"forks_count":18,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-10-12T02:09:29.857Z","etag":null,"topics":["english","etymology","hacktoberfest","language","origins","python","words"],"latest_commit_sha":null,"homepage":"http://ety-python.rtfd.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jmsv.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-05-14T11:30:21.000Z","updated_at":"2024-10-10T20:07:06.000Z","dependencies_parsed_at":"2024-05-02T12:49:55.828Z","dependency_job_id":"dba59e26-78be-4541-ab96-677f924c4ccc","html_url":"https://github.com/jmsv/ety-python","commit_stats":{"total_commits":124,"total_committers":7,"mean_commits":"17.714285714285715","dds":0.3870967741935484,"last_synced_commit":"15ddf84b658bb1ccc91e793e2014d17fde80457b"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmsv%2Fety-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmsv%2Fety-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmsv%2Fety-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmsv%2Fety-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jmsv","download_url":"https://codeload.github.com/jmsv/ety-python/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247535517,"owners_count":20954576,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["english","etymology","hacktoberfest","language","origins","python","words"],"created_at":"2024-10-11T02:09:26.728Z","updated_at":"2025-04-06T19:11:31.077Z","avatar_url":"https://github.com/jmsv.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![ety](https://user-images.githubusercontent.com/14852491/52982538-880fbd80-33de-11e9-8101-6fa24c3b697d.png)\r\n\r\n\u003cp align=\"center\"\u003e\r\n\u003ca href=\"https://badge.fury.io/py/ety\"\u003e\u003cimg src=\"https://badge.fury.io/py/ety.svg\" alt=\"PyPI version\"\u003e\u003c/a\u003e\r\n\u003ca href=\"https://pypi.python.org/pypi/ety\"\u003e\u003cimg src=\"https://img.shields.io/pypi/pyversions/ety.svg\" alt=\"Python versions\"\u003e\u003c/a\u003e\r\n\u003ca href=\"https://pypi.python.org/pypi/ety\"\u003e\u003cimg src=\"https://img.shields.io/pypi/wheel/ety.svg\" alt=\"Wheel Support\"\u003e\u003c/a\u003e\r\n\u003ca href=\"https://ety-python.readthedocs.io/en/latest/?badge=latest\"\u003e\u003cimg src=\"https://readthedocs.org/projects/ety-python/badge/?version=latest\" alt=\"Documentation Status\"\u003e\u003c/a\u003e\u003cbr\u003e\r\n\u003ca href=\"https://travis-ci.org/jmsv/ety-python\"\u003e\u003cimg src=\"https://travis-ci.org/jmsv/ety-python.svg?branch=master\" alt=\"Build Status\"\u003e\u003c/a\u003e\r\n\u003ca href=\"https://github.com/ambv/black\"\u003e\u003cimg src=\"https://img.shields.io/badge/code%20style-black-000000.svg\" alt=\"Code style: black\"\u003e\u003c/a\u003e\r\n\u003c/p\u003e\r\n\r\n---\r\n\r\n## Intro\r\n\r\n[@jmsv](https://github.com/jmsv) and [@parker57](https://github.com/parker57) started a side project to analyse etymologies of text written by various historical authors, expecting there to already be a library for retrieving etymological data. On discovering that this wasn't the case, [ety](https://github.com/jmsv/ety-python) was created!\r\n\r\nThere isn't a single source of truth for etymologies; words' origins can be heavily disputed. This package's source data, Gerard de Melo's [Etymological Wordnet](http://www1.icsi.berkeley.edu/~demelo/etymwn/), is mostly mined from Wiktionary. Since this is a collaboratively edited dictionary, its data could be seen as the closest we can get to a public consensus.\r\n\r\n## Install\r\n\r\n### [pip](https://pypi.org/project/ety)\r\n\r\n```bash\r\npip install ety\r\n```\r\n\r\n## Usage\r\n\r\n### Module\r\n\r\n```python\r\n\u003e\u003e\u003e import ety\r\n\r\n\u003e\u003e\u003e ety.origins(\"potato\")\r\n[Word(batata, language=Taino)]\r\n\r\n\u003e\u003e\u003e ety.origins(\"drink\", recursive=True)\r\n[Word(drync, language=Old English (ca. 450-1100)), Word(drinken, language=Middle English (1100-1500)), Word(drincan, language=Old English (ca. 450-1100))]\r\n\r\n\u003e\u003e\u003e print(ety.tree(\"aerodynamically\"))\r\naerodynamically (English)\r\n├── -ally (English)\r\n└── aerodynamic (English)\r\n    ├── aero- (English)\r\n    │   └── ἀήρ (Ancient Greek (to 1453))\r\n    └── dynamic (English)\r\n        └── dynamique (French)\r\n            └── δυναμικός (Ancient Greek (to 1453))\r\n                └── δύναμις (Ancient Greek (to 1453))\r\n                    └── δύναμαι (Ancient Greek (to 1453))\r\n```\r\n\r\n### CLI\r\n\r\nAfter installing, a command-line tool is also available. `ety -h` outputs the following help text describing arguments:\r\n\r\n```\r\nusage: ety [-h] [-r] [-t] words [words ...]\r\n\r\npositional arguments:\r\n  words            the search word(s)\r\n\r\noptional arguments:\r\n  -h, --help       show this help message and exit\r\n  -r, --recursive  search origins recursively\r\n  -t, --tree       display etymology tree\r\n```\r\n\r\n#### Examples\r\n\r\n```bash\r\n$ ety drink\r\ndrink   # List direct origins\r\n • drync (Old English (ca. 450-1100))\r\n • drinken (Middle English (1100-1500))\r\n\r\n$ ety drink -r   # Recursive search\r\ndrink\r\n • drync (Old English (ca. 450-1100))\r\n • drinken (Middle English (1100-1500))\r\n • drincan (Old English (ca. 450-1100))\r\n\r\n$ ety drink -t   # Etymology tree\r\ndrink (English)\r\n├── drinken (Middle English (1100-1500))\r\n│   └── drincan (Old English (ca. 450-1100))\r\n└── drync (Old English (ca. 450-1100))\r\n```\r\n\r\n## Development\r\n\r\nIn a virtual environment - [Pipenv](https://docs.pipenv.org) is recommended:\r\n\r\n```bash\r\npython setup.py install\r\n```\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmsv%2Fety-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjmsv%2Fety-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmsv%2Fety-python/lists"}