fwdekker/mediawiki-purger

Purges all pages on a wiki

MediaWiki Purger

Purge all pages on a MediaWiki wiki using a CLI tool.

Requirements

• Java 11 or newer.
• Tested on MediaWiki 1.33.3.

Usage

1. Download the jar on the releases page.
2. Open a terminal and navigate to where you downloaded the jar.
3. Run the jar with java -jar mediawiki-purger.jar [options]. See below for a list of options.

Options

Usage: purger [OPTIONS]

Options:
  --api TEXT           The URL to the MediaWiki API, such as
                       https://www.mediawiki.org/w/api.php.
  --page-size INT      Amount of pages to purge at a time.
  --throttle INT...    The maximum amount of API requests per time period in
                       milliseconds, such as `10 1000` for 10 requests per
                       second.
  --start-from TEXT    Starts purging pages in alphabetical order starting
                       from this page title. Does not have to refer to an
                       existing page.
  --username TEXT      The username to log in as, including the @.
  --bot-password TEXT  The bot password to log in with.
  -h, --help           Show this message and exit

Development

gradlew assemble  # Create the jar in the `build/libs` directory
gradlew check     # Run tests and static analysis

Debugging

To run the jar with a specific log level, run java -Dorg.slf4j.simpleLogger.defaultLogLevel=<LEVEL> -jar mediawiki-purger.jar [options].

mediawiki-purger's Issues

Display last response upon crash

If the application crashes, it should display the last message it received from the server as debug information.

Add login methods

Allow users to log in to potentially increase server-side interaction limits.

Fix weird newlines in log messages

I'm using raw strings in Kotlin which unfortunately means that some of the newlines are present in the logged messages. This should not be so.