MediaWiki  master
MediaWiki\Tests\Maintenance\BackupDumperPageTest Class Reference

Tests for page dumps of BackupDumper. More...

Inheritance diagram for MediaWiki\Tests\Maintenance\BackupDumperPageTest:
Collaboration diagram for MediaWiki\Tests\Maintenance\BackupDumperPageTest:

Public Member Functions

 addDBData ()
 
 schemaVersionProvider ()
 
 tearDown ()
 
 testCurrentStubGzip ()
 
 testCurrentStubPlain ( $schemaVersion)
 schemaVersionProvider More...
 
 testFullStubPlain ( $schemaVersion)
 schemaVersionProvider More...
 
 testFullTextPlain ( $schemaVersion)
 schemaVersionProvider More...
 
 testXmlDumpsBackupUseCase ( $schemaVersion)
 xmldumps-backup typically performs a single dump that that writes out three files More...
 
- Public Member Functions inherited from MediaWiki\Tests\Maintenance\DumpTestCase
 expectETAOutput ()
 Checks for test output consisting only of lines containing ETA announcements. More...
 
- Public Member Functions inherited from MediaWikiTestCase
 __construct ( $name=null, array $data=[], $dataName='')
 
 __destruct ()
 
 addDBData ()
 Stub. More...
 
 addDBDataOnce ()
 Stub. More...
 
 copyTestData (IDatabase $source, IDatabase $target)
 Copy test data from one database connection to another. More...
 
 dbPrefix ()
 
 getCliArg ( $offset)
 
 hideDeprecated ( $function)
 Don't throw a warning if $function is deprecated and called later. More...
 
 needsDB ()
 
 run (PHPUnit_Framework_TestResult $result=null)
 
 setCliArg ( $offset, $value)
 
 setContentLang ( $lang)
 
 setGroupPermissions ( $newPerms, $newKey=null, $newValue=null)
 Alters $wgGroupPermissions for the duration of the test. More...
 
 setupAllTestDBs ()
 Set up all test DBs. More...
 
 setUserLang ( $lang)
 
 testMediaWikiTestCaseParentSetupCalled ()
 Make sure MediaWikiTestCase extending classes have called their parent setUp method. More...
 
 usesTemporaryTables ()
 

Public Attributes

 $pageId2
 
 $pageId3
 
 $pageId4
 
 $pageTitle2
 
 $pageTitle3
 
 $pageTitle4
 
 $revId2_2
 
 $revId2_4
 
 $revId3_2
 
 $talk_namespace
 
 $textId1_1
 
 $textId2_1
 
 $textId2_2
 
 $textId2_3
 
 $textId2_4
 
 $textId3_1
 
 $textId3_2
 
 $textId4_1
 
- Public Attributes inherited from MediaWikiTestCase
const DB_PREFIX = 'unittest_'
 Table name prefixes. More...
 
const ORA_DB_PREFIX = 'ut_'
 

Protected Member Functions

 setUp ()
 
- Protected Member Functions inherited from MediaWiki\Tests\Maintenance\DumpTestCase
 addRevision (WikiPage $page, $text, $summary, $model=CONTENT_MODEL_WIKITEXT)
 Adds a revision to a page, while returning the resuting revision's id. More...
 
 assertDumpSchema ( $fname, $schemaFile)
 Checks an XML file against an XSD schema. More...
 
 checkHasGzip ()
 Skip the test if 'gzip' is not in $PATH. More...
 
 getDumpAsserter ( $schemaVersion=null)
 
 getXmlSchemaPath ( $schemaVersion=null)
 Returns the path to the XML schema file for the given schema version. More...
 
 gunzip ( $fname)
 gunzips the given file and stores the result in the original file name More...
 
 setUp ()
 Default set up function. More...
 
- Protected Member Functions inherited from MediaWikiLangTestCase
 setUp ()
 
