TestUserRegistry Class Reference

Collaboration diagram for TestUserRegistry:

Static Public Member Functions
static	clear ()
	Clear the registry.
static	getImmutableTestUser ( $groups=[])
	Get a TestUser object that the caller may not modify.
static	getMutableTestUser ( $testName, $groups=[])
	Get a TestUser object that the caller may modify.
static	getNextId ()
static	isMutable (User $user)

Static Private Attributes
static int	$counter = 0
	Count of users that have been generated.
static int	$randInt
	Random int, included in IDs.
static TestUser[]	$testUsers = []
	(group key => TestUser)

Detailed Description

Since

1.28

Definition at line 6 of file TestUserRegistry.php.

Member Function Documentation

clear()

static TestUserRegistry::clear ( )

static

Clear the registry.

TestUsers created by this class will not be deleted, but any handles to existing immutable TestUsers will be deleted, ensuring these users are not reused. We don't reset the counter or random string by design.

Since

1.28

Parameters

string[]

$groups

Groups the test user should be added to.

Returns

TestUser

Definition at line 105 of file TestUserRegistry.php.

getImmutableTestUser()

static TestUserRegistry::getImmutableTestUser (   $groups = [] )

static

Get a TestUser object that the caller may not modify.

Whenever possible, unit tests should use immutable users, because immutable users can be reused in multiple tests, which helps keep the unit tests fast.

Since

1.28

Parameters

string | string[]

$groups

Groups the test user should be added to.

Returns

TestUser

Definition at line 60 of file TestUserRegistry.php.

References $username, array(), and wfRandomString().

getMutableTestUser()

static TestUserRegistry::getMutableTestUser (   $testName,   $groups = []  )

static

Get a TestUser object that the caller may modify.

Since

1.28

Parameters

string	$testName	Caller's CLASS. Used to generate the user's username.
string | string[]	$groups	Groups the test user should be added to.

Returns

TestUser

Definition at line 34 of file TestUserRegistry.php.

References array(), and wfRandomString().

Referenced by MediaWiki\Tests\Revision\RevisionStoreDbTestBase\testNewNullRevision(), and MediaWiki\Tests\Revision\RevisionStoreDbTestBase\testNewNullRevision_nonExistingTitle().

getNextId()

static TestUserRegistry::getNextId ( )

static

Definition at line 17 of file TestUserRegistry.php.

isMutable()

static TestUserRegistry::isMutable ( User  $user )

static

Todo:

It would be nice if this were a non-static method of TestUser instead, but that doesn't seem possible without friends?

Returns

bool True if it's safe to modify the user

Definition at line 115 of file TestUserRegistry.php.

References $user, and as.

Member Data Documentation

$counter

int TestUserRegistry::$counter = 0

staticprivate

Count of users that have been generated.

Definition at line 12 of file TestUserRegistry.php.

$randInt

int TestUserRegistry::$randInt

staticprivate

Random int, included in IDs.

Definition at line 15 of file TestUserRegistry.php.

$testUsers

TestUser [] TestUserRegistry::$testUsers = []

staticprivate

(group key => TestUser)

Definition at line 9 of file TestUserRegistry.php.

---

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

• tests/phpunit/includes/TestUserRegistry.php