MediaWiki REL1_33
TitleTest Class Reference

Database Title. More...

Inheritance diagram for TitleTest:
Collaboration diagram for TitleTest:

Public Member Functions

 dataWgWhitelistReadRegexp ()
 Provides test parameter values for testWgWhitelistReadRegexp()
 
 flattenErrorsArray ( $errors)
 
 provideCanHaveTalkPage ()
 
 provideCreateFragmentTitle ()
 
 provideEquals ()
 
 provideGetFragmentForURL ()
 
 provideGetPrefixedDBKey ()
 
 provideGetPrefixedText ()
 
 provideIsRawHtmlMessage ()
 
 testCanHaveTalkPage (Title $title, $expected)
 provideCanHaveTalkPage Title::canHaveTalkPage
 
 testConvertByteClassToUnicodeClass ( $byteClass, $unicodeClass)
 provideConvertByteClassToUnicodeClass Title::convertByteClassToUnicodeClass
 
 testCreateFragmentTitle (Title $title, $fragment)
 Title::createFragmentTarget provideCreateFragmentTitle.
 
 testEquals (Title $firstValue, $secondValue, $expectedSame)
 Title::equals provideEquals.
 
 testExists ()
 Title::exists.
 
 testFixSpecialNameRetainsParameter ( $text, $expectedParam)
 provideSpecialNamesWithAndWithoutParameter Title::fixSpecialName
 
 testGetBaseText ( $title, $expected, $msg='')
 provideBaseTitleCases Title::getBaseText
 
 testGetFragment ( $full, $fragment)
 Title::getFragment provideGetFragment.
 
 testGetFragmentForURL ( $titleStr, $expected)
 Title::getFragmentForURL provideGetFragmentForURL.
 
 testGetPageViewLanguage ( $expected, $titleText, $contLang, $lang, $variant, $msg='')
 provideGetPageViewLanguage Title::getPageViewLanguage
 
 testGetPrefixedDBKey (Title $title, $expected)
 Title::getPrefixedDBKey provideGetPrefixedDBKey.
 
 testGetPrefixedText (Title $title, $expected)
 Title::getPrefixedText provideGetPrefixedText.
 
 testGetRootText ( $title, $expected, $msg='')
 provideRootTitleCases Title::getRootText
 
 testGetSubpageText ( $title, $expected, $msg='')
 
 testGetTalkPage_good (Title $title, Title $expected)
 provideGetTalkPage_good Title::getTalkPage
 
 testGetTalkPageIfDefined_bad (Title $title)
 provideGetTalkPage_bad Title::getTalkPageIfDefined
 
 testGetTalkPageIfDefined_good (Title $title)
 provideGetTalkPage_good Title::getTalkPageIfDefined
 
 testGetTitleValue ( $text)
 Title::getTitleValue provideGetTitleValue.
 
 testIsAlwaysKnown ( $page, $isKnown)
 Title::isAlwaysKnown provideIsAlwaysKnown.
 
 testIsAlwaysKnownOnInterwiki ()
 Title::isAlwaysKnown.
 
 testIsRawHtmlMessage ( $textForm, $expected)
 Title::isRawHtmlMessage provideIsRawHtmlMessage.
 
 testIsValid (Title $title, $isValid)
 Title::isValid provideIsValid.
 
 testIsValidMoveOperation ( $source, $target, $expected)
 Auth-less test of Title::isValidMoveOperation.
 
 testLegalChars ()
 Title::legalChars.
 
 testNewFromLinkTarget (LinkTarget $value)
 Title::newFromLinkTarget provideNewFromTitleValue.
 
 testNewFromLinkTarget_clone ()
 Title::newFromLinkTarget.
 
 testNewFromTitleValue (TitleValue $value)
 Title::newFromTitleValue provideNewFromTitleValue.
 
 testSecureAndSplitInvalid ( $text, $expectedErrorMessage)
 See also mediawiki.Title.test.js Title::secureAndSplit provideInvalidSecureAndSplit.
 
 testSecureAndSplitValid ( $text)
 See also mediawiki.Title.test.js Title::secureAndSplit provideValidSecureAndSplit.
 
 testWgWhitelistReadRegexp ( $whitelistRegexp, $source, $action, $expected)
 Auth-less test of Title::userCan.
 
