python-datamuse 1.3.0

Python wrapper for the Datamuse API

python-datamuse

Python wrapper and scripts for the Datamuse API. Available on PyPI at https://pypi.python.org/pypi/python-datamuse. You can install this library with pip3 install python-datamuse.

Changelog

Version 1.3.0

• Add optional arguments to suggest method

Version 1.2.1

• Fix README formatting on PyPI

Version 1.2.0

• Raise Python version to 3.6
• Mock the Datamuse API for tests
• Restructure project files
• Set README as PyPI long description

Version 1.1.0

• Changed to Python 3
• Uploaded to PyPI, added instructions for PyPI installation
• Changed README example to reflect PyPI packaging
• Set up Travis CI
• Temporarily removed pandas
• Changed mode of scripts to executable

Example

>>> from datamuse import datamuse
>>> api = datamuse.Datamuse()
>>> ninth_rhymes = api.words(rel_rhy='ninth', max=5)
>>> ninth_rhymes
[]
>>> orange_rhymes = api.words(rel_rhy='orange', max=5)
>>> orange_rhymes
[{'word': 'door hinge', 'score': 74, 'numSyllables': 2}]
>>> yellow_things = api.words(rel_jja='yellow', max=5)
>>> yellow_things
[{'word': 'fever', 'score': 1001}, {'word': 'color', 'score': 1000}, {'word': 'flowers', 'score': 999}, {'word': 'light', 'score': 998}, {'word': 'colour', 'score': 997}]
>>> foo_complete = api.suggest(s='foo', max=10)
>>> foo_complete
[{'word': 'food', 'score': 3888}, {'word': 'foot', 'score': 3041}, {'word': 'fool', 'score': 1836}, {'word': 'football', 'score': 1424}, {'word': 'footage', 'score': 1328}, {'word': 'footprint', 'score': 1082}, {'word': 'foolish', 'score': 967}, {'word': 'foof', 'score': 930}, {'word': 'footing', 'score': 786}, {'word': 'foolproof', 'score': 697}]

Note that the default number of results is set to 100. You can set the default max to something else using the set_max_default method, e.g. api.set_max_default(300). Datamuse only returns 1000 results max.