Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jacopofar/wordnet-as-a-service
WordNet behind a REST interface
https://github.com/jacopofar/wordnet-as-a-service
annotator hacktoberfest holonyms hyponyms wordnet
Last synced: 2 months ago
JSON representation
WordNet behind a REST interface
- Host: GitHub
- URL: https://github.com/jacopofar/wordnet-as-a-service
- Owner: jacopofar
- License: mit
- Created: 2016-07-03T18:22:07.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-11-14T23:26:03.000Z (about 1 year ago)
- Last Synced: 2024-10-09T00:08:41.881Z (4 months ago)
- Topics: annotator, hacktoberfest, holonyms, hyponyms, wordnet
- Language: Java
- Homepage:
- Size: 45.9 KB
- Stars: 13
- Watchers: 3
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-language-learning - wordnet-as-a-service - A REST interface for WordNet. (Developer Resources / Dictionary Data)
README
# wordnet-as-a-service
This application exposes a few WordNet functions with a simple REST interface.
In particular, can be used from a browser or as a text annotator.
The access to the WordNet database is done using [extJWNL](https://github.com/extjwnl/extjwnl)
How to use
-----
Run the service by cloning it and use `mvn compile && mvn exec:java` or using Docker
docker run -p 5679:5679 jacopofar/wordnet-as-a-service
__Retrieve hypernyms of a word:__
curl http://localhost:5679/hypernym/1/fork
[
{
"POS": "noun",
"word": "cutlery"
},
{
"POS": "noun",
"word": "eating utensil"
},
{
"POS": "noun",
"word": "division"
},
{
"POS": "verb",
"word": "lift"
},
...
__hyponyms__
curl http://localhost:5679/hyponym/1/tool
[
{
"POS": "noun",
"word": "abrader"
},
{
"POS": "noun",
"word": "abradant"
},
{
"POS": "noun",
"word": "bender"
},
...
__holonyms__
curl http://localhost:5679/holonym/1/France
[
{
"POS": "noun",
"word": "Europe"
},
{
"POS": "noun",
"word": "European Union"
},
{
"POS": "noun",
"word": "EU"
},
...
__synonyms, substance holonyms, meronyms and others__
Just change the first of the URL with one of: _holonym, entailment, substance_meronym, hyponym, antonym, synonym, substance_holonym, meronym, cause or hypernym_.
The number in the URL is the senses to be considered when retrieving the word synsets. Increasing it will lead to more results but often seemingly "wrong" ones.
__word definitions__
Use
http://localhost:5679/definition/can
to get the glosses:
[
{
"POS": "noun",
"gloss": "airtight sealed metal container for food or drink or paint etc.",
"other terms": "[can, tin can, tin]"
},
{
"POS": "noun",
"gloss": "the quantity contained in a can",
"other terms": "[can, canful]"
},
{
...
__As an annotator__
The server can also produce a list of annotations for a given text and pattern:
curl -X POST -H "Content-Type: application/json" '{"parameter":"pos=n,w=cat","text":"a feline is jumping right here"}' "http://localhost:5679/hypernyms_tagger/1"
will return:
{
"annotations": [
{
"span_start": 2,
"span_end": 8
}
]
}
__Generate a sample__
You can use the same format of the annotator to generate a sample of something matching the word type:
curl -X POST -H "Content-Type: application/json" -H "Cache-Control: no-cache" -H "Postman-Token: 41610ffd-f6e9-1573-850d-86b7bdcb29af" -d '{"parameter":"pos=n,w=bike"}' "http://localhost:5679/sample/hyponym/4"
will return, for example, _velocipede_.
This format is suitable to be used as an HTTP annotator/generator for [Fleximatcher](https://github.com/jacopofar/fleximatcher-web-interface)
Plurals
=======
The server uses [Evo inflector](https://github.com/atteo/evo-inflector) to educatedly guess English words plurals and match them (so, matching the hyponyms of "animal" will get "cats" as well as "cat")