- Public Member Functions inherited from MediaWikiTestCase
 __construct ( $name=null, array $data=[], $dataName='')
 
 __destruct ()
 
 addDBData ()
 Stub.
 
 addDBDataOnce ()
 Stub.
 
 copyTestData (IDatabase $source, IDatabase $target)
 Copy test data from one database connection to another.
 
 dbPrefix ()
 
 getCliArg ( $offset)
 
 hideDeprecated ( $function)
 Don't throw a warning if $function is deprecated and called later.
 
 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.
 
 setupAllTestDBs ()
 Set up all test DBs.
 
 setUserLang ( $lang)
 
 testMediaWikiTestCaseParentSetupCalled ()
 Make sure MediaWikiTestCase extending classes have called their parent setUp method.
 
 usesTemporaryTables ()
 

Static Public Member Functions

static provideBaseTitleCases ()
 
static provideConvertByteClassToUnicodeClass ()
 
static provideGetFragment ()
 
static provideGetPageViewLanguage ()
 
static provideGetTalkPage_bad ()
 
static provideGetTalkPage_good ()
 
static provideGetTitleValue ()
 
static provideInvalidSecureAndSplit ()
 
static provideIsAlwaysKnown ()
 
static provideIsValid ()
 
static provideNewFromTitleValue ()
 
static provideRootTitleCases ()
 
static provideSpecialNamesWithAndWithoutParameter ()
 
static provideSubpageTitleCases ()
 
static provideTestIsValidMoveOperation ()
 
static provideValidSecureAndSplit ()
 
- Static Public Member Functions inherited from MediaWikiTestCase
static getMutableTestUser ( $groups=[])
 Convenience method for getting a mutable test user.
 
static getTestPrefixFor (IDatabase $db)
 
static getTestSysop ()
 Convenience method for getting an immutable admin test user.
 
static getTestUser ( $groups=[])
 Convenience method for getting an immutable test user.
 
static installMockMwServices (Config $configOverrides=null)
 Creates a new "mock" MediaWikiServices instance, and installs it.
 
static listTables (IMaintainableDatabase $db)
 
static prepareServices (Config $bootstrapConfig)
 
static resetNonServiceCaches ()
 Resets some non-service singleton instances and other static caches.
 
static restoreMwServices ()
 Restores the original, non-mock MediaWikiServices instance.
 
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.
 
static teardownTestDB ()
 Restores MediaWiki to using the table set (table prefix) it was using before setupTestDB() was called.
 
static wfResetOutputBuffersBarrier ( $buffer)
 Used as a marker to prevent wfResetOutputBuffers from breaking PHPUnit.
 

Protected Member Functions

 setUp ()
 
