merriam_webster_plus 0.1.0

data/fixtures/vcr_cassettes/word_not_in_dictionary_primary_entry.yml

@@ -0,0 +1,141 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://www.dictionaryapi.com/api/v3/references/thesaurus/json/pardoned?key=<COLLEGIATE_THESAURUS_API_KEY>
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Tue, 21 Jun 2022 23:24:58 GMT
+      Content-Type:
+      - application/json; charset=utf-8
+      Content-Length:
+      - '1270'
+      Connection:
+      - keep-alive
+      Server:
+      - Apache
+      Cache-Control:
+      - max-age=86400, public
+      Pragma:
+      - cache
+      Vary:
+      - Accept-Encoding
+      Access-Control-Allow-Origin:
+      - "*"
+    body:
+      encoding: ASCII-8BIT
+      string: '[{"meta":{"id":"pardoned","uuid":"2ac7ae9c-5b1c-4f5a-9ff5-89ed65cd08ce","src":"coll_thes","section":"alpha","stems":["pardoned"],"syns":[["forgave"],["blinked
+        (at)","brushed (aside or off)","condoned","discounted","disregarded","excused","forgave","glossed
+        (over)","glozed (over)","ignored","overlooked","overpassed","papered over","passed
+        over","remitted","shrugged off","whitewashed","winked (at)"]],"ants":[["resented"]],"offensive":false},"hwi":{"hw":"pardoned"},"fl":"verb","sls":["past
+        tense of {d_link|pardon|pardon}"],"def":[{"sseq":[[["sense",{"sn":"1","dt":[["text","to
+        cease to have feelings of anger or bitterness toward "],["vis",[{"t":"he eventually
+        {it}pardoned{\/it} his sister after she apologized"}]]],"syn_list":[[{"wd":"forgave"}]],"rel_list":[[{"wd":"absolved"},{"wd":"acquitted"},{"wd":"cleared"},{"wd":"exculpated"},{"wd":"exonerated"},{"wd":"vindicated"}],[{"wd":"remitted"},{"wd":"shrived","wvrs":[{"wvl":"or","wva":"shrove"}]}],[{"wd":"condoned"},{"wd":"disregarded"},{"wd":"excused"},{"wd":"ignored"},{"wd":"passed
+        over"},{"wd":"shrugged off"}],[{"wd":"discharged"},{"wd":"liberated"},{"wd":"redeemed"},{"wd":"released"},{"wd":"unburdened"}]],"near_list":[[{"wd":"abhorred"},{"wd":"abominated"},{"wd":"despised"},{"wd":"detested"},{"wd":"disliked"},{"wd":"execrated"},{"wd":"hated"},{"wd":"loathed"}],[{"wd":"avenged"},{"wd":"redressed"},{"wd":"requited"},{"wd":"retaliated"},{"wd":"revenged"}],[{"wd":"disciplined"},{"wd":"penalized"},{"wd":"punished"}]],"ant_list":[[{"wd":"resented"}]]}]],[["sense",{"sn":"2","dt":[["text","to
+        dismiss as of little importance "],["vis",[{"t":"I\u0027m willing to {it}pardon{\/it}
+        a little sloppiness of dress in such a kind and loving person"}]]],"syn_list":[[{"wd":"blinked
+        (at)"},{"wd":"brushed (aside or off)"},{"wd":"condoned"},{"wd":"discounted"},{"wd":"disregarded"},{"wd":"excused"},{"wd":"forgave"},{"wd":"glossed
+        (over)"},{"wd":"glozed (over)"},{"wd":"ignored"},{"wd":"overlooked"},{"wd":"overpassed"},{"wd":"papered
+        over"},{"wd":"passed over"},{"wd":"remitted"},{"wd":"shrugged off"},{"wd":"whitewashed"},{"wd":"winked
+        (at)"}]],"rel_list":[[{"wd":"explained"},{"wd":"justified"},{"wd":"rationalized"}],[{"wd":"absolved"},{"wd":"acquitted"},{"wd":"cleared"},{"wd":"exculpated"},{"wd":"exonerated"},{"wd":"vindicated"}],[{"wd":"waived"},{"wd":"waved
+        (aside or off)"}]],"phrase_list":[[{"wd":"closed one\u0027s eyes to"},{"wd":"forgave
+        and forgot"}]],"near_list":[[{"wd":"heeded"},{"wd":"marked"},{"wd":"minded"},{"wd":"noted"},{"wd":"objected
+        (to)"}]]}]]]}],"shortdef":["to cease to have feelings of anger or bitterness
+        toward","to dismiss as of little importance"]},{"meta":{"id":"pardon","uuid":"a55237df-c637-48d1-b7ab-81eddc3dcb55","src":"coll_thes","section":"alpha","target":{"tuuid":"7e15693b-2866-457f-a3bb-d200dd996e5c","tsrc":"collegiate"},"stems":["pardon","pardoned","pardoning","pardons"],"syns":[["forgive"],["blink
+        (at)","brush (aside or off)","condone","discount","disregard","excuse","forgive","gloss
+        (over)","gloze (over)","ignore","overlook","overpass","paper over","pass over","remit","shrug
+        off","whitewash","wink (at)"]],"ants":[["resent"]],"offensive":false},"hwi":{"hw":"pardon"},"fl":"verb","def":[{"sseq":[[["sense",{"sn":"1","dt":[["text","to
+        cease to have feelings of anger or bitterness toward "],["vis",[{"t":"he eventually
+        {it}pardoned{\/it} his sister after she apologized"}]]],"syn_list":[[{"wd":"forgive"}]],"rel_list":[[{"wd":"absolve"},{"wd":"acquit"},{"wd":"clear"},{"wd":"exculpate"},{"wd":"exonerate"},{"wd":"vindicate"}],[{"wd":"remit"},{"wd":"shrive"}],[{"wd":"condone"},{"wd":"disregard"},{"wd":"excuse"},{"wd":"ignore"},{"wd":"pass
+        over"},{"wd":"shrug off"}],[{"wd":"discharge"},{"wd":"liberate"},{"wd":"redeem"},{"wd":"release"},{"wd":"unburden"}]],"near_list":[[{"wd":"abhor"},{"wd":"abominate"},{"wd":"despise"},{"wd":"detest"},{"wd":"dislike"},{"wd":"execrate"},{"wd":"hate"},{"wd":"loathe"}],[{"wd":"avenge"},{"wd":"redress"},{"wd":"requite"},{"wd":"retaliate"},{"wd":"revenge"}],[{"wd":"discipline"},{"wd":"penalize"},{"wd":"punish"}]],"ant_list":[[{"wd":"resent"}]]}]],[["sense",{"sn":"2","dt":[["text","to
+        dismiss as of little importance "],["vis",[{"t":"I\u0027m willing to {it}pardon{\/it}
+        a little sloppiness of dress in such a kind and loving person"}]]],"syn_list":[[{"wd":"blink
+        (at)"},{"wd":"brush (aside or off)"},{"wd":"condone"},{"wd":"discount"},{"wd":"disregard"},{"wd":"excuse"},{"wd":"forgive"},{"wd":"gloss
+        (over)"},{"wd":"gloze (over)"},{"wd":"ignore"},{"wd":"overlook"},{"wd":"overpass"},{"wd":"paper
+        over"},{"wd":"pass over"},{"wd":"remit"},{"wd":"shrug off"},{"wd":"whitewash"},{"wd":"wink
+        (at)"}]],"rel_list":[[{"wd":"explain"},{"wd":"justify"},{"wd":"rationalize"}],[{"wd":"absolve"},{"wd":"acquit"},{"wd":"clear"},{"wd":"exculpate"},{"wd":"exonerate"},{"wd":"vindicate"}],[{"wd":"waive"},{"wd":"wave
+        (aside or off)"}]],"phrase_list":[[{"wd":"close one\u0027s eyes to"},{"wd":"forgive
+        and forget"}]],"near_list":[[{"wd":"heed"},{"wd":"mark"},{"wd":"mind"},{"wd":"note"},{"wd":"object
+        (to)"}]]}]]]}],"shortdef":["to cease to have feelings of anger or bitterness
+        toward","to dismiss as of little importance"]}]'
+  recorded_at: Tue, 21 Jun 2022 23:24:58 GMT
+- request:
+    method: get
+    uri: https://www.dictionaryapi.com/api/v3/references/collegiate/json/pardoned?key=<COLLEGIATE_DICTIONARY_API_KEY>
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Tue, 21 Jun 2022 23:24:58 GMT
+      Content-Type:
+      - application/json; charset=utf-8
+      Content-Length:
+      - '1085'
+      Connection:
+      - keep-alive
+      Server:
+      - Apache
+      Cache-Control:
+      - max-age=86400, public
+      Pragma:
+      - cache
+      Vary:
+      - Accept-Encoding
+      Access-Control-Allow-Origin:
+      - "*"
+    body:
+      encoding: ASCII-8BIT
+      string: '[{"meta":{"id":"pardon:2","uuid":"7e15693b-2866-457f-a3bb-d200dd996e5c","sort":"160068700","src":"collegiate","section":"alpha","stems":["pardon","pardoned","pardoning","pardons"],"offensive":false},"hom":2,"hwi":{"hw":"pardon"},"fl":"verb","ins":[{"if":"par*doned"},{"if":"par*don*ing","prs":[{"mw":"\u02c8p\u00e4rd-ni\u014b","sound":{"audio":"pardon02","ref":"c","stat":"1"}},{"mw":"\u02c8p\u00e4r-d\u1d4an-i\u014b"}]}],"def":[{"vd":"transitive
+        verb","sseq":[[["sense",{"sn":"1 a","dt":[["text","{bc}to absolve from the
+        consequences of a fault or crime"]]}],["sense",{"sn":"b","dt":[["text","{bc}to
+        allow (an offense) to pass without punishment {bc}{sx|forgive||}"]]}],["sense",{"sn":"c","dt":[["text","{bc}to
+        relieve of a penalty improperly assessed"]]}]],[["sense",{"sn":"2","dt":[["text","{bc}{sx|tolerate||}"]]}]]]}],"syns":[{"pl":"synonyms","pt":[["text","{sc}excuse{\/sc}
+        {sc}condone{\/sc} {sc}pardon{\/sc} {sc}forgive{\/sc} mean to exact neither
+        punishment nor redress. {sc}excuse{\/sc} may refer to specific acts especially
+        in social or conventional situations or the person responsible for these.
+        "],["vis",[{"t":"{it}excuse{\/it} an interruption"},{"t":"{it}excused{\/it}
+        them for interrupting"}]],["text"," Often the term implies extenuating circumstances.
+        "],["vis",[{"t":"injustice {it}excuses{\/it} strong responses"}]],["text","
+        {sc}condone{\/sc} implies that one overlooks without censure behavior (such
+        as dishonesty or violence) that involves a serious breach of a moral, ethical,
+        or legal code, and the term may refer to the behavior or to the agent responsible
+        for it. "],["vis",[{"t":"a society that {it}condones{\/it} alcohol but not
+        narcotics"}]],["text"," {sc}pardon{\/sc} implies that one remits a penalty
+        due for an admitted or established offense. "],["vis",[{"t":"{it}pardon{\/it}
+        a criminal"}]],["text"," {sc}forgive{\/sc} implies that one gives up all claim
+        to requital and to resentment or vengeful feelings. "],["vis",[{"t":"could
+        not {it}forgive{\/it} their rudeness"}]]]}],"et":[["text","Middle English,
+        from Anglo-French {it}parduner{\/it}, from Late Latin {it}perdonare{\/it}
+        to grant freely, from Latin {it}per-{\/it} thoroughly + {it}donare{\/it} to
+        give {ma}{mat|parboil|}, {mat|donation|}{\/ma}"]],"date":"15th century{ds||1|a|}","shortdef":["to
+        absolve from the consequences of a fault or crime","to allow (an offense)
+        to pass without punishment : forgive","to relieve of a penalty improperly
+        assessed"]}]'
+  recorded_at: Tue, 21 Jun 2022 23:24:58 GMT
+recorded_with: VCR 6.1.0

