forked from wordnik/wordnik-python
-
Notifications
You must be signed in to change notification settings - Fork 0
hobbeswalsh/wordnik-python
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
<!doctype html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <html><head><title>Python: class Wordnik</title> </head><body bgcolor="#f0f0f8"> <p> <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> <tr bgcolor="#ffc8d8"> <td colspan=3 valign=bottom> <br> <font color="#000000" face="helvetica, arial"><strong>wordnik.Wordnik</strong> = <a name="wordnik.Wordnik">class Wordnik</a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr> <tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td> <td colspan=2><tt>A generic Wordnik object. Use me to interact with the Wordnik API.<br> <br> All of my methods can be called in multiple ways. All positional<br> arguments passed into one of my methods (with the exception of "format")<br> will be substituted for the correponding path parameter, if possible.<br> For example, consider the "get_word_examples" method. The URI path is:<br> <br> /word.{format}/{word}/examples<br> <br> So we can skip format (default format is JSON) and infer that the first<br> positional argument is the word we want examples for. Hence:<br> <br> Wordnik.<a href="#wordnik.Wordnik-get_word_examples">get_word_examples</a>('cat')<br> <br> All other (non-path) arguments are keyword arguments. The "format"<br> paramater can be passed in this way as well. Hence:<br> <br> Wordnik.<a href="#wordnik.Wordnik-get_word_examples">get_word_examples</a>('cat', format='xml', limit=500)<br> <br> In the case where you're making a POST, you will need a "body" keyword:<br> <br> Wordnik.<a href="#wordnik.Wordnik-put_word_list">put_word_list</a>(wordListId=1234, body="Some HTTP body")<br> </tt></td></tr> <tr><td> </td> <td width="100%">Methods defined here:<br> <dl><dt><a name="Wordnik-__init__"><strong>__init__</strong></a>(self, api_key<font color="#909090">=None</font>)</dt><dd><tt>Initialize a Wordnik object. You must pass in an API key when<br> you make a new Wordnik. We don't validate the API key until the<br> first call against the API is made, at which point you'll find<br> out if it's good.</tt></dd></dl> <dl><dt><a name="Wordnik-delete_user_word_of_the_day_list"><strong>delete_user_word_of_the_day_list</strong></a>(self, *args, **kwargs)</dt><dd><tt>Deletes a specific word from a user's WordOfTheDayList<br> /user.{format}/{username}/wordOfTheDayList/{permalink}/{wordToDelete}<br> <br> Path Parameters:<br> username<br> permalink<br> wordToDelete</tt></dd></dl> <dl><dt><a name="Wordnik-delete_word_list"><strong>delete_word_list</strong></a>(self, *args, **kwargs)</dt><dd><tt>Deletes an existing WordList<br> /wordList.{format}/{wordListId}<br> <br> Path Parameters:<br> wordListId</tt></dd></dl> <dl><dt><a name="Wordnik-get_account_api_token_status"><strong>get_account_api_token_status</strong></a>(self, *args, **kwargs)</dt><dd><tt>Returns usage statistics for the API account.<br> /account.{format}/apiTokenStatus<br> <br> Other Parameters:<br> api_key</tt></dd></dl> <dl><dt><a name="Wordnik-get_account_authenticate"><strong>get_account_authenticate</strong></a>(self, *args, **kwargs)</dt><dd><tt>Authenticates a User<br> /account.{format}/authenticate/{username}<br> <br> Path Parameters:<br> username<br> <br> Other Parameters:<br> password</tt></dd></dl> <dl><dt><a name="Wordnik-get_account_regenerate_api_token"><strong>get_account_regenerate_api_token</strong></a>(self, *args, **kwargs)</dt><dd><tt>Regenerates an API Token. Currently not supported or tested.<br> /account.{format}/regenerateApiToken<br> <br> Other Parameters:<br> api_key</tt></dd></dl> <dl><dt><a name="Wordnik-get_account_user"><strong>get_account_user</strong></a>(self, *args, **kwargs)</dt><dd><tt>Returns the logged-in User<br> /account.{format}/user<br> <br> Other Parameters:<br> auth_token</tt></dd></dl> <dl><dt><a name="Wordnik-get_account_username_available"><strong>get_account_username_available</strong></a>(self, *args, **kwargs)</dt><dd><tt>Returns an ApiResponse indicating whether or not a username is available<br> /account.{format}/usernameAvailable/{username}<br> <br> Path Parameters:<br> username</tt></dd></dl> <dl><dt><a name="Wordnik-get_user_word_of_the_day"><strong>get_user_word_of_the_day</strong></a>(self, *args, **kwargs)</dt><dd><tt>Returns the WordOfTheDay for a given user on a given date<br> /user.{format}/{username}/wordOfTheDay/{date}<br> <br> Path Parameters:<br> username<br> date<br> <br> Other Parameters:<br> includeAll</tt></dd></dl> <dl><dt><a name="Wordnik-get_user_word_of_the_day_list"><strong>get_user_word_of_the_day_list</strong></a>(self, *args, **kwargs)</dt><dd><tt>Returns a user's WordOfTheDayList<br> /user.{format}/{username}/wordOfTheDayList<br> <br> Path Parameters:<br> username<br> <br> Other Parameters:<br> includeAll</tt></dd></dl> <dl><dt><a name="Wordnik-get_word"><strong>get_word</strong></a>(self, *args, **kwargs)</dt><dd><tt>Given a word as a string, returns the WordObject that represents it<br> /word.{format}/{word}<br> <br> Path Parameters:<br> word<br> <br> Other Parameters:<br> useCanonical<br> includeSuggestions</tt></dd></dl> <dl><dt><a name="Wordnik-get_word_audio"><strong>get_word_audio</strong></a>(self, *args, **kwargs)</dt><dd><tt>Fetches audio metadata for a word.<br> /word.{format}/{word}/audio<br> <br> Path Parameters:<br> word<br> <br> Other Parameters:<br> useCanonical<br> limit</tt></dd></dl> <dl><dt><a name="Wordnik-get_word_definitions"><strong>get_word_definitions</strong></a>(self, *args, **kwargs)</dt><dd><tt>Return definitions for a word<br> /word.{format}/{word}/definitions<br> <br> Path Parameters:<br> word<br> <br> Other Parameters:<br> limit<br> partOfSpeech<br> includeRelated<br> sourceDictionaries<br> useCanonical<br> includeTags</tt></dd></dl> <dl><dt><a name="Wordnik-get_word_examples"><strong>get_word_examples</strong></a>(self, *args, **kwargs)</dt><dd><tt>Returns examples for a word<br> /word.{format}/{word}/examples<br> <br> Path Parameters:<br> word<br> <br> Other Parameters:<br> limit<br> includeDuplicates<br> contentProvider<br> useCanonical<br> skip</tt></dd></dl> <dl><dt><a name="Wordnik-get_word_frequency"><strong>get_word_frequency</strong></a>(self, *args, **kwargs)</dt><dd><tt>Returns word usage over time<br> /word.{format}/{word}/frequency<br> <br> Path Parameters:<br> word<br> <br> Other Parameters:<br> useCanonical<br> startYear<br> endYear</tt></dd></dl> <dl><dt><a name="Wordnik-get_word_hyphenation"><strong>get_word_hyphenation</strong></a>(self, *args, **kwargs)</dt><dd><tt>Returns syllable information for a word<br> /word.{format}/{word}/hyphenation<br> <br> Path Parameters:<br> word<br> <br> Other Parameters:<br> useCanonical<br> sourceDictionary<br> limit</tt></dd></dl> <dl><dt><a name="Wordnik-get_word_list"><strong>get_word_list</strong></a>(self, *args, **kwargs)</dt><dd><tt>Fetches a WordList by ID<br> /wordList.{format}/{wordListId}<br> <br> Path Parameters:<br> wordListId</tt></dd></dl> <dl><dt><a name="Wordnik-get_word_list_words"><strong>get_word_list_words</strong></a>(self, *args, **kwargs)</dt><dd><tt>Fetches words in a WordList<br> /wordList.{format}/{wordListId}/words<br> <br> Path Parameters:<br> wordListId<br> <br> Other Parameters:<br> sortBy<br> sortOrder<br> skip<br> limit</tt></dd></dl> <dl><dt><a name="Wordnik-get_word_lists"><strong>get_word_lists</strong></a>(self, *args, **kwargs)</dt><dd><tt>Returns information about API parameters<br> /wordLists</tt></dd></dl> <dl><dt><a name="Wordnik-get_word_phrases"><strong>get_word_phrases</strong></a>(self, *args, **kwargs)</dt><dd><tt>Fetches bi-gram phrases for a word<br> /word.{format}/{word}/phrases<br> <br> Path Parameters:<br> word<br> <br> Other Parameters:<br> limit<br> wlmi<br> useCanonical</tt></dd></dl> <dl><dt><a name="Wordnik-get_word_pronunciations"><strong>get_word_pronunciations</strong></a>(self, *args, **kwargs)</dt><dd><tt>Returns text pronunciations for a given word<br> /word.{format}/{word}/pronunciations<br> <br> Path Parameters:<br> word<br> <br> Other Parameters:<br> useCanonical<br> sourceDictionary<br> typeFormat<br> limit</tt></dd></dl> <dl><dt><a name="Wordnik-get_word_related"><strong>get_word_related</strong></a>(self, *args, **kwargs)</dt><dd><tt>Return related words (thesaurus data) for a word<br> /word.{format}/{word}/related<br> <br> Path Parameters:<br> word<br> <br> Other Parameters:<br> partOfSpeech<br> sourceDictionary<br> limit<br> useCanonical<br> type</tt></dd></dl> <dl><dt><a name="Wordnik-get_word_top_example"><strong>get_word_top_example</strong></a>(self, *args, **kwargs)</dt><dd><tt>Returns a top example for a word<br> /word.{format}/{word}/topExample<br> <br> Path Parameters:<br> word<br> <br> Other Parameters:<br> contentProvider<br> useCanonical</tt></dd></dl> <dl><dt><a name="Wordnik-get_word_word_forms"><strong>get_word_word_forms</strong></a>(self, *args, **kwargs)</dt><dd><tt>Returns other forms of a word<br> /word.{format}/{word}/wordForms<br> <br> Path Parameters:<br> word<br> <br> Other Parameters:<br> useCanonical</tt></dd></dl> <dl><dt><a name="Wordnik-get_words_random_word"><strong>get_words_random_word</strong></a>(self, *args, **kwargs)</dt><dd><tt>Returns a single random WordObject, in the format specified by the URL<br> /words.{format}/randomWord<br> <br> Other Parameters:<br> hasDictionaryDef<br> includePartOfSpeech<br> excludePartOfSpeech<br> minCorpusCount<br> maxCorpusCount<br> minDictionaryCount<br> maxDictionaryCount<br> minLength<br> maxLength</tt></dd></dl> <dl><dt><a name="Wordnik-get_words_random_words"><strong>get_words_random_words</strong></a>(self, *args, **kwargs)</dt><dd><tt>Returns an array of random WordObjects, in the format specified by the URL<br> /words.{format}/randomWords<br> <br> Other Parameters:<br> hasDictionaryDef<br> includePartOfSpeech<br> excludePartOfSpeech<br> minCorpusCount<br> maxCorpusCount<br> minDictionaryCount<br> maxDictionaryCount<br> minLength<br> maxLength<br> sortBy<br> sortOrder<br> skip<br> limit</tt></dd></dl> <dl><dt><a name="Wordnik-get_words_search"><strong>get_words_search</strong></a>(self, *args, **kwargs)</dt><dd><tt>Searches words.<br> /words.{format}/search<br> <br> Other Parameters:<br> query<br> caseSensitive<br> includePartOfSpeech<br> excludePartOfSpeech<br> minCorpusCount<br> maxCorpusCount<br> minDictionaryCount<br> maxDictionaryCount<br> minLength<br> maxLength<br> skip<br> limit</tt></dd></dl> <dl><dt><a name="Wordnik-get_words_word_of_the_day_lists"><strong>get_words_word_of_the_day_lists</strong></a>(self, *args, **kwargs)</dt><dd><tt>Fetches WordOfTheDay objects for a specific date<br> /words.{format}/wordOfTheDayLists/{date}<br> <br> Path Parameters:<br> date<br> <br> Other Parameters:<br> includeAll</tt></dd></dl> <dl><dt><a name="Wordnik-multi"><strong>multi</strong></a>(self, calls, **kwargs)</dt><dd><tt>Multiple calls, batched. This is a "special case" method<br> in that it's not automatically generated from the API documentation.<br> That's because, well, it's undocumented. Here's how you use it:<br> <br> Wordnik.<a href="#wordnik.Wordnik-multi">multi</a>( [call1, call2, call3 ], **kwargs)<br> <br> where each "call" is (word, resource, {param1: value1, ...} )<br> So we could form a batch call like so:<br> <br> calls = [("dog","examples"),("cat","definitions",{"limit":500})]<br> <br> Wordnik.<a href="#wordnik.Wordnik-multi">multi</a>(calls, format="xml")</tt></dd></dl> <dl><dt><a name="Wordnik-post_account_authenticate"><strong>post_account_authenticate</strong></a>(self, *args, **kwargs)</dt><dd><tt>Authenticates a user<br> /account.{format}/authenticate/{username}<br> <br> Path Parameters:<br> username<br> <br> Other Parameters:<br> body</tt></dd></dl> <dl><dt><a name="Wordnik-post_user_word_of_the_day_list"><strong>post_user_word_of_the_day_list</strong></a>(self, *args, **kwargs)</dt><dd><tt>Creates a WordOfTheDayList<br> /user.{format}/{username}/wordOfTheDayList<br> <br> Path Parameters:<br> username<br> <br> Other Parameters:<br> body</tt></dd></dl> <dl><dt><a name="Wordnik-post_word_list_delete_words"><strong>post_word_list_delete_words</strong></a>(self, *args, **kwargs)</dt><dd><tt>Removes words from a WordList<br> /wordList.{format}/{wordListId}/deleteWords<br> <br> Path Parameters:<br> wordListId<br> <br> Other Parameters:<br> body</tt></dd></dl> <dl><dt><a name="Wordnik-post_word_list_words"><strong>post_word_list_words</strong></a>(self, *args, **kwargs)</dt><dd><tt>Adds words to a WordList<br> /wordList.{format}/{wordListId}/words<br> <br> Path Parameters:<br> wordListId<br> <br> Other Parameters:<br> body</tt></dd></dl> <dl><dt><a name="Wordnik-post_word_lists"><strong>post_word_lists</strong></a>(self, *args, **kwargs)</dt><dd><tt>Creates a WordList.<br> /wordLists<br> <br> Other Parameters:<br> body</tt></dd></dl> <dl><dt><a name="Wordnik-post_words_word_of_the_day_list_subscription"><strong>post_words_word_of_the_day_list_subscription</strong></a>(self, *args, **kwargs)</dt><dd><tt>Subscribes a user to a WordOfTheDayList<br> /words.{format}/wordOfTheDayList/{permalink}/subscription<br> <br> Path Parameters:<br> permalink<br> <br> Other Parameters:<br> auth_token<br> medium<br> body</tt></dd></dl> <dl><dt><a name="Wordnik-put_user_word_of_the_day_list"><strong>put_user_word_of_the_day_list</strong></a>(self, *args, **kwargs)</dt><dd><tt>Adds a WordOfTheDay to a user's WordOfTheDayList<br> /user.{format}/{username}/wordOfTheDayList/{permalink}<br> <br> Path Parameters:<br> username<br> permalink<br> <br> Other Parameters:<br> body</tt></dd></dl> <dl><dt><a name="Wordnik-put_user_word_of_the_day_list_add"><strong>put_user_word_of_the_day_list_add</strong></a>(self, *args, **kwargs)</dt><dd><tt>Adds an item to a user's WordOfTheDayList<br> /user.{format}/{username}/wordOfTheDayList/{permalink}/add<br> <br> Path Parameters:<br> username<br> permalink<br> <br> Other Parameters:<br> body</tt></dd></dl> <dl><dt><a name="Wordnik-put_word_list"><strong>put_word_list</strong></a>(self, *args, **kwargs)</dt><dd><tt>Updates an existing WordList<br> /wordList.{format}/{wordListId}<br> <br> Path Parameters:<br> wordListId<br> <br> Other Parameters:<br> body</tt></dd></dl> <hr> Data descriptors defined here:<br> <dl><dt><strong>__dict__</strong></dt> <dd><tt>dictionary for instance variables (if defined)</tt></dd> </dl> <dl><dt><strong>__weakref__</strong></dt> <dd><tt>list of weak references to the object (if defined)</tt></dd> </dl> </td></tr></table> </body></html>
About
Wordnik Python public library
Resources
Stars
Watchers
Forks
Releases
No releases published
Packages 0
No packages published
Languages
- Python 100.0%