- Protected Member Functions inherited from MediaWikiTestCase
 addCoreDBData ()
 
 addTmpFiles ( $files)
 
 arrayWrap (array $elements)
 Utility method taking an array of elements and wrapping each element in its own array.
 
 assertArrayEquals (array $expected, array $actual, $ordered=false, $named=false)
 Assert that two arrays are equal.
 
 assertFileContains ( $fileName, $actualData, $createIfMissing=false, $msg='')
 Check whether file contains given data.
 
 assertHTMLEquals ( $expected, $actual, $msg='')
 Put each HTML element on its own line and then equals() the results.
 
 assertSelect ( $table, $fields, $condition, array $expectedRows, array $options=[], array $join_conds=[])
 Asserts that the given database query yields the rows given by $expectedRows.
 
 assertType ( $type, $actual, $message='')
 Asserts the type of the provided value.
 
 assertTypeOrValue ( $type, $actual, $value=false, $message='')
 Asserts that the provided variable is of the specified internal type or equals the $value argument.
 
 checkDbIsSupported ()
 
 checkPHPExtension ( $extName)
 Check if $extName is a loaded PHP extension, will skip the test whenever it is not loaded.
 
 editPage ( $pageName, $text, $summary='', $defaultNs=NS_MAIN)
 Edits or creates a page/revision.
 
 ensureMockDatabaseConnection (IDatabase $db)
 
 getDefaultWikitextNS ()
 Returns the ID of a namespace that defaults to Wikitext.
 
 getExistingTestPage ( $title=null)
 Returns a WikiPage representing an existing page.
 
 getNewTempDirectory ()
 obtains a new temporary directory
 
 getNewTempFile ()
 Obtains a new temporary file name.
 
 getNonexistingTestPage ( $title=null)
 Returns a WikiPage representing a non-existing page.
 
 getSchemaOverrides (IMaintainableDatabase $db)
 Stub.
 
 insertPage ( $pageName, $text='Sample page for unit test.', $namespace=null, User $user=null)
 Insert a new page.
 
 isTestInDatabaseGroup ()
 
 isWikitextNS ( $ns)
 Returns true if the given namespace defaults to Wikitext according to $wgNamespaceContentModels.
 
 markTestSkippedIfDbType ( $type)
 Skip the test if using the specified database type.
 
 markTestSkippedIfNoDiff3 ()
 Check, if $wgDiff3 is set and ready to merge Will mark the calling test as skipped, if not ready.
 
 mergeMwGlobalArrayValue ( $name, $values)
 Merges the given values into a MW global array variable.
 
 objectAssociativeSort (array &$array)
 Does an associative sort that works for objects.
 
 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.
 
 revisionDelete ( $rev, array $value=[Revision::DELETED_TEXT=> 1], $comment='')
 Revision-deletes a revision.
 
 setIniSetting ( $name, $value)
 Set an ini setting for the duration of the test.
 
 setLogger ( $channel, LoggerInterface $logger)
 Sets the logger for a specified channel, for the duration of the test.
 
 setMwGlobals ( $pairs, $value=null)
 Sets a global, maintaining a stashed version of the previous global to be restored in tearDown.
 
 setService ( $name, $object)
 Sets a service, maintaining a stashed version of the previous service to be restored in tearDown.
 
 setTemporaryHook ( $hookName, $handler)
 Create a temporary hook handler which will be reset by tearDown.
 
 stashMwGlobals ( $globalKeys)
 Stashes the global, will be restored in tearDown()
 
 tearDown ()
 
 truncateTable ( $tableName, IDatabase $db=null)
 Empties the given table and resets any auto-increment counters.
 

Private Member Functions

 secureAndSplitGlobals ()
 

Additional Inherited Members

- Public Attributes inherited from MediaWikiTestCase
const DB_PREFIX = 'unittest_'
 Table name prefixes.
 
const ORA_DB_PREFIX = 'ut_'
 
- 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.
 
static isUsingExternalStoreDB ()
 Check whether ExternalStoreDB is being used.
 
static setupDatabaseWithTestPrefix (IMaintainableDatabase $db, $prefix=null)
 Setups a database with cloned tables using the given prefix.
 
static setupExternalStoreTestDBs ( $testPrefix=null)
 Clones the External Store database(s) for testing.
 
static stripStringKeys (&$r)
 Utility function for eliminating all string keys from an array.
 
- Protected Attributes inherited from MediaWikiTestCase
Database $db
 Primary database.
 
array $supportedDBs
 
array $tablesUsed = []
 

Detailed Description

Database Title.

Definition at line 10 of file TitleTest.php.

Member Function Documentation

◆ dataWgWhitelistReadRegexp()

TitleTest::dataWgWhitelistReadRegexp ( )

Provides test parameter values for testWgWhitelistReadRegexp()

Definition at line 377 of file TitleTest.php.

References and().

◆ flattenErrorsArray()

TitleTest::flattenErrorsArray ( $errors)

Definition at line 413 of file TitleTest.php.

References $result.

Referenced by testIsValidMoveOperation(), and testWgWhitelistReadRegexp().

◆ provideBaseTitleCases()

static TitleTest::provideBaseTitleCases ( )
static

Definition at line 498 of file TitleTest.php.

◆ provideCanHaveTalkPage()

TitleTest::provideCanHaveTalkPage ( )

Definition at line 729 of file TitleTest.php.

References false, NS_MEDIA, NS_SPECIAL, NS_TALK, and true.

