Oxford Quick Start¶

First of all you need an official Oxford app_id and app_key.

You can get this from Oxford Dictionaries Developer.

>>> from pythonary import Oxford
>>> app = Oxford.Dictionary(app_id="YourAppID",
...                         app_key="YourAppKey")
>>> app.Select(word="example")
>>> app.name()
<<< example

This will return the name from the word. (so the word itself)

Oxford Reference¶

Dictionary ¶

Represents a dictionary from the Oxford Dictionaries,
This class connects to the Oxford Dictionaries API and receives information.
Arguments for Dictionary:

Parameters:

app_id: Required[str]

The application id is used to connect to Oxford Dictionaries.

Receive your application id here.

app_key: Required[str]

The application key is used to connect to Oxford Dictionaries.

Receive your application key here.

language: Optional[str]

The language Pythonary will search in.

Default language is ‘en’ or English.

This variable must be the ‘Language Code’ and not the full language name!

See all the language’s here

Example:

>>> from pythonary import Oxford
>>> app = Oxford.Dictionary(app_id="YourAppID",
...                         app_key="YourAppKey",
...                         language="en-gb")

Select ¶

Select a word, per select 1 API request gets sent.
You can only use all the other commands when a word is selected.
Using the API this way leads to less requests and equal information!

Parameters:

word: Required[str]

The word you want to have selected, this word must be in the singular form.

Example:

>>> from pythonary import Oxford
>>> app = Oxford.Dictionary(app_id="YourAppID",
...                         app_key="YourAppKey")
>>> app.Select("example")

parsed ¶

Retrieve the raw JSON information.

You can preform all JSON commands on it!

Returns:

data[dict]

Example:

>>> from pythonary import Oxford
>>> app = Oxford.Dictionary(app_id="YourAppID",
...                         app_key="YourAppKey")
>>> app.Select("example")
>>> app.parsed()
<<< {'raw':[{'json':'data', 'in':'a', 'python':'dictionary'}]}