wordnik 0.4.7 → 4.06.00

data/lib/wordnik/resource_modules/word_lists.rb

@@ -3,11 +3,14 @@
 
 module WordListsMethods
 
-  # Returns information about API parameters
+  # Fetches WordList objects by name.
+  # The term supplied is effectively given a wildcard before and after so 'cat' becomes '%cat%'
   #
-  def get_help(*args)
+  def find_by_name(searchString, *args)
     http_method = :get
-    path = '/wordLists'
+    path = '/wordLists/find/{searchString}'
+    path.sub!('{searchString}', searchString.to_s)
+
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
     # becomes {:limit => 10, :part_of_speech => 'verb'}
@@ -22,23 +25,44 @@ module WordListsMethods
       last_arg.delete(:request_only)
     end
 
-    if [:post, :put].include?(http_method)
-      params = nil
-      body = last_arg
-    else
-      params = last_arg
-      body = nil
-    end
-
+    params = last_arg
+    body ||= {}
     request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
     request_only ? request : request.response.body
   end
 
   # Creates a WordList.
   #
-  def create_word_list(*args)
+  def create_word_list(body, *args)
     http_method = :post
     path = '/wordLists'
+
+    # Ruby turns all key-value arguments at the end into a single hash
+    # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
+    # becomes {:limit => 10, :part_of_speech => 'verb'}
+    last_arg = args.pop if args.last.is_a?(Hash)
+    last_arg = args.pop if args.last.is_a?(Array)
+    last_arg ||= {}
+
+    # Look for a kwarg called :request_only, whose presence indicates
+    # that we want the request itself back, not the response body
+    if last_arg.is_a?(Hash) && last_arg[:request_only].present?
+      request_only = true
+      last_arg.delete(:request_only)
+    end
+
+    params = last_arg
+    body ||= {}
+    request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
+    request_only ? request : request.response.body
+  end
+
+  # Returns information about API parameters
+  #
+  def get_help(*args)
+    http_method = :get
+    path = '/wordLists'
+
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
     # becomes {:limit => 10, :part_of_speech => 'verb'}
@@ -53,14 +77,61 @@ module WordListsMethods
       last_arg.delete(:request_only)
     end
 
-    if [:post, :put].include?(http_method)
-      params = nil
-      body = last_arg
-    else
-      params = last_arg
-      body = nil
+    params = last_arg
+    body ||= {}
+    request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
+    request_only ? request : request.response.body
+  end
+
+  # Fetches a CommentSummary for WordList objects.
+  # The CommentSummary is sorted by comment count, descending
+  #
+  def find_most_commented_on(*args)
+    http_method = :get
+    path = '/wordLists/mostCommentedOn'
+
+    # Ruby turns all key-value arguments at the end into a single hash
+    # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
+    # becomes {:limit => 10, :part_of_speech => 'verb'}
+    last_arg = args.pop if args.last.is_a?(Hash)
+    last_arg = args.pop if args.last.is_a?(Array)
+    last_arg ||= {}
+
+    # Look for a kwarg called :request_only, whose presence indicates
+    # that we want the request itself back, not the response body
+    if last_arg.is_a?(Hash) && last_arg[:request_only].present?
+      request_only = true
+      last_arg.delete(:request_only)
+    end
+
+    params = last_arg
+    body ||= {}
+    request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
+    request_only ? request : request.response.body
+  end
+
+  # Fetches recently created WordList objects.
+  #
+  def find_recent_lists(*args)
+    http_method = :get
+    path = '/wordLists/recentLists'
+
+    # Ruby turns all key-value arguments at the end into a single hash
+    # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
+    # becomes {:limit => 10, :part_of_speech => 'verb'}
+    last_arg = args.pop if args.last.is_a?(Hash)
+    last_arg = args.pop if args.last.is_a?(Array)
+    last_arg ||= {}
+
+    # Look for a kwarg called :request_only, whose presence indicates
+    # that we want the request itself back, not the response body
+    if last_arg.is_a?(Hash) && last_arg[:request_only].present?
+      request_only = true
+      last_arg.delete(:request_only)
     end
 
