| Server IP : 167.235.224.122 / Your IP : 216.73.216.110 Web Server : Apache/2.4.58 (Ubuntu) System : Linux newplayground 6.8.0-136-generic #136-Ubuntu SMP PREEMPT_DYNAMIC Wed Jul 1 21:33:11 UTC 2026 aarch64 User : deploy ( 1000) PHP Version : 8.4.23 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : OFF Directory : /var/www/html/wiki/extensions/SemanticMediaWiki/tests/phpunit/ |
Upload File : |
<?php
namespace SMW\Tests;
use MediaWiki\Context\RequestContext;
use MediaWiki\Language\Language;
use MediaWiki\MediaWikiServices;
use MediaWiki\Request\FauxRequest;
use MediaWiki\Request\WebRequest;
use MediaWiki\Title\Title;
use ReflectionClass;
use SMW\DependencyContainer;
use SMW\DIWikiPage;
use SMW\Settings;
use SMW\SimpleDependencyBuilder;
use SMW\SQLStore\SQLStore;
use SMW\StoreFactory;
use SMW\Tests\Utils\Mock\CoreMockObjectRepository;
use SMW\Tests\Utils\Mock\MediaWikiMockObjectRepository;
use SMW\Tests\Utils\Mock\MockObjectBuilder;
use SMW\Tests\Utils\Mock\MockSuperUser;
/**
* @codeCoverageIgnore
*
* Class contains general purpose methods
*
*
* @group SMW
* @group SMWExtension
*
* @license GPL-2.0-or-later
* @since 1.9
*
* @author mwjames
*/
abstract class SemanticMediaWikiTestCase extends \PHPUnit\Framework\TestCase {
/**
* Returns the name of the deriving class being tested
*
* @since 1.9
*
* @return string
*/
abstract public function getClass();
/**
* Helper method that returns a MockObjectBuilder object
*
* @since 1.9
*
* @return MockObjectBuilder
*/
public function newMockBuilder() {
$builder = new MockObjectBuilder();
$builder->registerRepository( new CoreMockObjectRepository() );
$builder->registerRepository( new MediaWikiMockObjectRepository() );
return $builder;
}
/**
* Helper method that returns a SimpleDependencyBuilder object
*
* @since 1.9
*
* @param DependencyContainer|null $dependencyContainer
*
* @return SimpleDependencyBuilder
*/
public function newDependencyBuilder( ?DependencyContainer $dependencyContainer = null ) {
return new SimpleDependencyBuilder( $dependencyContainer );
}
/**
* Helper method that returns a ReflectionClass object
*
* @since 1.9
*
* @param string|null $class
*
* @return ReflectionClass
*/
public function newReflector( $class = null ) {
return new ReflectionClass( $class === null ? $this->getClass() : $class );
}
/**
* Helper method that returns a randomized Title object to avoid results
* are influenced by cross instantiated objects with the same title name
*
* @since 1.9
*
* @param $namespace
* @param null $text
*
* @return Title
*/
protected function newTitle( $namespace = NS_MAIN, $text = null ) {
return Title::newFromText( $text === null ? $this->newRandomString() : $text, $namespace );
}
/**
* Helper method that returns a User object
*
* @since 1.9
*
* @return User
*/
protected function getUser() {
return $this->newMockUser();
}
/**
* Helper method that returns a User object
*
* @since 1.9
*
* @return User
*/
protected function newMockUser() {
return new MockSuperUser();
}
/**
* Helper method that returns a Language object
*
* @since 1.9
*
* @return Language
*/
protected function getLanguage( $langCode = 'en' ) {
$languageFactory = MediaWikiServices::getInstance()->getLanguageFactory();
return $languageFactory->getLanguage( $langCode );
}
/**
* Returns RequestContext object
*
* @param array $request
*
* @return RequestContext
*/
protected function newContext( $request = [] ) {
$context = new RequestContext();
if ( $request instanceof WebRequest ) {
$context->setRequest( $request );
} else {
$context->setRequest( new FauxRequest( $request, true ) );
}
$context->setUser( new MockSuperUser() );
return $context;
}
/**
* Helper method that returns a randomized DIWikiPage object
*
* @since 1.9
*
* @param $namespace
*
* @return DIWikiPage
*/
protected function getSubject( $namespace = NS_MAIN ) {
return DIWikiPage::newFromTitle( $this->newTitle( $namespace ) );
}
/**
* Helper method that returns a DIWikiPage object
*
* @since 1.9
*
* @param Title|null $title
*
* @return DIWikiPage
*/
protected function newSubject( ?Title $title = null ) {
return DIWikiPage::newFromTitle( $title === null ? $this->newTitle() : $title );
}
/**
* Helper method that returns a Settings object
*
* @since 1.9
*
* @param array $settings
*
* @return Settings
*/
protected function newSettings( array $settings = [] ) {
return Settings::newFromArray( $settings );
}
/**
* Helper method that returns a random string
*
* @since 1.9
*
* @param $length
* @param null $prefix identify a specific random string during testing
*
* @return string
*/
protected function newRandomString( $length = 10, $prefix = null ) {
return $prefix . ( $prefix ? '-' : '' ) . substr( str_shuffle( "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ" ), 0, $length );
}
/**
* Helper method to skip the test if it is not a SQLStore
*
* @since 1.9
*/
protected function runOnlyOnSQLStore( $store = null ) {
if ( $store === null ) {
$store = StoreFactory::getStore();
}
if ( !( $store instanceof SQLStore ) ) {
$this->markTestSkipped( 'Test only applicable to SQLStore' );
}
}
protected function getStore() {
$store = StoreFactory::getStore();
if ( !( $store instanceof SQLStore ) ) {
$this->markTestSkipped( 'Test only applicable for SQLStore' );
}
return $store;
}
/**
* Utility method taking an array of elements and wrapping
* each element in it's own array. Useful for data providers
* that only return a single argument.
*
* @see MediaWikiTestCase::arrayWrap
*
* @since 1.9
*
* @param array $elements
*
* @return array
*/
protected function arrayWrap( array $elements ) {
return array_map(
static function ( $element ) {
return [ $element ];
},
$elements
);
}
}