Deprecation Warning: DatamuseRB will no longer extend the String class directly. String will only be extended within classes or modules using DatamuseRB starting in version 0.2.0. See the updated examples below.
DatamuseRb is yet another Ruby wrapper for the wonderful Datamuse API. The approach for this gem is a little different. DatamuseRb extends the Ruby String Class with Datamuse methods. Methods can be chained much like the actual Datamuse API allows.
Example: Words related to duck that start with the letter b
using DatamuseRB
"duck".means_like.spelled_like("b*")
Add this line to your application's Gemfile:
gem 'datamuse_rb'
And then execute:
$ bundle
Or install it yourself as:
$ gem install datamuse_rb
DatamuseRB currently supports all of the /words functions. Please visit the datamuse documentation for more details. Supported Datamuse Methods Include: [means_like: :ml, sounds_like: :sl, spelled_like: :sp, related_popular_nouns: :rel_jja, related_popular_adjectives: :rel_jjb, related_synonyms: :rel_syn, related_triggers: :rel_trg, related_antonyms: :rel_ant, kind_of_hyponyms: :rel_spc, general_hyponyms: :rel_gen, comporomise_hyponyms: :rel_com, part_of_meronyms: :rel_par, frequent_followers: :rel_bga, frequent_predecessors: :rel_bgb, related_rhymes: :rel_rhy, approximate_rhymes: :rel_nry related_homophones: :rel_hom,consonant_match: :rel_cns].
Basic Usage:
using DatamuseRB
#Call on any string
"ruby".means_like
=> #<DatamuseRB::DatamuseResult word="red", score=84986, tags=["syn", "n", "adj"]>
After checking out the repo, run bin/setup
to install dependencies. Then, run rake spec
to run the tests. You can also run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
. To release a new version, update the version number in version.rb
, and then run bundle exec rake release
, which will create a git tag for the version, push git commits and tags, and push the .gem
file to rubygems.org.
Bug reports and pull requests are welcome on GitHub at https://github.com/bynarlogic/datamuse-rb.
The gem is available as open source under the terms of the MIT License.