+    params = last_arg
+    body ||= {}
     request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
     request_only ? request : request.response.body
   end

data/lib/wordnik/resource_modules/words.rb

@@ -3,11 +3,12 @@
 
 module WordsMethods
 
-  # Returns a single random WordObject, in the format specified by the URL
+  # Searches words.
   #
-  def get_random_word(*args)
+  def search_words(*args)
     http_method = :get
-    path = '/words/randomWord'
+    path = '/words/search'
+
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
     # becomes {:limit => 10, :part_of_speech => 'verb'}
@@ -22,23 +23,19 @@ module WordsMethods
       last_arg.delete(:request_only)
     end
 
-    if [:post, :put].include?(http_method)
-      params = nil
-      body = last_arg
-    else
-      params = last_arg
-      body = nil
-    end
-
+    params = last_arg
+    body ||= {}
     request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
     request_only ? request : request.response.body
   end
 
-  # Returns an array of random WordObjects, in the format specified by the URL
+  # Fetches a WordOfTheDayList by ID
   #
-  def get_random_words(*args)
+  def get_word_of_the_day_list(permalink, *args)
     http_method = :get
-    path = '/words/randomWords'
+    path = '/words/wordOfTheDayList/{permalink}'
+    path.sub!('{permalink}', permalink.to_s)
+
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
     # becomes {:limit => 10, :part_of_speech => 'verb'}
@@ -53,23 +50,18 @@ module WordsMethods
       last_arg.delete(:request_only)
     end
 
-    if [:post, :put].include?(http_method)
-      params = nil
-      body = last_arg
-    else
-      params = last_arg
-      body = nil
-    end
-
+    params = last_arg
+    body ||= {}
     request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
     request_only ? request : request.response.body
   end
 
-  # Searches words.
+  # Returns a specific WordOfTheDay
   #
-  def search_words(*args)
+  def get_word_of_the_day(*args)
     http_method = :get
-    path = '/words/search'
+    path = '/words/wordOfTheDay'
+
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
     # becomes {:limit => 10, :part_of_speech => 'verb'}
@@ -84,23 +76,18 @@ module WordsMethods
       last_arg.delete(:request_only)
     end
 
-    if [:post, :put].include?(http_method)
-      params = nil
-      body = last_arg
-    else
-      params = last_arg
-      body = nil
-    end
-
+    params = last_arg
+    body ||= {}
     request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
     request_only ? request : request.response.body
   end
 
-  # Fetches an array of WordOfTheDayList basd on a criteria
+  # Returns information about API parameters
   #
-  def get_word_of_the_day_lists_containing_word(*args)
+  def get_help(*args)
     http_method = :get
-    path = '/words/wordOfTheDayLists'
+    path = '/words'
+
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
     # becomes {:limit => 10, :part_of_speech => 'verb'}
@@ -115,24 +102,43 @@ module WordsMethods
       last_arg.delete(:request_only)
     end
 
-    if [:post, :put].include?(http_method)
-      params = nil
-      body = last_arg
-    else
-      params = last_arg
-      body = nil
+    params = last_arg
+    body ||= {}
+    request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
+    request_only ? request : request.response.body
+  end
+
+  # Searches definitions.
+  #
+  def search_definitions(*args)
+    http_method = :get
+    path = '/words/searchDefinitions'
+
+    # Ruby turns all key-value arguments at the end into a single hash
+    # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
+    # becomes {:limit => 10, :part_of_speech => 'verb'}
+    last_arg = args.pop if args.last.is_a?(Hash)
+    last_arg = args.pop if args.last.is_a?(Array)
+    last_arg ||= {}
+
+    # Look for a kwarg called :request_only, whose presence indicates
+    # that we want the request itself back, not the response body
+    if last_arg.is_a?(Hash) && last_arg[:request_only].present?
+      request_only = true
+      last_arg.delete(:request_only)
     end
 
