Skip to content

netgo.wiki - wrappers around the MediaWiki Action API. ​

Talks to four Wikimedia wikis through a single shared netgo.wiki.client.WikiClient:

  • **Wikipedia** (netgo.wiki.core) - full-text search, article

summaries and paragraphs, section outlines, links, backlinks, categories, images, random pages and geo search.

  • **Wikidata** (netgo.wiki.wikidata) - resolve article titles to

QIDs, fetch entities, search labels, read claims/properties, aliases and sitelinks, and run raw SPARQL queries.

  • **Wikimedia Commons** (netgo.wiki.wikimedia) - find media files

and fetch their URLs, thumbnails and licensing metadata.

  • **Wiktionary** (netgo.wiki.wiktionary) - dictionary

definitions, etymology and the languages a word exists in.

Every function returns structured dataclasses (see netgo.wiki.models) and raises WikiError subclasses on failure, so a try/except WikiError covers the whole subpackage.

Example:

python
>>> from netgo.wiki import search, summary, wikidata_id
>>> hits = search("machine learning", limit=3)
>>> hits[0].title
'Machine learning'
>>> summary("Bread", sentences=1).startswith("Bread is")
True
>>> wikidata_id("Python (programming language)")
'Q28865'

Released under the MIT License.