◆ provideConvertByteClassToUnicodeClass()

static TitleTest::provideConvertByteClassToUnicodeClass ( )
static

Definition at line 188 of file TitleTest.php.

◆ provideCreateFragmentTitle()

TitleTest::provideCreateFragmentTitle ( )

Definition at line 810 of file TitleTest.php.

References NS_CATEGORY, NS_MAIN, and NS_TALK.

◆ provideEquals()

TitleTest::provideEquals ( )

Definition at line 1012 of file TitleTest.php.

References false, NS_MAIN, NS_TALK, and true.

◆ provideGetFragment()

static TitleTest::provideGetFragment ( )
static

Definition at line 616 of file TitleTest.php.

◆ provideGetFragmentForURL()

TitleTest::provideGetFragmentForURL ( )

Definition at line 975 of file TitleTest.php.

◆ provideGetPageViewLanguage()

static TitleTest::provideGetPageViewLanguage ( )
static

Definition at line 447 of file TitleTest.php.

References false.

◆ provideGetPrefixedDBKey()

TitleTest::provideGetPrefixedDBKey ( )

Definition at line 890 of file TitleTest.php.

References NS_MAIN, NS_MEDIA, and NS_USER_TALK.

◆ provideGetPrefixedText()

TitleTest::provideGetPrefixedText ( )

Definition at line 847 of file TitleTest.php.

References NS_MAIN, NS_MEDIA, and NS_USER_TALK.

◆ provideGetTalkPage_bad()

static TitleTest::provideGetTalkPage_bad ( )
static

Definition at line 791 of file TitleTest.php.

References NS_MEDIA, and NS_SPECIAL.

◆ provideGetTalkPage_good()

static TitleTest::provideGetTalkPage_good ( )
static

Definition at line 758 of file TitleTest.php.

References NS_MAIN, and NS_TALK.

◆ provideGetTitleValue()

static TitleTest::provideGetTitleValue ( )
static

Definition at line 594 of file TitleTest.php.

◆ provideInvalidSecureAndSplit()

static TitleTest::provideInvalidSecureAndSplit ( )
static

Definition at line 82 of file TitleTest.php.

References and().

◆ provideIsAlwaysKnown()

static TitleTest::provideIsAlwaysKnown ( )
static

Definition at line 657 of file TitleTest.php.

References false, and true.

◆ provideIsRawHtmlMessage()

TitleTest::provideIsRawHtmlMessage ( )

Definition at line 999 of file TitleTest.php.

References false, and true.

◆ provideIsValid()

static TitleTest::provideIsValid ( )
static

Definition at line 679 of file TitleTest.php.

References false, NS_MAIN, and true.

◆ provideNewFromTitleValue()

static TitleTest::provideNewFromTitleValue ( )
static

Definition at line 547 of file TitleTest.php.

References NS_MAIN.

◆ provideRootTitleCases()

static TitleTest::provideRootTitleCases ( )
static

Definition at line 518 of file TitleTest.php.

◆ provideSpecialNamesWithAndWithoutParameter()

static TitleTest::provideSpecialNamesWithAndWithoutParameter ( )
static

Definition at line 277 of file TitleTest.php.

References null.

◆ provideSubpageTitleCases()

static TitleTest::provideSubpageTitleCases ( )
static

Definition at line 539 of file TitleTest.php.

◆ provideTestIsValidMoveOperation()

static TitleTest::provideTestIsValidMoveOperation ( )
static

Definition at line 309 of file TitleTest.php.

◆ provideValidSecureAndSplit()

static TitleTest::provideValidSecureAndSplit ( )
static

Definition at line 45 of file TitleTest.php.

References and().

◆ secureAndSplitGlobals()

TitleTest::secureAndSplitGlobals ( )
private

◆ setUp()

TitleTest::setUp ( )
protected

◆ testCanHaveTalkPage()

TitleTest::testCanHaveTalkPage ( Title $title,
$expected )

provideCanHaveTalkPage Title::canHaveTalkPage

Parameters
Title$title
bool$expected

Definition at line 753 of file TitleTest.php.

References and().

◆ testConvertByteClassToUnicodeClass()

