Le 28/02/2023 à 21:42, MusikAnimal a écrit :
Hello! Where might I find documentation on the new maintenance runner system? I can't find any examples in the Phabricator task or the linked RFC, and searching for "MaintenanceRunner" or "run.php" yields no results on mediawiki.org <http://mediawiki.org>. Specifically, I was expecting Manual:run.php <https://www.mediawiki.org/wiki/Manual:Run.php> to exist with some info on how it works.

If given a good example patch, I'm happy to help write the docs :)

Hello,

run.php is more or less a wrapper so that instead of invoking:

 php maintenance/parse.php

One should use:

 maintenance/run parse

That will be released in MediaWiki 1.40 and all maintenance scripts will emit a warning to the console when invoked directly.

Here are some references to assist in writing the documentation:

 * invocation examples in the commit message of
   https://gerrit.wikimedia.org/r/c/mediawiki/core/+/798983
 * the warning being added
   https://gerrit.wikimedia.org/r/c/mediawiki/core/+/874922
 * T99268 - RfC: Create a proper command-line runner for MediaWiki
   maintenance tasks <https://phabricator.wikimedia.org/T99268>

And as an extra, I have implemented a back compat layer in Quibble <https://doc.wikimedia.org/quibble/> (which is written in Python): https://gerrit.wikimedia.org/r/c/integration/quibble/+/875981/6/quibble/mediawiki/maintenance.py


Antoine "hashar" Musso
Wikimedia Release Engineering
_______________________________________________
Wikitech-l mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://lists.wikimedia.org/postorius/lists/wikitech-l.lists.wikimedia.org/

Reply via email to