data/fixtures/vcr_cassettes/word_not_in_thesaurus_primary_entry.yml

@@ -0,0 +1,144 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://www.dictionaryapi.com/api/v3/references/thesaurus/json/salmon?key=<COLLEGIATE_THESAURUS_API_KEY>
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Tue, 21 Jun 2022 23:24:57 GMT
+      Content-Type:
+      - application/json; charset=utf-8
+      Content-Length:
+      - '113'
+      Connection:
+      - keep-alive
+      Server:
+      - Apache
+      Cache-Control:
+      - max-age=86400, public
+      Pragma:
+      - cache
+      Vary:
+      - Accept-Encoding
+      Access-Control-Allow-Origin:
+      - "*"
+    body:
+      encoding: ASCII-8BIT
+      string: '["salon","saloon","saloons","daemon","daimon","gammon","sallow","salons","salvo","salvor","salvos","sermon","summon","psalmody","salesman","salesmen","almoner","calming","salamis","salient"]'
+  recorded_at: Tue, 21 Jun 2022 23:24:57 GMT
+- request:
+    method: get
+    uri: https://www.dictionaryapi.com/api/v3/references/collegiate/json/salmon?key=<COLLEGIATE_DICTIONARY_API_KEY>
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Tue, 21 Jun 2022 23:24:57 GMT
+      Content-Type:
+      - application/json; charset=utf-8
+      Content-Length:
+      - '1941'
+      Connection:
+      - keep-alive
+      Server:
+      - Apache
+      Cache-Control:
+      - max-age=86400, public
+      Pragma:
+      - cache
+      Vary:
+      - Accept-Encoding
+      Access-Control-Allow-Origin:
+      - "*"
+    body:
+      encoding: ASCII-8BIT
+      string: '[{"meta":{"id":"salmon","uuid":"cb7ebb03-74af-4bd2-8191-5d88cee9dcbf","sort":"190315000","src":"collegiate","section":"alpha","stems":["Atlantic
+        salmon","salmon","salmons"],"offensive":false},"hwi":{"hw":"salm*on","prs":[{"mw":"\u02c8sa-m\u0259n","sound":{"audio":"salmon01","ref":"c","stat":"1"}}]},"fl":"noun","ins":[{"il":"plural","if":"salmon"},{"il":"also","if":"salm*ons"}],"def":[{"sseq":[[["sense",{"sn":"1
+        a","dt":[["text","{bc}a large anadromous {a_link|salmonid} fish ({it}Salmo
+        salar{\/it}) of the North Atlantic noted as a game and food fish "],["ca",{"intro":"called
+        also","cats":[{"cat":"Atlantic salmon"}]}]]}],["sense",{"sn":"b","dt":[["text","{bc}any
+        of various anadromous salmonid fishes other than the salmon"]],"sdsense":{"sd":"especially","dt":[["text","{bc}{sx|pacific
+        salmon||}"]]}}],["sense",{"sn":"c","dt":[["text","{bc}a fish (such as a barramundi)
+        resembling a salmon"]]}]],[["sense",{"sn":"2","dt":[["text","{bc}the variable
+        color of salmon\u0027s flesh averaging a strong yellowish pink"]]}]]]}],"et":[["text","Middle
+        English {it}samon{\/it}, from Anglo-French {it}salmon, samon{\/it}, from Latin
+        {it}salmon-, salmo{\/it}"]],"date":"13th century{ds||1|a|}","shortdef":["a
+        large anadromous salmonid fish (Salmo salar) of the North Atlantic noted as
+        a game and food fish \u2014called also Atlantic salmon","any of various anadromous
+        salmonid fishes other than the salmon; especially : pacific salmon","a fish
+        (such as a barramundi) resembling a salmon"]},{"meta":{"id":"Salmon:g","uuid":"a5f856eb-b391-47c0-a661-6436e1d1581a","sort":"282519000","src":"collegiate","section":"geog","stems":["Salmon"],"offensive":false},"hwi":{"hw":"Salm*on","prs":[{"mw":"\u02c8sa-m\u0259n","sound":{"audio":"ggsalm01","ref":"c","stat":"1"}}]},"fl":"geographical
+        name","def":[{"sseq":[[["sense",{"dt":[["text","river 420 miles (676 kilometers)
+        long in central Idaho flowing into the Snake River"]]}]]]}],"shortdef":["river
+        420 miles (676 kilometers) long in central Idaho flowing into the Snake River"]},{"meta":{"id":"salmon
+        pink","uuid":"0cd33845-1c8d-446b-8908-a83389918e7e","sort":"190321000","src":"collegiate","section":"alpha","stems":["salmon
+        pink","salmon pinks"],"offensive":false},"hwi":{"hw":"salmon pink"},"fl":"noun","def":[{"sseq":[[["sense",{"dt":[["text","{bc}a
+        strong yellowish pink"]]}]]]}],"date":"1882","shortdef":["a strong yellowish
+        pink"]},{"meta":{"id":"Salmon River Mountains:g","uuid":"2f208a45-3e68-48b1-b0b7-53cc0b7b483a","sort":"282520000","src":"collegiate","section":"geog","stems":["Salmon
+        River Mountains"],"offensive":false},"hwi":{"hw":"Salmon River Mountains"},"fl":"geographical
+        name","def":[{"sseq":[[["sense",{"dt":[["text","mountains in central Idaho
+        with many peaks over 9000 feet (2743 meters) high"]]}]]]}],"shortdef":["mountains
+        in central Idaho with many peaks over 9000 feet (2743 meters) high"]},{"meta":{"id":"Atlantic
+        salmon","uuid":"12ee4593-c04b-4ecc-9a25-806df767ad7e","sort":"014523000","src":"collegiate","section":"alpha","stems":["Atlantic
+        salmon","Atlantic salmons"],"offensive":false},"hwi":{"hw":"Atlantic salmon"},"fl":"noun","def":[{"sseq":[[["sense",{"dt":[["text","{bc}{sx|salmon||1a}"]]}]]]}],"date":"1813","shortdef":["salmon"]},{"meta":{"id":"black
+        salmon","uuid":"0a75d3f5-b816-430a-ab01-da53aa2fb41a","sort":"020261750","src":"collegiate","section":"alpha","stems":["black
+        salmon","black salmons"],"offensive":false},"hwi":{"hw":"black salmon"},"fl":"noun","def":[{"sseq":[[["sense",{"dt":[["text","{bc}{sx|chinook
+        salmon||}"]]}]]]}],"date":"1873","shortdef":["chinook salmon"]},{"meta":{"id":"Chinook
+        salmon","uuid":"1fa80af4-81c1-4a08-9f0b-578454e0eabe","sort":"032660000","src":"collegiate","section":"alpha","stems":["Chinook","Chinook
+        salmon","Chinooks","chinook","chinook jargon","chinook salmon","chinook salmons","chinookan","chinooks","king
+        salmon"],"offensive":false},"hwi":{"hw":"Chinook salmon"},"vrs":[{"vl":"or
+        less commonly","va":"chinook salmon"},{"vl":"or","va":"Chinook"},{"vl":"or","va":"chinook"}],"fl":"noun","def":[{"sseq":[[["sense",{"dt":[["text","{bc}a
+        large, usually red-fleshed, commercially important salmon ({it}Oncorhynchus
+        tshawytscha{\/it}) of the northern Pacific Ocean that is typically bluish-green
+        above with silvery sides, has a dark mouth with black gums, and attains an
+        average weight of about 30 to 40 pounds (13.5 to 18 kilograms) but may sometimes
+        exceed 120 pounds (54 kilograms) "],["ca",{"intro":"called also","cats":[{"cat":"black
+        salmon"},{"cat":"king salmon"}]}]]}]]]}],"art":{"artid":"chin_sa","capt":"Chinook
+        salmon"},"date":"1851","shortdef":["a large, usually red-fleshed, commercially
+        important salmon (Oncorhynchus tshawytscha) of the northern Pacific Ocean
+        that is typically bluish-green above with silvery sides, has a dark mouth
+        with black gums, and attains an average weight of about 30 to 40 pounds (13.5
+        to 18 kilograms) but may sometimes exceed 120 pounds (54 kilograms) \u2014called
+        also black salmon, king salmon"]},{"meta":{"id":"chum salmon","uuid":"a0d372d5-dd32-419f-b79f-5160e5f296c0","sort":"033065000","src":"collegiate","section":"alpha","stems":["chum","chum
+        salmon","chum salmons","chums","chumship","chumships"],"offensive":false},"hwi":{"hw":"chum
+        salmon"},"vrs":[{"vl":"or less commonly","va":"chum"}],"fl":"noun","def":[{"sseq":[[["sense",{"dt":[["text","{bc}a
+        metallic bluish green salmon ({it}Oncorhynchus keta{\/it}) of the northern
+        Pacific Ocean and Arctic Ocean that may reach a length of about 3.5 feet (1
+        meter) but is typically smaller "],["snote",[["t","Upon entering fresh water
+        to spawn, the male chum salmon develops large, sharp teeth and becomes dark
+        green to brown with reddish-purple vertical stripes."]]]]}]]]}],"et":[["text","{et_link|chum:5|chum:5}"]],"date":"1907","shortdef":["a
+        metallic bluish green salmon (Oncorhynchus keta) of the northern Pacific Ocean
+        and Arctic Ocean that may reach a length of about 3.5 feet (1 meter) but is
+        typically smaller"]},{"meta":{"id":"jack salmon","uuid":"d3d51ea4-f587-418d-a756-feb55f6795dc","sort":"100005100","src":"collegiate","section":"alpha","stems":["jack
+        salmon","jack salmons"],"offensive":false},"hwi":{"hw":"jack salmon"},"fl":"noun","def":[{"sseq":[[["sense",{"sn":"1","dt":[["text","{bc}{sx|walleye||3}"]]}]],[["sense",{"sn":"2
+        a","dt":[["text","{bc}{sx|grilse||}"]]}],["sense",{"sn":"b","dt":[["text","{bc}{sx|coho||}"]]}]]]}],"date":"1850{ds||1||}","shortdef":["walleye","grilse","coho"]},{"meta":{"id":"king
+        salmon","uuid":"9c8b42d9-a92d-4900-ae11-25f5bd6898cd","sort":"110049200","src":"collegiate","section":"alpha","stems":["king
+        salmon","king salmons"],"offensive":false},"hwi":{"hw":"king salmon"},"fl":"noun","def":[{"sseq":[[["sense",{"dt":[["text","{bc}{sx|chinook
+        salmon||}"]]}]]]}],"date":"1871","shortdef":["chinook salmon"]}]'
+  recorded_at: Tue, 21 Jun 2022 23:24:57 GMT
+recorded_with: VCR 6.1.0

