Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/tasdikrahman/vocabulary

[Not Maintained anymore] Python Module to get Meanings, Synonyms and what not for a given word
https://github.com/tasdikrahman/vocabulary

antonym api dictionary glosbe nlp pronunciation python synonyms wordnik

Last synced: 10 days ago
JSON representation

[Not Maintained anymore] Python Module to get Meanings, Synonyms and what not for a given word

Host: GitHub
URL: https://github.com/tasdikrahman/vocabulary
Owner: tasdikrahman
License: mit
Archived: true
Created: 2015-11-30T20:45:03.000Z (almost 9 years ago)
Default Branch: master
Last Pushed: 2019-11-04T04:42:35.000Z (about 5 years ago)
Last Synced: 2024-05-20T21:19:53.799Z (6 months ago)
Topics: antonym, api, dictionary, glosbe, nlp, pronunciation, python, synonyms, wordnik
Language: Python
Homepage: https://vocabulary.readthedocs.io/en/latest/
Size: 557 KB
Stars: 556
Watchers: 24
Forks: 75
Open Issues: 15
Metadata Files:
- Readme: README.rst
- Changelog: CHANGELOG.rst
- Contributing: CONTRIBUTING.rst
- License: LICENSE

Awesome Lists containing this project

README

        .. figure:: http://i.imgur.com/ddxYie4.jpg

   :alt:

Vocabulary

==========

|PyPI version| |License| |Python Versions| |Build Status| |Requirements Status| |Gitter chat|

A dictionary magician in the form of a module!

:Author: Tasdik Rahman

.. contents::

    :backlinks: none

.. sectnum::

What is it

----------

`[back to top] `__

For a given word, using ``Vocabulary``, you can get its

-  **Meaning**

-  **Synonyms**

-  **Antonyms**

-  **Part of speech** : whether the word is a ``noun``, ``interjection``

   or an ``adverb`` et el

-  **Translate** : Translate a phrase from a source language to the desired language.

-  **Usage example** : a quick example on how to use the word in a

   sentence

-  **Pronunciation**

-  **Hyphenation** : shows the particular stress points(if any)

Features

--------

`[back to top] `__

-  Written in uncomplicated ``Python``

-  Returns ``JSON`` objects, ``PYTHON`` dictionaries and lists

-  Minimum dependencies ( just uses `requests `__ module )

-  Easy to

   `install `__

-  A decent substitute to ``Wordnet``\ (well almost!) Wanna see? Here is

   a `small comparison <#wordnet-comparison>`__

-  Stupidly `easy to

   use `__

-  Fast!

-  Supports

   -  both, ``python2.*`` and ``python3.*``

   -  Works on Mac, Linux and Windows

Why should I use Vocabulary

---------------------------

`[back to top] `__

``Wordnet`` is a great resource. No doubt about it! So why should you

use ``Vocabulary`` when we already have ``Wordnet`` out there?

Wordnet Comparison

~~~~~~~~~~~~~~~~~~

`[back to top] `__

Let's say you want to find out the synonyms for the word ``car``.

-  Using ``Wordnet``

.. code:: python

    >>> from nltk.corpus import wordnet

    >>> syns = wordnet.synsets('car')

    >>> syns[0].lemmas[0].name

    'car'

    >>> [s.lemmas[0].name for s in syns]

    ['car', 'car', 'car', 'car', 'cable_car']

    >>> [l.name for s in syns for l in s.lemmas]

    ['car', 'auto', 'automobile', 'machine', 'motorcar', 'car', 'railcar', 'railway_car', 'railroad_car', 'car', 'gondola', 'car', 'elevator_car', 'cable_car', 'car']

-  Doing the same using ``Vocabulary``

.. code:: python

    >>> from vocabulary.vocabulary import Vocabulary as vb

    >>> vb.synonym("car")

    '[{

      "seq": 0,

      "text": "automobile"

    }, {

      "seq": 1,

      "text": "cart"

    }, {

      "seq": 2,

      "text": "automotive"

    }, {

      "seq": 3,

      "text": "wagon"

    }, {

      "seq": 4,

      "text": "motor"

    }]'

    >>> ## load the json data

    >>> car_synonyms = json.loads(vb.synonym("car"))

    >>> type(car_synonyms)

    

    >>>

So there you go. You get the data in an easy ``JSON`` format.

You can go on comparing for the other methods too.

Installation

------------

`[back to top] `__

Option 1: installing through `pip `__ (Suggested way)

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

`pypi package link `__

``$ pip install vocabulary``

If you are behind a proxy

``$ pip --proxy [username:password@]domain_name:port install vocabulary``

**Note:** If you get ``command not found`` then

``$ sudo apt-get install python-pip`` should fix that