+    params = last_arg
+    body ||= {}
     request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
     request_only ? request : request.response.body
   end
 
-  # Fetches WordOfTheDay objects for a specific date
+  # Searches dictionary entries.
   #
-  def get_word_of_the_day_lists_for_date(date, *args)
+  def search_entries(*args)
     http_method = :get
-    path = '/words/wordOfTheDayLists/{date}'
-    path.sub!('{date}', date)
+    path = '/words/searchEntries'
 
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
@@ -148,24 +154,43 @@ module WordsMethods
       last_arg.delete(:request_only)
     end
 
-    if [:post, :put].include?(http_method)
-      params = nil
-      body = last_arg
-    else
-      params = last_arg
-      body = nil
+    params = last_arg
+    body ||= {}
+    request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
+    request_only ? request : request.response.body
+  end
+
+  # Fetches corpus-level word frequency
+  #
+  def get_frequency(*args)
+    http_method = :get
+    path = '/words/frequency'
+
+    # Ruby turns all key-value arguments at the end into a single hash
+    # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
+    # becomes {:limit => 10, :part_of_speech => 'verb'}
+    last_arg = args.pop if args.last.is_a?(Hash)
+    last_arg = args.pop if args.last.is_a?(Array)
+    last_arg ||= {}
+
+    # Look for a kwarg called :request_only, whose presence indicates
+    # that we want the request itself back, not the response body
+    if last_arg.is_a?(Hash) && last_arg[:request_only].present?
+      request_only = true
+      last_arg.delete(:request_only)
     end
 
+    params = last_arg
+    body ||= {}
     request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
     request_only ? request : request.response.body
   end
 
-  # Subscribes a user to a WordOfTheDayList
+  # Fetches surface forms of a word
   #
-  def subscribe_to_list(permalink, *args)
-    http_method = :post
-    path = '/words/wordOfTheDayList/{permalink}/subscription'
-    path.sub!('{permalink}', permalink)
+  def get_surface_forms(*args)
+    http_method = :get
+    path = '/words/surfaceForms'
 
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
@@ -181,23 +206,46 @@ module WordsMethods
       last_arg.delete(:request_only)
     end
 
-    if [:post, :put].include?(http_method)
-      params = nil
-      body = last_arg
-    else
-      params = last_arg
-      body = nil
+    params = last_arg
+    body ||= {}
+    request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
+    request_only ? request : request.response.body
+  end
+
+  # Fetches a word by ID
+  # Deprecated.
+  #
+  def get_word_by_id(id, *args)
+    http_method = :get
+    path = '/words/id/{id}'
+    path.sub!('{id}', id.to_s)
+
+    # Ruby turns all key-value arguments at the end into a single hash
+    # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
+    # becomes {:limit => 10, :part_of_speech => 'verb'}
+    last_arg = args.pop if args.last.is_a?(Hash)
+    last_arg = args.pop if args.last.is_a?(Array)
+    last_arg ||= {}
+
+    # Look for a kwarg called :request_only, whose presence indicates
+    # that we want the request itself back, not the response body
+    if last_arg.is_a?(Hash) && last_arg[:request_only].present?
+      request_only = true
+      last_arg.delete(:request_only)
     end
 
+    params = last_arg
+    body ||= {}
     request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
     request_only ? request : request.response.body
   end
 
-  # Searches definitions.
+  # Returns a WordOfTheDay range
   #
-  def search_definitions(*args)
+  def get_word_of_the_day_range(*args)
     http_method = :get
-    path = '/words/searchDefinitions'
+    path = '/words/wordOfTheDay/range'
+
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
     # becomes {:limit => 10, :part_of_speech => 'verb'}
@@ -212,23 +260,45 @@ module WordsMethods
       last_arg.delete(:request_only)
     end
 