data/lib/merriam_webster_plus/client.rb

@@ -0,0 +1,88 @@
+require "json"
+require "httparty"
+
+module MerriamWebsterPlus
+  class Client
+    MerriamWebsterAPIError = Class.new(StandardError)
+    BadRequestError = Class.new(MerriamWebsterAPIError)
+    UnauthorizedError = Class.new(MerriamWebsterAPIError)
+    ForbiddenError = Class.new(MerriamWebsterAPIError)
+    NotFoundError  = Class.new(MerriamWebsterAPIError)
+    UnprocessableEntityError = Class.new(MerriamWebsterAPIError)
+    ApiError = Class.new(MerriamWebsterAPIError)
+
+    HTTP_OK_CODE = 200
+
+    HTTP_BAD_REQUEST_CODE  = 400
+    HTTP_UNAUTHORIZED_CODE = 401
+    HTTP_FORBIDDEN_CODE      = 403
+    HTTP_NOT_FOUND_CODE      = 404
+    HTTP_UNPROCESSABLE_ENTITY_CODE = 429
+
+    COLLEGIATE_DICTIONARY_ENDPOINT = "https://www.dictionaryapi.com/api/v3/references/collegiate/json/"
+    COLLEGIATE_THESAURUS_ENDPOINT  = "https://www.dictionaryapi.com/api/v3/references/thesaurus/json/"
+
+    attr_reader :word, :title
+
+    def initialize(word:, title:)
+      @word  = railsy_parameterize(word)
+      @title = title
+    end
+
+    def api_entries
+      parsed_response
+    end
+
+    private
+
+    def response
+      @response ||= HTTParty.get("#{endpoint}#{word}?key=#{api_key}")
+    end
+
+    def parsed_response
+      return JSON.parse(response.body, symbolize_names: true) if response_successful?
+
+      raise error_class, "code: #{response.code}, message: #{response.message}, response: #{response.body}"
+    end
+
+    def error_class
+      case response.code
+      when HTTP_BAD_REQUEST_CODE
+        BadRequestError
+      when HTTP_UNAUTHORIZED_CODE
+        UnauthorizedError
+      when HTTP_FORBIDDEN_CODE
+        ForbiddenError
+      when HTTP_NOT_FOUND_CODE
+        NotFoundError
+      when HTTP_UNPROCESSABLE_ENTITY_CODE
+        UnprocessableEntityError
+      else
+        ApiError
+      end
+    end
+
+    def response_successful?
+      (response.code == HTTP_OK_CODE) && valid_json?(response.body)
+    end
+
+    def valid_json?(json)
+      JSON.parse(json)
+      true
+    rescue JSON::ParserError => e
+      false
+    end
+
+    def endpoint
+      MerriamWebsterPlus::Client.const_get("#{title.upcase}_ENDPOINT")
+    end
+
+    def api_key
+      ENV["#{title.upcase}_API_KEY"]
+    end
+
+    def railsy_parameterize(string)
+      string.gsub(/[^a-z0-9\-_]+/i, "_").downcase
+    end
+  end
+end