- Protected Member Functions inherited from MediaWikiTestCase
 addCoreDBData ()
 
 addTmpFiles ( $files)
 
 anythingBut (... $values)
 Returns a PHPUnit constraint that matches anything other than a fixed set of values. More...
 
 arrayWrap (array $elements)
 Utility method taking an array of elements and wrapping each element in its own array. More...
 
 assertArrayEquals (array $expected, array $actual, $ordered=false, $named=false)
 Assert that two arrays are equal. More...
 
 assertFileContains ( $fileName, $actualData, $createIfMissing=false, $msg='')
 Check whether file contains given data. More...
 
 assertHTMLEquals ( $expected, $actual, $msg='')
 Put each HTML element on its own line and then equals() the results. More...
 
 assertSelect ( $table, $fields, $condition, array $expectedRows, array $options=[], array $join_conds=[])
 Asserts that the given database query yields the rows given by $expectedRows. More...
 
 assertType ( $type, $actual, $message='')
 Asserts the type of the provided value. More...
 
 assertTypeOrValue ( $type, $actual, $value=false, $message='')
 Asserts that the provided variable is of the specified internal type or equals the $value argument. More...
 
 checkDbIsSupported ()
 
 checkPHPExtension ( $extName)
 Check if $extName is a loaded PHP extension, will skip the test whenever it is not loaded. More...
 
 editPage ( $pageName, $text, $summary='', $defaultNs=NS_MAIN)
 Edits or creates a page/revision. More...
 
 ensureMockDatabaseConnection (IDatabase $db)
 
 getDefaultWikitextNS ()
 Returns the ID of a namespace that defaults to Wikitext. More...
 
 getExistingTestPage ( $title=null)
 Returns a WikiPage representing an existing page. More...
 
 getNewTempDirectory ()
 obtains a new temporary directory More...
 
 getNewTempFile ()
 Obtains a new temporary file name. More...
 
 getNonexistingTestPage ( $title=null)
 Returns a WikiPage representing a non-existing page. More...
 
static getSchemaOverrides (IMaintainableDatabase $db)
 Stub. More...
 
 insertPage ( $pageName, $text='Sample page for unit test.', $namespace=null, User $user=null)
 Insert a new page. More...
 
 isTestInDatabaseGroup ()
 
 isWikitextNS ( $ns)
 Returns true if the given namespace defaults to Wikitext according to $wgNamespaceContentModels. More...
 
 markTestSkippedIfDbType ( $type)
 Skip the test if using the specified database type. More...
 
 markTestSkippedIfNoDiff3 ()
 Check, if $wgDiff3 is set and ready to merge Will mark the calling test as skipped, if not ready. More...
 
 mergeMwGlobalArrayValue ( $name, $values)
 Merges the given values into a MW global array variable. More...
 
 objectAssociativeSort (array &$array)
 Does an associative sort that works for objects. More...
 
 overrideMwServices (Config $configOverrides=null, array $services=[])
 Stashes the global instance of MediaWikiServices, and installs a new one, allowing test cases to override settings and services. More...
 
 revisionDelete ( $rev, array $value=[Revision::DELETED_TEXT=> 1], $comment='')
 Revision-deletes a revision. More...
 
 setIniSetting ( $name, $value)
 Set an ini setting for the duration of the test. More...
 
 setLogger ( $channel, LoggerInterface $logger)
 Sets the logger for a specified channel, for the duration of the test. More...
 
 setMwGlobals ( $pairs, $value=null)
 Sets a global, maintaining a stashed version of the previous global to be restored in tearDown. More...
 
 setService ( $name, $object)
 Sets a service, maintaining a stashed version of the previous service to be restored in tearDown. More...
 
 setTemporaryHook ( $hookName, $handler)
 Create a temporary hook handler which will be reset by tearDown. More...
 
 setUp ()
 
 tearDown ()
 
 truncateTable ( $tableName, IDatabase $db=null)
 Empties the given table and resets any auto-increment counters. More...
 

Private Member Functions

 newDumpBackup ( $argv, $startId, $endId)
 
 newStreamingDBConnection ()
 Returns a new database connection which is separate from the conenctions returned by the default LoadBalancer instance. More...
 

Private Attributes

 $namespace
 
 $pageId1
 
 $pageTitle1
 
 $revId1_1
 
 $revId2_1
 
 $revId2_3
 
 $revId3_1
 
 $revId4_1
 
LoadBalancer null $streamingLoadBalancer = null
 

Additional Inherited Members

- Static Public Member Functions inherited from MediaWiki\Tests\Maintenance\DumpTestCase
static setUpBeforeClass ()
 
- Static Public Member Functions inherited from MediaWikiTestCase
static getMutableTestUser ( $groups=[])
 Convenience method for getting a mutable test user. More...
 
