Skip to main content

A set of utilities for generating quality scores for MediaWiki revisions

Project description

travis codecov

Revision Scoring

A generic, machine learning-based revision scoring system designed to be used to automatically differentiate damage from productive contributory behavior on Wikipedia.

Example

Using a scorer_model to score a revision:

>>> import mwapi
>>> from revscoring import ScorerModel
>>> from revscoring.extractors import APIExtractor
>>>
>>> with open("models/enwiki.damaging.linear_svc.model") as f:
...     scorer_model = ScorerModel.load(f)
...
>>> extractor = APIExtractor(mwapi.Session(host="https://en.wikipedia.org",
...                                        user_agent="revscoring demo"))
>>>
>>> feature_values = extractor.extract(123456789, scorer_model.features)
>>>
>>> print(scorer_model.score(feature_values))
{'prediction': True, 'probability': {False: 0.4694409344514984, True: 0.5305590655485017}}

Installation

The easiest way to install revscoring is via the Python package installer (pip).

pip install revscoring

You may find that some of revscorings dependencies fail to compile (namely scipy, numpy and sklearn). In that case, you’ll need to install some dependencies in your operating system.

Ubuntu & Debian:

Run sudo apt-get install python3-dev g++ gfortran liblapack-dev libopenblas-dev

Windows:

‘TODO’

MacOS:

‘TODO’

Finally, in order to make use of language features, you’ll need to download some NLTK data. The following command will get the necessary corpus.

python -m nltk.downloader stopwords

You’ll also need to install enchant compatible dictionaries of the languages you’d like to use. We recommend the following:

  • languages.arabic: aspell-ar

  • languages.czech: myspell-cs

  • languages.dutch: myspell-nl

  • languages.english: myspell-en-us myspell-en-gb myspell-en-au

  • languages.estonian: myspell-et

  • languages.french: myspell-fr

  • languages.german: myspell-de-at myspell-de-ch myspell-de-de

  • languages.hebrew: myspell-he

  • languages.hungarian: myspell-hu

  • languages.indonesian: aspell-id

  • languages.italian: myspell-it

  • languages.norwegian: myspell-nb

  • languages.persian: myspell-fa

  • languages.polish: aspell-pl

  • languages.portuguese: myspell-pt

  • languages.spanish: myspell-es

  • languages.swedish: aspell-sv

  • languages.russian: myspell-ru

  • languages.ukrainian: myspell-uk

  • languages.vietnamese: hunspell-vi

Authors

Aaron Halfaker:
  • http://halfaker.info

Helder:
  • https://github.com/he7d3r

Adam Roses Wight:
  • https://mediawiki.org/wiki/User:Adamw

Amir Sarabadani:
  • https://github.com/Ladsgroup

Project details


Release history Release notifications | RSS feed

This version

1.2.8

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

revscoring-1.2.8.tar.gz (155.7 kB view details)

Uploaded Source

Built Distribution

revscoring-1.2.8-py2.py3-none-any.whl (345.1 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file revscoring-1.2.8.tar.gz.

File metadata

  • Download URL: revscoring-1.2.8.tar.gz
  • Upload date:
  • Size: 155.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for revscoring-1.2.8.tar.gz
Algorithm Hash digest
SHA256 50f4de33e33d3a758e0d7ef4e463c671d18a75bbc58aa5831a48829998026a3b
MD5 701340161d90d02abeeb26056248bbbe
BLAKE2b-256 9bc2e2ef7cf255d0195fcdf3d0592aeec4f92703f68f13c9eb8c5f5358dea806

See more details on using hashes here.

File details

Details for the file revscoring-1.2.8-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for revscoring-1.2.8-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 6376c7db2b7849640aaed5f82239100d94fae0e8968feb97d6708741f08bbd3f
MD5 98e2b1bec8035d34005b09749dfde18a
BLAKE2b-256 e53ceb4755349531630fa09b6e7a3911f02ff6d108298c6894f249e9b316fe25

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page