data/lib/merriam_webster_plus/dictionary_entries.rb

@@ -0,0 +1,41 @@
+require "merriam_webster_plus/client"
+require "merriam_webster_plus/dictionary_entry"
+
+module MerriamWebsterPlus
+  class DictionaryEntries
+    attr_reader :word, :api_entries, :entry_parser
+
+    def initialize(word:)
+      @word	= word
+      title_post_initialize
+    end
+
+    def main_entries
+      main_entries = []
+      api_entries.each do |api_entry|
+        main_entry = main_entry(api_entry)
+        (main_entries << main_entry) if word_equals_entry_headword?(main_entry)
+      end
+      main_entries
+    end
+
+    private
+
+    def title_post_initialize
+      @api_entries	= MerriamWebsterPlus::Client.new(word: word, title: :collegiate_dictionary).api_entries
+      @entry_parser	= DictionaryEntry
+    end
+
+    def main_entry(api_entry)
+      entry_parser.new(api_entry: api_entry).main_entry if api_entry_valid?(api_entry)
+    end
+
+    def api_entry_valid?(api_entry)
+      (api_entry.is_a? Hash)
+    end
+
+    def word_equals_entry_headword?(entry)
+      entry && (word.downcase == entry[:word].downcase)
+    end
+  end
+end

