Benjamin Mako Hill
70b0ebcf0c
-p legacy is the only thing that uses mediawiki-utilities, and it exists solely to reproduce numbers from research predating the mwxml and mwtypes split. The package is a 2015 monolith that also contains mw.database and mw.api, so it declares requests and pymysql unconditionally: every wikiq install pulled a MySQL client and six other packages to support one flag, building them from an sdist that has no wheel. Move it to a `legacy` extra. mw.lib.persistence imports nothing from mw.database or mw.api, so nothing about -p legacy changes for people who install the extra, and everyone else stops paying for it. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> (cherry picked from commit 66dcc6d8cea620a619fc19121b5c27a085b11991)
When you install this from git, you will need to first clone the repository:
git clone git://projects.mako.cc/mediawiki_dump_tools
From within the repository working directory, initiatlize and set up the submodule like:
git submodule init
git submodule update
Wikimedia dumps are usually in a compressed format such as 7z (most common), gz, or bz2. Wikiq uses your computer's compression software to read these files. Therefore wikiq depends on [7za]{.title-ref}, [gzcat]{.title-ref}, and [zcat]{.title-ref}.
Dependencies
These non-Python dependencies must be installed on your system for wikiq and its associated tests to work.
- 7zip
- ffmpeg
A new diff engine based on [_wikidiff2]{.title-ref} can be used for word-persistence. Wikiq can also output the diffs between each page revision. This requires installing Wikidiff 2 on your system. On Debian or Ubuntu Linux this can be done via.
apt-get install php-wikidiff2
You may have to also run. sudo phpenmod wikidiff2.
Tests ----To run tests:
python -m unittest test.Wikiq_Unit_Test
TODO:
- [] Output metadata about the run. What parameters were used? What versions of deltas?
- [] Url encoding by default