Skip to content

This extension for Mediawiki add test stubs and doubles to Lua modules. This makes it possible to recreate actions that can otherwise be difficult to achieve, to facilitate interactive and collaborative debugging.

License

Notifications You must be signed in to change notification settings

jeblad/Doppelganger

Repository files navigation

Doppelgänger

stability-experimental GitHub issues

This extension for Mediawiki adds test stubs and doubles (or doppelgängers) for use in Lua modules provided by the Scribunto extension. This makes it possible to report failures clearly and visible, to facilitate interactive and collaborative fault fixing.

Extensive help is available at Doppelganger: Test stubs and doubles for Lua code embedded within Mediawiki, with a programmers guide, a reference, and examples.

Usage

Doppelganger depends on modules from the Scribunto extension.

  1. Download from Github (zip) and place the file(s) in a directory called Doppelganger in your extensions/ folder.

  2. Add the following code at the bottom of your LocalSettings.php:

    wfLoadExtension( 'Doppelganger' );
  3. Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Development

Doppelganger uses Mediawiki-Vagrant, and a complete setup can be made quite easily.

  1. Make sure you have Vagrant, etc, prepare a development directory, and move to that directory.

  2. Clone Mediawiki

    git clone --recursive https://gerrit.wikimedia.org/r/mediawiki/vagrant .
  3. Add the role unless #539690 has been merged. (You need git-review to do this.)

    git review -d 539690
  4. Run setup.

    ./setup.sh
  5. Enable role for Doppelganger. This pulls in the role for Scribunto, which then pulls in additional roles.

    vagrant roles enable doppelganger
  6. Start the instance.

    vagrant up
  7. Done.

About

This extension for Mediawiki add test stubs and doubles to Lua modules. This makes it possible to recreate actions that can otherwise be difficult to achieve, to facilitate interactive and collaborative debugging.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

No packages published