The Python library for wiktionary words
This is an alpha library to retrieve and parse Wiktionary word pages that will require enhancements and fixes
If you install this library from source code or you want help with development of the code, make sure to install requirements first:
$ pip install -r ./requirements.txt
Install from the remote pip repository:
$ pip install pywiktionary
Install from the root of the source code:
$ pip install .
Initialize the parser factory (pywiktionary.wiktionary_parser_factory.WiktionaryParserFactory) with a supported language, then make the request with get_page() method passing the word you desire to get.
from pywiktionary import WiktionaryParserFactory
parser_factory = WiktionaryParserFactory(default_language='en')
pizza_parser = parser_factory.get_page('pizza')
Then to get data about the word use the parse() method of the parser object returned from WiktionaryParserFactory:
parsing_result = pizza_parser.parse()
The result variable is a dictionary containing the result of the wiktionary page parsing divided by type/subtype. The meanings type categories are dynamically taken from the Wiktionary page in the wiktionary language, Here the result for "pizza":
{
"meanings": {
"noun": [
{
"meaning": "(uncountable) A baked Italian dish of a thinly rolled bread dough crust typically topped before baking with tomato sauce, cheese, and other ingredients such as meat, vegetables or fruit",
"examples": [
"a slice of pizza",
"a pizza pie",
"Want to go out for pizza tonight?"
]
},
{
"meaning": "(countable) A single instance of this dish",
"examples": [
"He ate a whole pizza!",
"Should we cook a frozen pizza for dinner?"
]
}
]
}
}
This is the summary of above commented code:
from pywiktionary import WiktionaryParserFactory
parser_factory = WiktionaryParserFactory(default_language='en')
pizza_parser = parser_factory.get_page('pizza')
parsing_result = pizza_parser.parse()
Yeah, yeah... i know it is beautiful and easy as idea, but this library require many development to enhance this system!
- English - en
- Italian - it
- Surfable Software Documentation!
- Implement a good system to select wiktionary language parser
- Write a good human friend documentation! =)
- Write some examples for humans!
- Add requirements in setup.py for distributed package under wheel and PyPI