TitleTest::testConvertByteClassToUnicodeClass ( $byteClass,
$unicodeClass )

provideConvertByteClassToUnicodeClass Title::convertByteClassToUnicodeClass

Definition at line 253 of file TitleTest.php.

References and().

◆ testCreateFragmentTitle()

TitleTest::testCreateFragmentTitle ( Title $title,
$fragment )

Title::createFragmentTarget provideCreateFragmentTitle.

Definition at line 823 of file TitleTest.php.

References and(), Title\getInterwiki(), Title\getNamespace(), Title\getText(), and MediaWikiTestCase\mergeMwGlobalArrayValue().

◆ testEquals()

TitleTest::testEquals ( Title $firstValue,
$secondValue,
$expectedSame )

Title::equals provideEquals.

Definition at line 1094 of file TitleTest.php.

References and().

◆ testExists()

TitleTest::testExists ( )

Title::exists.

Definition at line 702 of file TitleTest.php.

References $article, and(), and NS_PROJECT.

◆ testFixSpecialNameRetainsParameter()

TitleTest::testFixSpecialNameRetainsParameter ( $text,
$expectedParam )

provideSpecialNamesWithAndWithoutParameter Title::fixSpecialName

Definition at line 261 of file TitleTest.php.

References and().

◆ testGetBaseText()

TitleTest::testGetBaseText ( $title,
$expected,
$msg = '' )

provideBaseTitleCases Title::getBaseText

Definition at line 490 of file TitleTest.php.

References and().

◆ testGetFragment()

TitleTest::testGetFragment ( $full,
$fragment )

Title::getFragment provideGetFragment.

Parameters
string$full
string$fragment

Definition at line 641 of file TitleTest.php.

References and().

◆ testGetFragmentForURL()

TitleTest::testGetFragmentForURL ( $titleStr,
$expected )

Title::getFragmentForURL provideGetFragmentForURL.

Parameters
string$titleStr
string$expected

Definition at line 940 of file TitleTest.php.

References and(), DB_MASTER, MediaWikiTestCase\setMwGlobals(), and wfGetDB().

◆ testGetPageViewLanguage()

TitleTest::testGetPageViewLanguage ( $expected,
$titleText,
$contLang,
$lang,
$variant,
$msg = '' )

provideGetPageViewLanguage Title::getPageViewLanguage

Definition at line 426 of file TitleTest.php.

References $lang, and(), MediaWikiTestCase\setContentLang(), MediaWikiTestCase\setMwGlobals(), and MediaWikiTestCase\setUserLang().

◆ testGetPrefixedDBKey()

TitleTest::testGetPrefixedDBKey ( Title $title,
$expected )

Title::getPrefixedDBKey provideGetPrefixedDBKey.

Definition at line 929 of file TitleTest.php.

References and().

◆ testGetPrefixedText()

TitleTest::testGetPrefixedText ( Title $title,
$expected )

Title::getPrefixedText provideGetPrefixedText.

Definition at line 886 of file TitleTest.php.

References and().

◆ testGetRootText()

TitleTest::testGetRootText ( $title,
$expected,
$msg = '' )

provideRootTitleCases Title::getRootText

Definition at line 510 of file TitleTest.php.

References and().

◆ testGetSubpageText()

TitleTest::testGetSubpageText ( $title,
$expected,
$msg = '' )
Todo
Handle $wgNamespacesWithSubpages cases provideSubpageTitleCases Title::getSubpageText

Definition at line 531 of file TitleTest.php.

References and().

◆ testGetTalkPage_good()

TitleTest::testGetTalkPage_good ( Title $title,
Title $expected )

provideGetTalkPage_good Title::getTalkPage

Definition at line 769 of file TitleTest.php.

References and().

◆ testGetTalkPageIfDefined_bad()

TitleTest::testGetTalkPageIfDefined_bad ( Title $title)

provideGetTalkPage_bad Title::getTalkPageIfDefined

Definition at line 802 of file TitleTest.php.

References and().

◆ testGetTalkPageIfDefined_good()

TitleTest::testGetTalkPageIfDefined_good ( Title $title)

provideGetTalkPage_good Title::getTalkPageIfDefined