data/lib/merriam_webster_plus/dictionary_entry.rb

@@ -0,0 +1,124 @@
+require "merriam_webster_plus/dictionary_sense"
+
+module MerriamWebsterPlus
+  class DictionaryEntry
+    AUDIO_MP3_ENDPOINT = "https://media.merriam-webster.com/audio/prons/en/us/mp3/"
+
+    attr_reader :api_entry, :sense_parser
+
+    def initialize(api_entry:)
+      @api_entry = api_entry
+      title_post_initialize
+    end
+
+    def main_entry
+      {
+        word: headword,
+        class: word_class,
+        audio: audio,
+        senses: senses,
+        uuid: uuid,
+        target_uuid: target_uuid
+      }
+    end
+
+    private
+
+    def title_post_initialize
+      @sense_parser = DictionarySense
+    end
+
+    def headword
+      remove_non_letters(headword_information&.dig(:hw))
+    end
+
+    def word_class
+      functional_label
+    end
+
+    def audio
+      ("#{AUDIO_MP3_ENDPOINT}#{audio_subdirectory}/#{audio_filename}.mp3" if audio_filename)
+    end
+
+    def uuid
+      entry_metadata[:uuid]
+    end
+
+    def target_uuid
+      entry_metadata&.dig(:target, :tuuid)
+    end
+
+    def entry_metadata
+      api_entry[:meta]
+    end
+
+    def headword_information
+      api_entry[:hwi]
+    end
+
+    def functional_label
+      api_entry[:fl]
+    end
+
+    def definition_section
+      api_entry[:def]
+    end
+
+    def short_definition
+      api_entry[:shortdef]
+    end
+
+    def senses
+      return unless definition_section
+
+      senses = []
+      sense_sequence.each_with_index do |sense_group, index|
+        senses << primary_sense(sense_group, index)
+      end
+      senses.first(3)
+    end
+
+    def primary_sense(sense_group, index)
+      ["#{index + 1}".to_i,
+       sense_parser.new(definition: definition(index), sense_group: sense_group).primary_sense]
+    end
+
+    def definition(index_num)
+      short_definition&.dig(index_num)&.chomp(": such as")&.chomp(":")
+    end
+
+    def sense_sequence
+      return parenthesized_sense_sequence if parenthesized_sense_sequence?
+
+      definition_section&.dig(0, :sseq)
+    end
+
+    def parenthesized_sense_sequence
+      definition_section&.dig(0, :sseq, 0, 0, 1)
+    end
+
+    def parenthesized_sense_sequence?
+      definition_section&.dig(0, :sseq, 0, 0, 0) == "pseq"
+    end
+
+    def audio_filename
+      headword_information&.dig(:prs, 0, :sound, :audio)
+    end
+
+    def audio_subdirectory
+      if audio_filename.start_with?("bix")
+        "bix"
+      elsif audio_filename.start_with?("gg")
+        "gg"
+      elsif audio_filename.chr.match?((/[^a-z ]/i))
+        "number"
+      else
+        audio_filename.chr
+      end
+    end
+
+    def remove_non_letters(string)
+      string&.gsub(/[^a-z ]/i, "")
+    end
+  end
+end