Option 2: Installing from source (Only if you must)

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. code:: bash

    $ git clone https://github.com/tasdikrahman/vocabulary.git

    $ cd vocabulary/

    $ pip install -r requirements.txt

    $ python setup.py install

Demo

~~~~

`[back to top] `__

.. figure:: https://raw.githubusercontent.com/tasdikrahman/vocabulary/master/assets/usage.gif

   :alt: Demo link

.. figure:: https://raw.githubusercontent.com/tasdikrahman/vocabulary/master/assets/usage-format.gif

    :alt: Demo link

Documentation

-------------

`[back to top] `__

For a detailed usage example, refer the `documentation at Read the Docs `__

Contributing

------------

`[back to top] `__

Please refer `Contributing page for details `__

Discuss

~~~~~~~

`[back to top] `__

Join us on our `Gitter channel `__

if you want to chat or if you have any questions in your mind.

Contributers

~~~~~~~~~~~~

`[back to top] `__

-  Huge shoutout to `@tenorz007 `__ for adding the ability to return the API response as different data structures.

-  Thanks to `Anton Relin `__ for adding the `translate `__ module.

- And a big shout out to all the `contributers `__ for their contributions

Changelog

---------

`[back to top] `__

Please refer `Changelog page for details `__

Bugs

----

`[back to top] `__

Please report the bugs at the `issue

tracker `__

Similar

-------

`[back to top] `__

Other similar software inspired by `Vocabulary `__

-  `Vocabulary `__ : The ``Go lang`` port of this ``python`` counterpart

-  `woordy `__ : Gives back word translations

-  `guile-words `__ : The ``Guile Scheme`` port of this ``python`` counterpart

Known Issues

~~~~~~~~~~~~

`[back to top] `__

-  In **python2**, when using the method **Vocabulary.synonym()** or **Vocabulary.pronunciation()**

.. code:: python

    >>> vb.synonym("car")

    [{

      "seq": 0,

      "text": "automotive"

    }, {

      "seq": 1,

      "text": "motor"

    }, {

      "seq": 2,

      "text": "wagon"

    }, {

      "seq": 3,

      "text": "cart"

    }, {

      "seq": 4,

      "text": "automobile"

    }]

    >>> type(vb.pronunciation("hippopotamus"))

    

    >>> json.dumps(vb.pronunciation("hippopotamus"))

    '[{"raw": "(h\\u012dp\\u02cc\\u0259-p\\u014ft\\u02c8\\u0259-m\\u0259s)", "rawType": "ahd-legacy", "seq": 0}, {"raw": "HH IH2 P AH0 P AA1 T AH0 M AH0 S", "rawType": "arpabet", "seq": 1}]'

    >>>

You are being returned a ``list`` object instead of a ``JSON`` object.

When returning the latter, there are some ``unicode`` issues. A fix for

this will be released soon.

I may suggest `python-ftfy `__ which can help you in this matter.

License :

---------

`[back to top] `__

Built with ♥ by `Tasdik Rahman `__ under the `MIT License `__ ©

You can find a copy of the License at http://prodicus.mit-license.org/

Donation

--------

|Paypal badge|

|Instamojo|

|gratipay|

|patreon|

.. |PyPI version| image:: https://img.shields.io/pypi/v/Vocabulary.svg

   :target: https://pypi.python.org/pypi/Vocabulary/1.0.2

.. |License| image:: https://img.shields.io/pypi/l/vocabulary.svg

   :target: https://github.com/tasdikrahman/vocabulary/blob/master/LICENSE

.. |Python Versions| image:: https://img.shields.io/pypi/pyversions/Vocabulary.svg

.. |Build Status| image:: https://travis-ci.org/tasdikrahman/vocabulary.svg?branch=master

   :target: https://travis-ci.org/tasdikrahman/vocabulary

.. |Gitter chat| image:: https://img.shields.io/gitter/room/gitterHQ/gitter.svg

   :alt: Join the chat at https://gitter.im/prodicus/vocabulary

   :target: https://gitter.im/prodicus/vocabulary?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge

.. |Requirements Status| image:: https://requires.io/github/tasdikrahman/vocabulary/requirements.svg?branch=master

   :target: https://requires.io/github/tasdikrahman/vocabulary/requirements/?branch=master

.. |Paypal badge| image:: https://www.paypalobjects.com/webstatic/mktg/logo/AM_mc_vs_dc_ae.jpg

   :target: https://www.paypal.me/tasdik

.. |gratipay| image:: https://cdn.rawgit.com/gratipay/gratipay-badge/2.3.0/dist/gratipay.png

   :target: https://gratipay.com/tasdikrahman/

.. |Instamojo| image:: https://www.soldermall.com/images/pic-online-payment.jpg

   :target: https://www.instamojo.com/@tasdikrahman

.. |patreon| image:: http://i.imgur.com/ICWPFOs.png

   :target: https://www.patreon.com/tasdikrahman/