MediaWiki master
|
Maintenance script to provide RDF representation of the recent changes in category tree. More...
Inherits Maintenance.
Public Member Functions | |
__construct () | |
Default constructor. | |
execute () | |
Do the actual work. | |
getRdf () | |
Get accumulated RDF. | |
handleAdds (IReadableDatabase $dbr, $output) | |
handleCategorization (IReadableDatabase $dbr, $output) | |
Handles categorization changes. | |
handleDeletes (IReadableDatabase $dbr, $output) | |
Handle category deletes. | |
handleEdits (IReadableDatabase $dbr, $output) | |
Handle edits for category texts. | |
handleMoves (IReadableDatabase $dbr, $output) | |
handleRestores (IReadableDatabase $dbr, $output) | |
initialize () | |
Initialize external service classes. | |
updateTS ( $timestamp) | |
Generate SPARQL Update code for updating dump timestamp. | |
Public Member Functions inherited from Maintenance | |
canExecuteWithoutLocalSettings () | |
Whether this script can run without LocalSettings.php. | |
checkRequiredExtensions () | |
Verify that the required extensions are installed. | |
cleanupChanneled () | |
Clean up channeled output. | |
clearParamsAndArgs () | |
Clear all params and arguments. | |
createChild (string $maintClass, ?string $classFile=null) | |
Returns an instance of the given maintenance script, with all of the current arguments passed to it. | |
finalSetup (SettingsBuilder $settingsBuilder) | |
Handle some last-minute setup here. | |
getConfig () | |
getDbType () | |
Does the script need different DB access? By default, we give Maintenance scripts normal rights to the DB. | |
getName () | |
Get the script's name. | |
getParameters () | |
isQuiet () | |
loadParamsAndArgs ( $self=null, $opts=null, $args=null) | |
Process command line arguments when running as a child script. | |
loadWithArgv ( $argv) | |
Load params and arguments from a given array of command-line arguments. | |
memoryLimit () | |
Normally we disable the memory_limit when running admin scripts. | |
outputChanneled ( $msg, $channel=null) | |
Message outputter with channeled message support. | |
purgeRedundantText ( $delete=true) | |
Support function for cleaning up redundant text records. | |
runChild ( $maintClass, $classFile=null) | |
Returns an instance of the given maintenance script, with all of the current arguments passed to it. | |
setArg ( $argId, $value) | |
Programmatically set the value of the given argument. | |
setConfig (Config $config) | |
setDB (IMaintainableDatabase $db) | |
Sets database object to be returned by getDB(). | |
setDBProvider (IConnectionProvider $dbProvider) | |
setName (string $name) | |
setOption (string $name, $value) | |
Programmatically set the value of the given option. | |
setup () | |
Provides subclasses with an opportunity to perform initial checks. | |
validateParamsAndArgs () | |
Run some validation checks on the params, etc. | |
Protected Member Functions | |
getCategoryLinksIterator (IReadableDatabase $dbr, array $ids, $fname) | |
Get iterator for links for categories. | |
getChangedCatsIterator (IReadableDatabase $dbr, $type, $fname) | |
Fetch categorization changes or edits. | |
getDeletedCatsIterator (IReadableDatabase $dbr, $fname) | |
Fetch deleted categories. | |
getMovedCatsIterator (IReadableDatabase $dbr, $fname) | |
Fetch moved categories. | |
getNewCatsIterator (IReadableDatabase $dbr, $fname) | |
Fetch newly created categories. | |
getRestoredCatsIterator (IReadableDatabase $dbr, $fname) | |
Fetch restored categories. | |
Protected Member Functions inherited from Maintenance | |
addArg ( $arg, $description, $required=true, $multi=false) | |
Add some args that are needed. | |
addDefaultParams () | |
Add the default parameters to the scripts. | |
addDescription ( $text) | |
Set the description text. | |
addOption ( $name, $description, $required=false, $withArg=false, $shortName=false, $multiOccurrence=false) | |
Add a parameter to the script. | |
afterFinalSetup () | |
Override to perform any required operation at the end of initialisation. | |
beginTransaction (IDatabase $dbw, $fname) | |
Begin a transaction on a DB. | |
commitTransaction (IDatabase $dbw, $fname) | |
Commit the transaction on a DB handle and wait for replica DBs to catch up. | |
countDown ( $seconds) | |
Count down from $seconds to zero on the terminal, with a one-second pause between showing each number. | |
deleteOption ( $name) | |
Remove an option. | |
error ( $err, $die=0) | |
Throw an error to the user. | |
fatalError ( $msg, $exitCode=1) | |
Output a message and terminate the current script. | |
getArg ( $argId=0, $default=null) | |
Get an argument. | |
getArgName (int $argId) | |
Get the name of an argument. | |
getArgs ( $offset=0) | |
Get arguments. | |
getBatchSize () | |
Returns batch size. | |
getDB ( $db, $groups=[], $dbDomain=false) | |
Returns a database to be used by current maintenance script. | |
getDir () | |
Get the maintenance directory. | |
getHookContainer () | |
Get a HookContainer, for running extension hooks or for hook metadata. | |
getHookRunner () | |
Get a HookRunner for running core hooks. | |
getOption ( $name, $default=null) | |
Get an option, or return the default. | |
getPrimaryDB () | |
getReplicaDB () | |
getServiceContainer () | |
Returns the main service container. | |
getStdin ( $len=null) | |
Return input from stdin. | |
hasArg ( $argId=0) | |
Does a given argument exist? | |
hasOption ( $name) | |
Checks to see if a particular option was set. | |
loadSpecialVars () | |
Handle the special variables that are global to all scripts. | |
maybeHelp ( $force=false) | |
Maybe show the help. | |
output ( $out, $channel=null) | |
Throw some output to the user. | |
parseIntList ( $text) | |
Utility function to parse a string (perhaps from a command line option) into a list of integers (perhaps some kind of numeric IDs). | |
prompt (string $prompt, string $default=null) | |
requireExtension ( $name) | |
Indicate that the specified extension must be loaded before the script can run. | |
rollbackTransaction (IDatabase $dbw, $fname) | |
Rollback the transaction on a DB handle. | |
setAllowUnregisteredOptions ( $allow) | |
Sets whether to allow unregistered options, which are options passed to a script that do not match an expected parameter. | |
setBatchSize ( $s=0) | |
showHelp () | |
Definitely show the help. | |
supportsOption ( $name) | |
Checks to see if a particular option in supported. | |
validateUserOption ( $errorMsg) | |
waitForReplication () | |
Wait for replica DBs to catch up. | |
Protected Attributes | |
true[] | $processed = [] |
List of processed page IDs, so we don't try to process same thing twice. | |
Protected Attributes inherited from Maintenance | |
array | $mArgs = [] |
This is the list of arguments that were actually passed. | |
int null | $mBatchSize = null |
Batch size. | |
string | $mDbPass = null |
string | $mDbUser = null |
string | $mDescription = '' |
A description of the script, children should change this via addDescription() | |
bool | $mInputLoaded = false |
Have we already loaded our user input? | |
array | $mOptions = [] |
This is the list of options that were actually passed. | |
array[] | $mParams = [] |
Empty. | |
bool | $mQuiet = false |
Special vars for params that are always used. | |
string null | $mSelf |
Name of the script currently running. | |
MaintenanceParameters | $parameters |
Additional Inherited Members | |
Static Public Member Functions inherited from Maintenance | |
static | getTermSize () |
Get the terminal size as a two-element array where the first element is the width (number of columns) and the second element is the height (number of rows). | |
static | posix_isatty ( $fd) |
Wrapper for posix_isatty() We default as considering stdin a tty (for nice readline methods) but treating stout as not a tty to avoid color codes. | |
static | readconsole ( $prompt='> ') |
Prompt the console for input. | |
static | requireTestsAutoloader () |
Call this to set up the autoloader to allow classes to be used from the tests directory. | |
Public Attributes inherited from Maintenance | |
resource null | $fileHandle |
Used when creating separate schema files. | |
array | $orderedOptions = [] |
Used to read the options in the order they were passed. | |
const | DB_ADMIN = 2 |
const | DB_NONE = 0 |
Constants for DB access type. | |
const | DB_STD = 1 |
const | GENERIC_MAINTENANCE_PARAMETERS = 'Script runner options' |
const | SCRIPT_DEPENDENT_PARAMETERS = 'Common options' |
const | STDIN_ALL = -1 |
Maintenance script to provide RDF representation of the recent changes in category tree.
Definition at line 37 of file categoryChangesAsRdf.php.
CategoryChangesAsRdf::__construct | ( | ) |
Default constructor.
Children should call this first if implementing their own constructors
Reimplemented from Maintenance.
Definition at line 85 of file categoryChangesAsRdf.php.
References Maintenance\addDescription(), Maintenance\addOption(), and Maintenance\setBatchSize().
CategoryChangesAsRdf::execute | ( | ) |
Do the actual work.
All child classes will need to implement this
Reimplemented from Maintenance.
Definition at line 108 of file categoryChangesAsRdf.php.
References DB_REPLICA, Maintenance\error(), Maintenance\getConfig(), Maintenance\getDB(), Maintenance\getOption(), getRdf(), handleAdds(), handleCategorization(), handleDeletes(), handleEdits(), handleMoves(), handleRestores(), initialize(), and updateTS().
|
protected |
Get iterator for links for categories.
IReadableDatabase | $dbr | |
int[] | $ids | List of page IDs |
string | $fname | Name of the calling function |
Definition at line 415 of file categoryChangesAsRdf.php.
References BatchRowIterator\addConditions(), BatchRowIterator\setCaller(), and BatchRowIterator\setFetchColumns().
|
protected |
Fetch categorization changes or edits.
IReadableDatabase | $dbr | |
int | $type | |
string | $fname | Name of the calling function |
Definition at line 375 of file categoryChangesAsRdf.php.
References NS_CATEGORY.
Referenced by handleCategorization(), and handleEdits().
|
protected |
Fetch deleted categories.
IReadableDatabase | $dbr | |
string | $fname | Name of the calling function |
Definition at line 324 of file categoryChangesAsRdf.php.
References NS_CATEGORY, and RC_LOG.
Referenced by handleDeletes().
|
protected |
Fetch moved categories.
IReadableDatabase | $dbr | |
string | $fname | Name of the calling function |
Definition at line 298 of file categoryChangesAsRdf.php.
References NS_CATEGORY, and RC_LOG.
Referenced by handleMoves().
|
protected |
Fetch newly created categories.
IReadableDatabase | $dbr | |
string | $fname | Name of the calling function |
Definition at line 283 of file categoryChangesAsRdf.php.
References NS_CATEGORY.
Referenced by handleAdds().
CategoryChangesAsRdf::getRdf | ( | ) |
Get accumulated RDF.
Definition at line 435 of file categoryChangesAsRdf.php.
Referenced by execute().
|
protected |
Fetch restored categories.
IReadableDatabase | $dbr | |
string | $fname | Name of the calling function |
Definition at line 353 of file categoryChangesAsRdf.php.
References NS_CATEGORY, and RC_LOG.
Referenced by handleRestores().
CategoryChangesAsRdf::handleAdds | ( | IReadableDatabase | $dbr, |
$output ) |
IReadableDatabase | $dbr | |
resource | $output |
Definition at line 535 of file categoryChangesAsRdf.php.
References getNewCatsIterator().
Referenced by execute().
CategoryChangesAsRdf::handleCategorization | ( | IReadableDatabase | $dbr, |
$output ) |
Handles categorization changes.
IReadableDatabase | $dbr | |
resource | $output |
Definition at line 595 of file categoryChangesAsRdf.php.
References getChangedCatsIterator(), Wikimedia\Rdbms\IReadableDatabase\newSelectQueryBuilder(), NS_CATEGORY, and RC_CATEGORIZE.
Referenced by execute().
CategoryChangesAsRdf::handleDeletes | ( | IReadableDatabase | $dbr, |
$output ) |
Handle category deletes.
IReadableDatabase | $dbr | |
resource | $output | File to write the output |
Definition at line 444 of file categoryChangesAsRdf.php.
References getDeletedCatsIterator().
Referenced by execute().
CategoryChangesAsRdf::handleEdits | ( | IReadableDatabase | $dbr, |
$output ) |
Handle edits for category texts.
IReadableDatabase | $dbr | |
resource | $output |
Definition at line 564 of file categoryChangesAsRdf.php.
References getChangedCatsIterator(), and RC_EDIT.
Referenced by execute().
CategoryChangesAsRdf::handleMoves | ( | IReadableDatabase | $dbr, |
$output ) |
IReadableDatabase | $dbr | |
resource | $output |
Definition at line 475 of file categoryChangesAsRdf.php.
References getMovedCatsIterator(), and NS_CATEGORY.
Referenced by execute().
CategoryChangesAsRdf::handleRestores | ( | IReadableDatabase | $dbr, |
$output ) |
IReadableDatabase | $dbr | |
resource | $output |
Definition at line 505 of file categoryChangesAsRdf.php.
References getRestoredCatsIterator().
Referenced by execute().
CategoryChangesAsRdf::initialize | ( | ) |
Initialize external service classes.
Definition at line 102 of file categoryChangesAsRdf.php.
Referenced by execute().
CategoryChangesAsRdf::updateTS | ( | $timestamp | ) |
Generate SPARQL Update code for updating dump timestamp.
string | int | $timestamp | Timestamp for last change |
Definition at line 213 of file categoryChangesAsRdf.php.
References wfTimestamp().
Referenced by execute().
|
protected |
List of processed page IDs, so we don't try to process same thing twice.
Definition at line 83 of file categoryChangesAsRdf.php.