data/lib/merriam_webster_plus/dictionary_plus.rb

@@ -0,0 +1,46 @@
+require "merriam_webster_plus/dictionary_entries"
+require "merriam_webster_plus/thesaurus_entries"
+require "merriam_webster_plus/entry_audio_merger"
+require "merriam_webster_plus/primary_entry_finder"
+
+module MerriamWebsterPlus
+  class DictionaryPlus
+    attr_reader :word, :thesaurus_entries, :dictionary_entries, :entry_audio_merger, :primary_entry_finder
+
+    def initialize(word:)
+      @word	= word
+      @thesaurus_entries 		= MerriamWebsterPlus::ThesaurusEntries.new(word: word).main_entries
+      @dictionary_entries 	= MerriamWebsterPlus::DictionaryEntries.new(word: word).main_entries
+      @entry_audio_merger		= MerriamWebsterPlus::EntryAudioMerger
+      @primary_entry_finder 	= PrimaryEntryFinder
+    end
+
+    def primary_entry
+      primary_entry_with_audio if entries.any?
+    end
+
+    def entries
+      thesaurus_entries.any? ? thesaurus_entries_with_audio : dictionary_entries_with_audio
+    end
+
+    private
+
+    def thesaurus_entries_with_audio
+      entry_audio_merger.new(dst_entries: thesaurus_entries, src_entries: dictionary_entries).merged_entries
+    end
+
+    def dictionary_entries_with_audio
+      entry_audio_merger.new(dst_entries: dictionary_entries, src_entries: dictionary_entries).merged_entries
+    end
+
+    def primary_entry_with_audio
+      primary_entry_finder.new(primary_src_entries: thesaurus_entries_with_audio,
+                               secondary_src_entries: dictionary_entries_with_audio,
+                               tertiary_src_entries: entries).primary_entry
+    end
+
+    def railsy_blank(object)
+      object.nil? || object.empty?
+    end
+  end
+end