static getTestPrefixFor (IDatabase $db)
 
static getTestSysop ()
 Convenience method for getting an immutable admin test user. More...
 
static getTestUser ( $groups=[])
 Convenience method for getting an immutable test user. More...
 
static installMockMwServices (Config $configOverrides=null)
 Creates a new "mock" MediaWikiServices instance, and installs it. More...
 
static listTables (IMaintainableDatabase $db)
 
static prepareServices (Config $bootstrapConfig)
 
static resetNonServiceCaches ()
 Resets some non-service singleton instances and other static caches. More...
 
static restoreMwServices ()
 Restores the original, non-mock MediaWikiServices instance. More...
 
static setUpBeforeClass ()
 
static setupTestDB (IMaintainableDatabase $db, $prefix)
 Creates an empty skeleton of the wiki database by cloning its structure to equivalent tables using the given $prefix. More...
 
static teardownTestDB ()
 Restores MediaWiki to using the table set (table prefix) it was using before setupTestDB() was called. More...
 
static wfResetOutputBuffersBarrier ( $buffer)
 Used as a marker to prevent wfResetOutputBuffers from breaking PHPUnit. More...
 
- Static Public Attributes inherited from MediaWikiTestCase
static TestUser [] $users
 
- Static Protected Member Functions inherited from MediaWikiTestCase
static getExternalStoreDatabaseConnections ()
 Gets master database connections for all of the ExternalStoreDB stores configured in $wgDefaultExternalStore. More...
 
static isUsingExternalStoreDB ()
 Check whether ExternalStoreDB is being used. More...
 
static setupDatabaseWithTestPrefix (IMaintainableDatabase $db, $prefix=null)
 Setups a database with cloned tables using the given prefix. More...
 
static setupExternalStoreTestDBs ( $testPrefix=null)
 Clones the External Store database(s) for testing. More...
 
static stripStringKeys (&$r)
 Utility function for eliminating all string keys from an array. More...
 
- Protected Attributes inherited from MediaWiki\Tests\Maintenance\DumpTestCase
Exception null $exceptionFromAddDBData = null
 exception to be rethrown once in sound PHPUnit surrounding More...
 
- Protected Attributes inherited from MediaWikiTestCase
Database $db
 Primary database. More...
 
array $supportedDBs
 
array $tablesUsed = []
 
- Static Protected Attributes inherited from MediaWiki\Tests\Maintenance\DumpTestCase
static bool null $hasGzip = null
 Whether the 'gzip' utility is available. More...
 

Detailed Description

Tests for page dumps of BackupDumper.

Database Dump BackupDumper

Definition at line 24 of file backup_PageTest.php.

Member Function Documentation

◆ addDBData()

MediaWiki\Tests\Maintenance\BackupDumperPageTest::addDBData ( )

◆ newDumpBackup()

◆ newStreamingDBConnection()

MediaWiki\Tests\Maintenance\BackupDumperPageTest::newStreamingDBConnection ( )
private

Returns a new database connection which is separate from the conenctions returned by the default LoadBalancer instance.

Returns
IDatabase

Definition at line 130 of file backup_PageTest.php.

References MediaWikiTestCase\$db, MediaWikiTestCase\copyTestData(), DB_REPLICA, MediaWiki\MediaWikiServices\getInstance(), and MediaWikiTestCase\setupDatabaseWithTestPrefix().

Referenced by MediaWiki\Tests\Maintenance\BackupDumperPageTest\newDumpBackup().

◆ schemaVersionProvider()

MediaWiki\Tests\Maintenance\BackupDumperPageTest::schemaVersionProvider ( )

Definition at line 174 of file backup_PageTest.php.

References XmlDumpWriter\$supportedSchemas, and as.

◆ setUp()

MediaWiki\Tests\Maintenance\BackupDumperPageTest::setUp ( )
protected

Definition at line 103 of file backup_PageTest.php.

◆ tearDown()

MediaWiki\Tests\Maintenance\BackupDumperPageTest::tearDown ( )

Definition at line 116 of file backup_PageTest.php.

◆ testCurrentStubGzip()

◆ testCurrentStubPlain()

◆ testFullStubPlain()

◆ testFullTextPlain()