Definition at line 782 of file TitleTest.php.

References and().

◆ testGetTitleValue()

TitleTest::testGetTitleValue ( $text)

Title::getTitleValue provideGetTitleValue.

Definition at line 606 of file TitleTest.php.

References $value, and and().

◆ testIsAlwaysKnown()

TitleTest::testIsAlwaysKnown ( $page,
$isKnown )

Title::isAlwaysKnown provideIsAlwaysKnown.

Parameters
string$page
bool$isKnown

Definition at line 652 of file TitleTest.php.

References and().

◆ testIsAlwaysKnownOnInterwiki()

TitleTest::testIsAlwaysKnownOnInterwiki ( )

Title::isAlwaysKnown.

Definition at line 694 of file TitleTest.php.

References and(), and NS_MAIN.

◆ testIsRawHtmlMessage()

TitleTest::testIsRawHtmlMessage ( $textForm,
$expected )

Title::isRawHtmlMessage provideIsRawHtmlMessage.

Definition at line 988 of file TitleTest.php.

References and(), and MediaWikiTestCase\setMwGlobals().

◆ testIsValid()

TitleTest::testIsValid ( Title $title,
$isValid )

Title::isValid provideIsValid.

Parameters
Title$title
bool$isValid

Definition at line 675 of file TitleTest.php.

References and().

◆ testIsValidMoveOperation()

TitleTest::testIsValidMoveOperation ( $source,
$target,
$expected )

Auth-less test of Title::isValidMoveOperation.

Parameters
string$source
string$target
array | string | bool$expectedRequired error provideTestIsValidMoveOperation Title::isValidMoveOperation

Definition at line 294 of file TitleTest.php.

References $source, and(), array(), flattenErrorsArray(), and MediaWikiTestCase\setMwGlobals().

◆ testLegalChars()

TitleTest::testLegalChars ( )

Title::legalChars.

Definition at line 26 of file TitleTest.php.

References and().

◆ testNewFromLinkTarget()

TitleTest::testNewFromLinkTarget ( LinkTarget $value)

Title::newFromLinkTarget provideNewFromTitleValue.

Definition at line 572 of file TitleTest.php.

References $value, and(), MediaWiki\Linker\LinkTarget\getFragment(), and MediaWiki\Linker\LinkTarget\getNamespace().

◆ testNewFromLinkTarget_clone()

TitleTest::testNewFromLinkTarget_clone ( )

Title::newFromLinkTarget.

Definition at line 584 of file TitleTest.php.

References and().

◆ testNewFromTitleValue()

TitleTest::testNewFromTitleValue ( TitleValue $value)

Title::newFromTitleValue provideNewFromTitleValue.

Definition at line 559 of file TitleTest.php.

References $value, and(), TitleValue\getFragment(), and TitleValue\getNamespace().

◆ testSecureAndSplitInvalid()

TitleTest::testSecureAndSplitInvalid ( $text,
$expectedErrorMessage )

See also mediawiki.Title.test.js Title::secureAndSplit provideInvalidSecureAndSplit.

Note
This mainly tests MediaWikiTitleCodec::parseTitle().

Definition at line 178 of file TitleTest.php.

References and(), and secureAndSplitGlobals().

◆ testSecureAndSplitValid()

TitleTest::testSecureAndSplitValid ( $text)

See also mediawiki.Title.test.js Title::secureAndSplit provideValidSecureAndSplit.

Note
This mainly tests MediaWikiTitleCodec::parseTitle().

Definition at line 167 of file TitleTest.php.

References and(), and secureAndSplitGlobals().

◆ testWgWhitelistReadRegexp()

TitleTest::testWgWhitelistReadRegexp ( $whitelistRegexp,
$source,
$action,
$expected )

Auth-less test of Title::userCan.

Parameters
array$whitelistRegexp
string$source
string$action
array | string | bool$expectedRequired error

\Mediawiki\Permissions\PermissionManager::checkReadPermissions dataWgWhitelistReadRegexp

Definition at line 333 of file TitleTest.php.

References $source, and(), array(), flattenErrorsArray(), and MediaWikiTestCase\setMwGlobals().


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