-    if [:post, :put].include?(http_method)
-      params = nil
-      body = last_arg
-    else
-      params = last_arg
-      body = nil
+    params = last_arg
+    body ||= {}
+    request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
+    request_only ? request : request.response.body
+  end
+
+  # Fetches canonical forms of a word
+  #
+  def get_canonical_forms(*args)
+    http_method = :get
+    path = '/words/canonicalForms'
+
+    # Ruby turns all key-value arguments at the end into a single hash
+    # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
+    # becomes {:limit => 10, :part_of_speech => 'verb'}
+    last_arg = args.pop if args.last.is_a?(Hash)
+    last_arg = args.pop if args.last.is_a?(Array)
+    last_arg ||= {}
+
+    # Look for a kwarg called :request_only, whose presence indicates
+    # that we want the request itself back, not the response body
+    if last_arg.is_a?(Hash) && last_arg[:request_only].present?
+      request_only = true
+      last_arg.delete(:request_only)
     end
 
+    params = last_arg
+    body ||= {}
     request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
     request_only ? request : request.response.body
   end
 
-  # Searches dictionary entries.
+  # Searches words.
   #
-  def search_entries(*args)
+  def search_words_new(query, *args)
     http_method = :get
-    path = '/words/searchEntries'
+    path = '/words/search/{query}'
+    path.sub!('{query}', query.to_s)
+
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
     # becomes {:limit => 10, :part_of_speech => 'verb'}
@@ -243,23 +313,44 @@ module WordsMethods
       last_arg.delete(:request_only)
     end
 
-    if [:post, :put].include?(http_method)
-      params = nil
-      body = last_arg
-    else
-      params = last_arg
-      body = nil
+    params = last_arg
+    body ||= {}
+    request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
+    request_only ? request : request.response.body
+  end
+
+  # Returns an array of random WordObjects, in the format specified by the URL
+  #
+  def get_random_words(*args)
+    http_method = :get
+    path = '/words/randomWords'
+
+    # Ruby turns all key-value arguments at the end into a single hash
+    # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
+    # becomes {:limit => 10, :part_of_speech => 'verb'}
+    last_arg = args.pop if args.last.is_a?(Hash)
+    last_arg = args.pop if args.last.is_a?(Array)
+    last_arg ||= {}
+
+    # Look for a kwarg called :request_only, whose presence indicates
+    # that we want the request itself back, not the response body
+    if last_arg.is_a?(Hash) && last_arg[:request_only].present?
+      request_only = true
+      last_arg.delete(:request_only)
     end
 
+    params = last_arg
+    body ||= {}
     request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
     request_only ? request : request.response.body
   end
 
-  # Fetches surface forms of a word
+  # Returns a single random WordObject, in the format specified by the URL
   #
-  def get_surface_forms(*args)
+  def get_random_word(*args)
     http_method = :get
-    path = '/words/surfaceForms'
+    path = '/words/randomWord'
+
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
     # becomes {:limit => 10, :part_of_speech => 'verb'}
@@ -274,23 +365,45 @@ module WordsMethods
       last_arg.delete(:request_only)
     end
 
-    if [:post, :put].include?(http_method)
-      params = nil
-      body = last_arg
-    else
-      params = last_arg
-      body = nil
+    params = last_arg
+    body ||= {}
+    request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
+    request_only ? request : request.response.body
+  end
+
+  # Fetches examples for multiple words.
+  #
+  def get_examples_for_words(body, *args)
+    http_method = :post
+    path = '/words/examples'
+
+    # Ruby turns all key-value arguments at the end into a single hash
+    # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
+    # becomes {:limit => 10, :part_of_speech => 'verb'}
+    last_arg = args.pop if args.last.is_a?(Hash)
+    last_arg = args.pop if args.last.is_a?(Array)
+    last_arg ||= {}
+
+    # Look for a kwarg called :request_only, whose presence indicates
+    # that we want the request itself back, not the response body
+    if last_arg.is_a?(Hash) && last_arg[:request_only].present?
+      request_only = true
+      last_arg.delete(:request_only)
     end
 
+    params = last_arg
+    body ||= {}
     request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
     request_only ? request : request.response.body
   end
 
