https://github.com/gesiscss/wikiwho_wrapper

A light/simple Python wrapper for the WikiWho API
https://github.com/gesiscss/wikiwho_wrapper

Last synced: about 1 year ago
JSON representation

A light/simple Python wrapper for the WikiWho API

• Host: GitHub
• URL: https://github.com/gesiscss/wikiwho_wrapper
• Owner: gesiscss
• License: mit
• Created: 2018-10-12T13:28:45.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2023-10-13T20:19:23.000Z (almost 3 years ago)
• Last Synced: 2025-05-07T05:48:03.968Z (about 1 year ago)
• Language: Python
• Homepage:
• Size: 260 KB
• Stars: 4
• Watchers: 4
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# wikiwho_wrapper

A light/simple Python wrapper for the [WikiWho API](https://wikiwho-api.wmcloud.org/).

The [WikiWho API](https://wikiwho-api.wmcloud.org/) provides the first editor (author) of Wikipedia words (tokens). It also provides the history of each of the tokens, i.e. in which revisions (and which editors) was the token (re)inserted or removed. The API is based on the [WikiWho algorithm](https://github.com/wikiwho) (~95% acc.). 

Find full information and how to cite this work in [wikiwho-api.wmcloud.org](https://wikiwho-api.wmcloud.org/).

# Installation

Requires python >= 3.6

    pip install wikiwho_wrapper

# How to use it?

First, you need an instance of the WikiWho. 

    from wikiwho_wrapper import WikiWho

    ww = WikiWho() # or WikiWho(USERNAME, PASSWORD)

You can either use api with the JSON (raw format from wikiwho-api.wmcloud.org)

    response = ww.api.all_content("Bioglass")

Or you can use the dataview to obtain a pandas DataFrame representation of the data

    dataView = ww.dv.all_content("Bioglass")

***Note that all the methods, and classes can receive parameters. All the parameters of the API are currently supported. For now, you can check them directly in the [code](https://github.com/gesiscss/wikiwho_wrapper).***

# Tutorial

[![Binder](https://notebooks.gesis.org/binder/badge_logo.svg)](https://notebooks.gesis.org/binder/v2/gh/gesiscss/wikiwho_tutorial/master?filepath=1.%20API%20requests%20(WikiWho%20wrapper).ipynb)

The Github repository of the tutorial is available [here](https://github.com/gesiscss/wikiwho_tutorial).