data/lib/merriam_webster_plus/dictionary_sense.rb

@@ -0,0 +1,57 @@
+module MerriamWebsterPlus
+  class DictionarySense
+    attr_reader :definition, :sense_group
+
+    def initialize(definition:, sense_group:)
+      @definition = definition
+      @sense_group = sense_group
+    end
+
+    def primary_sense
+      {
+        definition: definition,
+        example: example_sentence
+      }.compact
+    end
+
+    private
+
+    def sense
+      sense_group&.select { |sense| sense[0] == "sense" }&.first&.dig(1)
+    end
+
+    def example_sentence
+      verbal_illustration unless lacking_letters?(verbal_illustration)
+    end
+
+    def defining_text_section
+      sense&.dig(:dt)
+    end
+
+    def defining_text_section_usage_notes
+      defining_text_section&.select { |section| section[0] == "uns" }&.dig(0, 1, 0)
+    end
+
+    def defining_text_section_supplemental_information_notes
+      defining_text_section&.select { |section| section[0] == "snote" }&.dig(0, 1)
+    end
+
+    def verbal_illustration_section
+      select_verbal_illustration_section(defining_text_section) ||
+        select_verbal_illustration_section(defining_text_section_usage_notes) ||
+        select_verbal_illustration_section(defining_text_section_supplemental_information_notes)
+    end
+
+    def select_verbal_illustration_section(containing_section)
+      containing_section&.select { |section| section[0] == "vis" }&.last
+    end
+
+    def verbal_illustration
+      verbal_illustration_section&.dig(1, 0, :t)&.gsub(/\{.*?\}/, "")&.strip
+    end
+
+    def lacking_letters?(string)
+      string.nil? || string.to_s[/\p{L}/].nil?
+    end
+  end
+end