-  # Returns a specific WordOfTheDay
+  # Fetches words most commented on.
+  # Set the dayInterval to determine the time frame.
   #
-  def get_word_of_the_day(*args)
+  def get_words_most_commented_on(*args)
     http_method = :get
-    path = '/words/wordOfTheDay'
+    path = '/words/mostCommentedOn'
+
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
     # becomes {:limit => 10, :part_of_speech => 'verb'}
@@ -305,23 +418,21 @@ module WordsMethods
       last_arg.delete(:request_only)
     end
 
-    if [:post, :put].include?(http_method)
-      params = nil
-      body = last_arg
-    else
-      params = last_arg
-      body = nil
-    end
-
+    params = last_arg
+    body ||= {}
     request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
     request_only ? request : request.response.body
   end
 
-  # Returns a WordOfTheDay range
+  # Fetches words most commented on.
+  # Set the dayInterval to determine the time frame.
   #
-  def get_word_of_the_day_range(*args)
+  def get_words_most_commented_on(statsType, object, *args)
     http_method = :get
-    path = '/words/wordOfTheDay/range'
+    path = '/words/firstUsed/{statsType}/{object}'
+    path.sub!('{statsType}', statsType.to_s)
+    path.sub!('{object}', object.to_s)
+
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
     # becomes {:limit => 10, :part_of_speech => 'verb'}
@@ -336,24 +447,45 @@ module WordsMethods
       last_arg.delete(:request_only)
     end
 
-    if [:post, :put].include?(http_method)
-      params = nil
-      body = last_arg
-    else
-      params = last_arg
-      body = nil
+    params = last_arg
+    body ||= {}
+    request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
+    request_only ? request : request.response.body
+  end
+
+  # Invites users to a WordOfTheDayList
+  # A user can invite up to 20 people in a single day. The users being invited will be checked to see if they have opted out of email communications
+  #
+  def invite_to_word_of_the_day_list(permalink, body, *args)
+    http_method = :post
+    path = '/words/wordOfTheDayList/{permalink}/invite'
+    path.sub!('{permalink}', permalink.to_s)
+
+    # Ruby turns all key-value arguments at the end into a single hash
+    # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
+    # becomes {:limit => 10, :part_of_speech => 'verb'}
+    last_arg = args.pop if args.last.is_a?(Hash)
+    last_arg = args.pop if args.last.is_a?(Array)
+    last_arg ||= {}
+
+    # Look for a kwarg called :request_only, whose presence indicates
+    # that we want the request itself back, not the response body
+    if last_arg.is_a?(Hash) && last_arg[:request_only].present?
+      request_only = true
+      last_arg.delete(:request_only)
     end
 
+    params = last_arg
+    body ||= {}
     request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
     request_only ? request : request.response.body
   end
 
-  # Fetches a WordOfTheDayList by ID
+  # Fetches recently created WordOfTheDayLists
   #
-  def get_word_of_the_day_list(permalink, *args)
+  def get_recent_word_of_the_day_lists(*args)
     http_method = :get
-    path = '/words/wordOfTheDayList/{permalink}'
-    path.sub!('{permalink}', permalink)
+    path = '/words/wordOfTheDayLists/recent'
 
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
@@ -369,14 +501,8 @@ module WordsMethods
       last_arg.delete(:request_only)
     end
 
-    if [:post, :put].include?(http_method)
-      params = nil
-      body = last_arg
-    else
-      params = last_arg
-      body = nil
-    end
-
+    params = last_arg
+    body ||= {}
     request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
     request_only ? request : request.response.body
   end
@@ -386,9 +512,8 @@ module WordsMethods
   def get_word_of_the_day_list_item(permalink, specifier, *args)
     http_method = :get
     path = '/words/wordOfTheDayList/{permalink}/{specifier}'
-    path.sub!('{permalink}', permalink)
-
-    path.sub!('{specifier}', specifier)
+    path.sub!('{permalink}', permalink.to_s)
+    path.sub!('{specifier}', specifier.to_s)
 
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
@@ -404,23 +529,18 @@ module WordsMethods
       last_arg.delete(:request_only)
     end
 