◆ testXmlDumpsBackupUseCase()

MediaWiki\Tests\Maintenance\BackupDumperPageTest::testXmlDumpsBackupUseCase (   $schemaVersion)

xmldumps-backup typically performs a single dump that that writes out three files

  • gzipped stubs of everything (meta-history)
  • gzipped stubs of latest revisions of all pages (meta-current)
  • gzipped stubs of latest revisions of all pages of namespage 0 (articles)

We reproduce such a setup with our mini fixture, although we omit chunks, and all the other gimmicks of xmldumps-backup.

schemaVersionProvider

Definition at line 553 of file backup_PageTest.php.

References MediaWiki\Tests\Maintenance\DumpTestCase\assertDumpSchema(), MediaWiki\Tests\Maintenance\DumpTestCase\checkHasGzip(), MediaWiki\Tests\Maintenance\DumpTestCase\expectETAOutput(), WikiExporter\FULL, MediaWiki\Tests\Maintenance\DumpTestCase\getDumpAsserter(), MediaWikiTestCase\getNewTempFile(), MediaWiki\Tests\Maintenance\DumpTestCase\getXmlSchemaPath(), MediaWiki\Tests\Maintenance\DumpTestCase\gunzip(), MediaWiki\Tests\Maintenance\BackupDumperPageTest\newDumpBackup(), and WikiExporter\STUB.

Member Data Documentation

◆ $namespace

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$namespace
private

Definition at line 35 of file backup_PageTest.php.

◆ $pageId1

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$pageId1
private

Definition at line 28 of file backup_PageTest.php.

◆ $pageId2

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$pageId2

Definition at line 28 of file backup_PageTest.php.

◆ $pageId3

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$pageId3

Definition at line 28 of file backup_PageTest.php.

◆ $pageId4

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$pageId4

Definition at line 28 of file backup_PageTest.php.

◆ $pageTitle1

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$pageTitle1
private

Definition at line 29 of file backup_PageTest.php.

◆ $pageTitle2

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$pageTitle2

Definition at line 29 of file backup_PageTest.php.

◆ $pageTitle3

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$pageTitle3

Definition at line 29 of file backup_PageTest.php.

◆ $pageTitle4

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$pageTitle4

Definition at line 29 of file backup_PageTest.php.

◆ $revId1_1

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$revId1_1
private

Definition at line 30 of file backup_PageTest.php.

◆ $revId2_1

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$revId2_1
private

Definition at line 31 of file backup_PageTest.php.

◆ $revId2_2

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$revId2_2

Definition at line 31 of file backup_PageTest.php.

◆ $revId2_3

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$revId2_3
private

Definition at line 32 of file backup_PageTest.php.

◆ $revId2_4

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$revId2_4

Definition at line 32 of file backup_PageTest.php.

◆ $revId3_1

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$revId3_1
private

Definition at line 33 of file backup_PageTest.php.

◆ $revId3_2

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$revId3_2

Definition at line 33 of file backup_PageTest.php.

◆ $revId4_1

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$revId4_1
private

Definition at line 34 of file backup_PageTest.php.

◆ $streamingLoadBalancer

LoadBalancer null MediaWiki\Tests\Maintenance\BackupDumperPageTest::$streamingLoadBalancer = null
private

Definition at line 40 of file backup_PageTest.php.

◆ $talk_namespace

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$talk_namespace

Definition at line 35 of file backup_PageTest.php.

◆ $textId1_1

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$textId1_1

Definition at line 30 of file backup_PageTest.php.

◆ $textId2_1

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$textId2_1

Definition at line 31 of file backup_PageTest.php.

◆ $textId2_2

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$textId2_2

Definition at line 31 of file backup_PageTest.php.

◆ $textId2_3

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$textId2_3

Definition at line 32 of file backup_PageTest.php.

◆ $textId2_4

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$textId2_4

Definition at line 32 of file backup_PageTest.php.

◆ $textId3_1

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$textId3_1

Definition at line 33 of file backup_PageTest.php.

◆ $textId3_2

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$textId3_2

Definition at line 33 of file backup_PageTest.php.

◆ $textId4_1

MediaWiki\Tests\Maintenance\BackupDumperPageTest::$textId4_1

Definition at line 34 of file backup_PageTest.php.


The documentation for this class was generated from the following file: