Metadata-Version: 2.1
Name: wikipedia-histories
Version: 0.0.4
Summary: A simple package designed to collect the edit histories of Wikipedia pages
Home-page: https://github.com/ndrezn/wikipedia-histories
Author: Nathan Drezner
Author-email: nathan@drezner.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: mwclient
Requires-Dist: mwparserfromhell
Requires-Dist: requests
Requires-Dist: lxml
Requires-Dist: time
Requires-Dist: datetime
Requires-Dist: asyncio
Requires-Dist: aiohttp
Requires-Dist: pandas

# Wikipedia Histories

A simple tool to allow a user to pull the complete edit history of a Wikipedia page in a variety of formats, including JSON, DataFrame, or directly as an object.

```python
  >>> import wikipedia_histories

  # Generate a list of revisions for a specified page
  >>> golden_swallow = get_history('Golden swallow')

  # Show the revision IDs for every edit
  >>> golden_swallow
  # [130805848, 162259515, 167233740, 195388442, ...

  # Show the user who made a specific edit
  >>> golden_swallow[16].user
  # u'Snowmanradio'

  # Show the text of at the time of a specific edit
  >>> golden_swallow[16].text
  # u'The Golden Swallow (Tachycineta euchrysea) is a swallow.  The Golden Swallow formerly'...
  >>> golden_swallow[200].text
  # u'The golden swallow (Tachycineta euchrysea) is a passerine in the swallow family'...

  # Generate a dataframe with text and metadata from a the list of revisions
  >>> build_df(golden_swallow)

  # Generate a JSON with text and metadata from the list of versions
  >>> build_json(golden_swallow)
```


## Installation

To install Wikipedia Histories, simply run:

``$ pip install wikipedia-histories``

Wikipedia Histories is compatible with Python 3.6+.