-    if [:post, :put].include?(http_method)
-      params = nil
-      body = last_arg
-    else
-      params = last_arg
-      body = nil
-    end
-
+    params = last_arg
+    body ||= {}
     request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
     request_only ? request : request.response.body
   end
 
-  # Fetches recently created WordOfTheDayLists
+  # Fetches an array of WordOfTheDayList basd on a criteria
   #
-  def get_recent_word_of_the_day_lists(*args)
+  def get_word_of_the_day_lists_containing_word(*args)
     http_method = :get
-    path = '/words/wordOfTheDayLists/recent'
+    path = '/words/wordOfTheDayLists'
+
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
     # becomes {:limit => 10, :part_of_speech => 'verb'}
@@ -435,14 +555,8 @@ module WordsMethods
       last_arg.delete(:request_only)
     end
 
-    if [:post, :put].include?(http_method)
-      params = nil
-      body = last_arg
-    else
-      params = last_arg
-      body = nil
-    end
-
+    params = last_arg
+    body ||= {}
     request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
     request_only ? request : request.response.body
   end
@@ -453,6 +567,7 @@ module WordsMethods
   def get_word_of_the_day_list_subscription_process_status(*args)
     http_method = :get
     path = '/words/wordOfTheDayLists/subscriptionProcess'
+
     # Ruby turns all key-value arguments at the end into a single hash
     # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
     # becomes {:limit => 10, :part_of_speech => 'verb'}
@@ -467,14 +582,62 @@ module WordsMethods
       last_arg.delete(:request_only)
     end
 
-    if [:post, :put].include?(http_method)
-      params = nil
-      body = last_arg
-    else
-      params = last_arg
-      body = nil
+    params = last_arg
+    body ||= {}
+    request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
+    request_only ? request : request.response.body
+  end
+
+  # Subscribes a user to a WordOfTheDayList
+  #
+  def subscribe_to_list(permalink, body, *args)
+    http_method = :post
+    path = '/words/wordOfTheDayList/{permalink}/subscription'
+    path.sub!('{permalink}', permalink.to_s)
+
+    # Ruby turns all key-value arguments at the end into a single hash
+    # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
+    # becomes {:limit => 10, :part_of_speech => 'verb'}
+    last_arg = args.pop if args.last.is_a?(Hash)
+    last_arg = args.pop if args.last.is_a?(Array)
+    last_arg ||= {}
+
+    # Look for a kwarg called :request_only, whose presence indicates
+    # that we want the request itself back, not the response body
+    if last_arg.is_a?(Hash) && last_arg[:request_only].present?
+      request_only = true
+      last_arg.delete(:request_only)
+    end
+
+    params = last_arg
+    body ||= {}
+    request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
+    request_only ? request : request.response.body
+  end
+
+  # Fetches WordOfTheDay objects for a specific date
+  #
+  def get_word_of_the_day_lists_for_date(date, *args)
+    http_method = :get
+    path = '/words/wordOfTheDayLists/{date}'
+    path.sub!('{date}', date.to_s)
+
+    # Ruby turns all key-value arguments at the end into a single hash
+    # e.g. Wordnik.word.get_examples('dingo', :limit => 10, :part_of_speech => 'verb')
+    # becomes {:limit => 10, :part_of_speech => 'verb'}
+    last_arg = args.pop if args.last.is_a?(Hash)
+    last_arg = args.pop if args.last.is_a?(Array)
+    last_arg ||= {}
+
+    # Look for a kwarg called :request_only, whose presence indicates
+    # that we want the request itself back, not the response body
+    if last_arg.is_a?(Hash) && last_arg[:request_only].present?
+      request_only = true
+      last_arg.delete(:request_only)
     end
 
+    params = last_arg
+    body ||= {}
     request = Wordnik::Request.new(http_method, path, :params => params, :body => body)
     request_only ? request : request.response.body
   end