MediaWiki  1.29.2
TitleMethodsTest.php
Go to the documentation of this file.
1 <?php
2 
10 class TitleMethodsTest extends MediaWikiLangTestCase {
11 
12  protected function setUp() {
13  global $wgContLang;
14 
15  parent::setUp();
16 
17  $this->mergeMwGlobalArrayValue(
18  'wgExtraNamespaces',
19  [
20  12302 => 'TEST-JS',
21  12303 => 'TEST-JS_TALK',
22  ]
23  );
24 
25  $this->mergeMwGlobalArrayValue(
26  'wgNamespaceContentModels',
27  [
28  12302 => CONTENT_MODEL_JAVASCRIPT,
29  ]
30  );
31 
32  MWNamespace::getCanonicalNamespaces( true ); # reset namespace cache
33  $wgContLang->resetNamespaces(); # reset namespace cache
34  }
35 
36  protected function tearDown() {
37  global $wgContLang;
38 
39  parent::tearDown();
40 
41  MWNamespace::getCanonicalNamespaces( true ); # reset namespace cache
42  $wgContLang->resetNamespaces(); # reset namespace cache
43  }
44 
45  public static function provideEquals() {
46  return [
47  [ 'Main Page', 'Main Page', true ],
48  [ 'Main Page', 'Not The Main Page', false ],
49  [ 'Main Page', 'Project:Main Page', false ],
50  [ 'File:Example.png', 'Image:Example.png', true ],
51  [ 'Special:Version', 'Special:Version', true ],
52  [ 'Special:Version', 'Special:Recentchanges', false ],
53  [ 'Special:Version', 'Main Page', false ],
54  ];
55  }
56 
61  public function testEquals( $titleA, $titleB, $expectedBool ) {
62  $titleA = Title::newFromText( $titleA );
63  $titleB = Title::newFromText( $titleB );
64 
65  $this->assertEquals( $expectedBool, $titleA->equals( $titleB ) );
66  $this->assertEquals( $expectedBool, $titleB->equals( $titleA ) );
67  }
68 
69  public static function provideInNamespace() {
70  return [
71  [ 'Main Page', NS_MAIN, true ],
72  [ 'Main Page', NS_TALK, false ],
73  [ 'Main Page', NS_USER, false ],
74  [ 'User:Foo', NS_USER, true ],
75  [ 'User:Foo', NS_USER_TALK, false ],
76  [ 'User:Foo', NS_TEMPLATE, false ],
77  [ 'User_talk:Foo', NS_USER_TALK, true ],
78  [ 'User_talk:Foo', NS_USER, false ],
79  ];
80  }
81 
86  public function testInNamespace( $title, $ns, $expectedBool ) {
87  $title = Title::newFromText( $title );
88  $this->assertEquals( $expectedBool, $title->inNamespace( $ns ) );
89  }
90 
94  public function testInNamespaces() {
95  $mainpage = Title::newFromText( 'Main Page' );
96  $this->assertTrue( $mainpage->inNamespaces( NS_MAIN, NS_USER ) );
97  $this->assertTrue( $mainpage->inNamespaces( [ NS_MAIN, NS_USER ] ) );
98  $this->assertTrue( $mainpage->inNamespaces( [ NS_USER, NS_MAIN ] ) );
99  $this->assertFalse( $mainpage->inNamespaces( [ NS_PROJECT, NS_TEMPLATE ] ) );
100  }
101 
102  public static function provideHasSubjectNamespace() {
103  return [
104  [ 'Main Page', NS_MAIN, true ],
105  [ 'Main Page', NS_TALK, true ],
106  [ 'Main Page', NS_USER, false ],
107  [ 'User:Foo', NS_USER, true ],
108  [ 'User:Foo', NS_USER_TALK, true ],
109  [ 'User:Foo', NS_TEMPLATE, false ],
110  [ 'User_talk:Foo', NS_USER_TALK, true ],
111  [ 'User_talk:Foo', NS_USER, true ],
112  ];
113  }
114 
119  public function testHasSubjectNamespace( $title, $ns, $expectedBool ) {
120  $title = Title::newFromText( $title );
121  $this->assertEquals( $expectedBool, $title->hasSubjectNamespace( $ns ) );
122  }
123 
124  public function dataGetContentModel() {
125  return [
126  [ 'Help:Foo', CONTENT_MODEL_WIKITEXT ],
127  [ 'Help:Foo.js', CONTENT_MODEL_WIKITEXT ],
128  [ 'Help:Foo/bar.js', CONTENT_MODEL_WIKITEXT ],
129  [ 'User:Foo', CONTENT_MODEL_WIKITEXT ],
130  [ 'User:Foo.js', CONTENT_MODEL_WIKITEXT ],
131  [ 'User:Foo/bar.js', CONTENT_MODEL_JAVASCRIPT ],
132  [ 'User:Foo/bar.css', CONTENT_MODEL_CSS ],
133  [ 'User talk:Foo/bar.css', CONTENT_MODEL_WIKITEXT ],
134  [ 'User:Foo/bar.js.xxx', CONTENT_MODEL_WIKITEXT ],
135  [ 'User:Foo/bar.xxx', CONTENT_MODEL_WIKITEXT ],
136  [ 'MediaWiki:Foo.js', CONTENT_MODEL_JAVASCRIPT ],
137  [ 'MediaWiki:Foo.css', CONTENT_MODEL_CSS ],
138  [ 'MediaWiki:Foo/bar.css', CONTENT_MODEL_CSS ],
139  [ 'MediaWiki:Foo.JS', CONTENT_MODEL_WIKITEXT ],
140  [ 'MediaWiki:Foo.CSS', CONTENT_MODEL_WIKITEXT ],
141  [ 'MediaWiki:Foo.css.xxx', CONTENT_MODEL_WIKITEXT ],
142  [ 'TEST-JS:Foo', CONTENT_MODEL_JAVASCRIPT ],
143  [ 'TEST-JS:Foo.js', CONTENT_MODEL_JAVASCRIPT ],
144  [ 'TEST-JS:Foo/bar.js', CONTENT_MODEL_JAVASCRIPT ],
145  [ 'TEST-JS_TALK:Foo.js', CONTENT_MODEL_WIKITEXT ],
146  ];
147  }
148 
153  public function testGetContentModel( $title, $expectedModelId ) {
154  $title = Title::newFromText( $title );
155  $this->assertEquals( $expectedModelId, $title->getContentModel() );
156  }
157 
162  public function testHasContentModel( $title, $expectedModelId ) {
163  $title = Title::newFromText( $title );
164  $this->assertTrue( $title->hasContentModel( $expectedModelId ) );
165  }
166 
167  public static function provideIsCssOrJsPage() {
168  return [
169  [ 'Help:Foo', false ],
170  [ 'Help:Foo.js', false ],
171  [ 'Help:Foo/bar.js', false ],
172  [ 'User:Foo', false ],
173  [ 'User:Foo.js', false ],
174  [ 'User:Foo/bar.js', false ],
175  [ 'User:Foo/bar.css', false ],
176  [ 'User talk:Foo/bar.css', false ],
177  [ 'User:Foo/bar.js.xxx', false ],
178  [ 'User:Foo/bar.xxx', false ],
179  [ 'MediaWiki:Foo.js', true ],
180  [ 'MediaWiki:Foo.css', true ],
181  [ 'MediaWiki:Foo.JS', false ],
182  [ 'MediaWiki:Foo.CSS', false ],
183  [ 'MediaWiki:Foo.css.xxx', false ],
184  [ 'TEST-JS:Foo', false ],
185  [ 'TEST-JS:Foo.js', false ],
186  ];
187  }
188 
193  public function testIsCssOrJsPage( $title, $expectedBool ) {
194  $title = Title::newFromText( $title );
195  $this->assertEquals( $expectedBool, $title->isCssOrJsPage() );
196  }
197 
198  public static function provideIsCssJsSubpage() {
199  return [
200  [ 'Help:Foo', false ],
201  [ 'Help:Foo.js', false ],
202  [ 'Help:Foo/bar.js', false ],
203  [ 'User:Foo', false ],
204  [ 'User:Foo.js', false ],
205  [ 'User:Foo/bar.js', true ],
206  [ 'User:Foo/bar.css', true ],
207  [ 'User talk:Foo/bar.css', false ],
208  [ 'User:Foo/bar.js.xxx', false ],
209  [ 'User:Foo/bar.xxx', false ],
210  [ 'MediaWiki:Foo.js', false ],
211  [ 'User:Foo/bar.JS', false ],
212  [ 'User:Foo/bar.CSS', false ],
213  [ 'TEST-JS:Foo', false ],
214  [ 'TEST-JS:Foo.js', false ],
215  ];
216  }
217 
222  public function testIsCssJsSubpage( $title, $expectedBool ) {
223  $title = Title::newFromText( $title );
224  $this->assertEquals( $expectedBool, $title->isCssJsSubpage() );
225  }
226 
227  public static function provideIsCssSubpage() {
228  return [
229  [ 'Help:Foo', false ],
230  [ 'Help:Foo.css', false ],
231  [ 'User:Foo', false ],
232  [ 'User:Foo.js', false ],
233  [ 'User:Foo.css', false ],
234  [ 'User:Foo/bar.js', false ],
235  [ 'User:Foo/bar.css', true ],
236  ];
237  }
238 
243  public function testIsCssSubpage( $title, $expectedBool ) {
244  $title = Title::newFromText( $title );
245  $this->assertEquals( $expectedBool, $title->isCssSubpage() );
246  }
247 
248  public static function provideIsJsSubpage() {
249  return [
250  [ 'Help:Foo', false ],
251  [ 'Help:Foo.css', false ],
252  [ 'User:Foo', false ],
253  [ 'User:Foo.js', false ],
254  [ 'User:Foo.css', false ],
255  [ 'User:Foo/bar.js', true ],
256  [ 'User:Foo/bar.css', false ],
257  ];
258  }
259 
264  public function testIsJsSubpage( $title, $expectedBool ) {
265  $title = Title::newFromText( $title );
266  $this->assertEquals( $expectedBool, $title->isJsSubpage() );
267  }
268 
269  public static function provideIsWikitextPage() {
270  return [
271  [ 'Help:Foo', true ],
272  [ 'Help:Foo.js', true ],
273  [ 'Help:Foo/bar.js', true ],
274  [ 'User:Foo', true ],
275  [ 'User:Foo.js', true ],
276  [ 'User:Foo/bar.js', false ],
277  [ 'User:Foo/bar.css', false ],
278  [ 'User talk:Foo/bar.css', true ],
279  [ 'User:Foo/bar.js.xxx', true ],
280  [ 'User:Foo/bar.xxx', true ],
281  [ 'MediaWiki:Foo.js', false ],
282  [ 'MediaWiki:Foo.css', false ],
283  [ 'MediaWiki:Foo/bar.css', false ],
284  [ 'User:Foo/bar.JS', true ],
285  [ 'User:Foo/bar.CSS', true ],
286  [ 'TEST-JS:Foo', false ],
287  [ 'TEST-JS:Foo.js', false ],
288  [ 'TEST-JS_TALK:Foo.js', true ],
289  ];
290  }
291 
296  public function testIsWikitextPage( $title, $expectedBool ) {
297  $title = Title::newFromText( $title );
298  $this->assertEquals( $expectedBool, $title->isWikitextPage() );
299  }
300 
301  public static function provideGetOtherPage() {
302  return [
303  [ 'Main Page', 'Talk:Main Page' ],
304  [ 'Talk:Main Page', 'Main Page' ],
305  [ 'Help:Main Page', 'Help talk:Main Page' ],
306  [ 'Help talk:Main Page', 'Help:Main Page' ],
307  [ 'Special:FooBar', null ],
308  ];
309  }
310 
318  public function testGetOtherPage( $text, $expected ) {
319  if ( $expected === null ) {
320  $this->setExpectedException( 'MWException' );
321  }
322 
323  $title = Title::newFromText( $text );
324  $this->assertEquals( $expected, $title->getOtherPage()->getPrefixedText() );
325  }
326 
327  public function testClearCaches() {
328  $linkCache = LinkCache::singleton();
329 
330  $title1 = Title::newFromText( 'Foo' );
331  $linkCache->addGoodLinkObj( 23, $title1 );
332 
333  Title::clearCaches();
334 
335  $title2 = Title::newFromText( 'Foo' );
336  $this->assertNotSame( $title1, $title2, 'title cache should be empty' );
337  $this->assertEquals( 0, $linkCache->getGoodLinkID( 'Foo' ), 'link cache should be empty' );
338  }
339 }
function
when a variable name is used in a function
Definition: design.txt:93
TitleMethodsTest\testHasSubjectNamespace
testHasSubjectNamespace( $title, $ns, $expectedBool)
provideHasSubjectNamespace Title::hasSubjectNamespace
Definition: TitleMethodsTest.php:119
TitleMethodsTest\testClearCaches
testClearCaches()
Definition: TitleMethodsTest.php:327
Title\newFromText
static newFromText( $text, $defaultNamespace=NS_MAIN)
Create a new Title from text, such as what one would find in a link.
Definition: Title.php:265
TitleMethodsTest\testEquals
testEquals( $titleA, $titleB, $expectedBool)
provideEquals Title::equals
Definition: TitleMethodsTest.php:61
TitleMethodsTest\provideGetOtherPage
static provideGetOtherPage()
Definition: TitleMethodsTest.php:301
false
processing should stop and the error should be shown to the user * false
Definition: hooks.txt:189
MediaWikiTestCase\mergeMwGlobalArrayValue
mergeMwGlobalArrayValue( $name, $values)
Merges the given values into a MW global array variable.
Definition: MediaWikiTestCase.php:766
TitleMethodsTest\provideIsCssSubpage
static provideIsCssSubpage()
Definition: TitleMethodsTest.php:227
TitleMethodsTest\provideIsCssJsSubpage
static provideIsCssJsSubpage()
Definition: TitleMethodsTest.php:198
TitleMethodsTest\testHasContentModel
testHasContentModel( $title, $expectedModelId)
dataGetContentModel Title::hasContentModel
Definition: TitleMethodsTest.php:162
Title\clearCaches
static clearCaches()
Text form (spaces not underscores) of the main part.
Definition: Title.php:3363
TitleMethodsTest\provideIsWikitextPage
static provideIsWikitextPage()
Definition: TitleMethodsTest.php:269
CONTENT_MODEL_CSS
const CONTENT_MODEL_CSS
Definition: Defines.php:235
NS_TEMPLATE
const NS_TEMPLATE
Definition: Defines.php:72
TitleMethodsTest\testInNamespaces
testInNamespaces()
Title::inNamespaces.
Definition: TitleMethodsTest.php:94
CONTENT_MODEL_WIKITEXT
const CONTENT_MODEL_WIKITEXT
Definition: Defines.php:233
TitleMethodsTest
ContentHandler Database.
Definition: TitleMethodsTest.php:10
cache
you have access to all of the normal MediaWiki so you can get a DB use the cache
Definition: maintenance.txt:52
TitleMethodsTest\testIsWikitextPage
testIsWikitextPage( $title, $expectedBool)
provideIsWikitextPage Title::isWikitextPage
Definition: TitleMethodsTest.php:296
php
injection txt This is an overview of how MediaWiki makes use of dependency injection The design described here grew from the discussion of RFC T384 The term dependency this means that anything an object needs to operate should be injected from the the object itself should only know narrow no concrete implementation of the logic it relies on The requirement to inject everything typically results in an architecture that based on two main types of and essentially stateless service objects that use other service objects to operate on the value objects As of the beginning MediaWiki is only starting to use the DI approach Much of the code still relies on global state or direct resulting in a highly cyclical dependency which acts as the top level factory for services in MediaWiki which can be used to gain access to default instances of various services MediaWikiServices however also allows new services to be defined and default services to be redefined Services are defined or redefined by providing a callback the instantiator that will return a new instance of the service When it will create an instance of MediaWikiServices and populate it with the services defined in the files listed by thereby bootstrapping the DI framework Per $wgServiceWiringFiles lists includes ServiceWiring php
Definition: injection.txt:35
NS_MAIN
const NS_MAIN
Definition: Defines.php:62
$title
namespace and then decline to actually register it file or subcat img or subcat $title
Definition: hooks.txt:934
NS_PROJECT
const NS_PROJECT
Definition: Defines.php:66
TitleMethodsTest\testGetOtherPage
testGetOtherPage( $text, $expected)
provideGetOtherpage Title::getOtherPage
Definition: TitleMethodsTest.php:318
TitleMethodsTest\testIsJsSubpage
testIsJsSubpage( $title, $expectedBool)
provideIsJsSubpage Title::isJsSubpage
Definition: TitleMethodsTest.php:264
global
when a variable name is used in a it is silently declared as a new masking the global
Definition: design.txt:93
TitleMethodsTest\testGetContentModel
testGetContentModel( $title, $expectedModelId)
dataGetContentModel Title::getContentModel
Definition: TitleMethodsTest.php:153
TitleMethodsTest\provideIsCssOrJsPage
static provideIsCssOrJsPage()
Definition: TitleMethodsTest.php:167
TitleMethodsTest\testIsCssSubpage
testIsCssSubpage( $title, $expectedBool)
provideIsCssSubpage Title::isCssSubpage
Definition: TitleMethodsTest.php:243
TitleMethodsTest\provideEquals
static provideEquals()
Definition: TitleMethodsTest.php:45
TitleMethodsTest\tearDown
tearDown()
Definition: TitleMethodsTest.php:36
NS_USER_TALK
const NS_USER_TALK
Definition: Defines.php:65
TitleMethodsTest\provideHasSubjectNamespace
static provideHasSubjectNamespace()
Definition: TitleMethodsTest.php:102
TitleMethodsTest\provideInNamespace
static provideInNamespace()
Definition: TitleMethodsTest.php:69
MediaWikiLangTestCase
Base class that store and restore the Language objects.
Definition: MediaWikiLangTestCase.php:6
TitleMethodsTest\dataGetContentModel
dataGetContentModel()
Definition: TitleMethodsTest.php:124
TitleMethodsTest\testIsCssOrJsPage
testIsCssOrJsPage( $title, $expectedBool)
provideIsCssOrJsPage Title::isCssOrJsPage
Definition: TitleMethodsTest.php:193
TitleMethodsTest\setUp
setUp()
Definition: TitleMethodsTest.php:12
LinkCache\singleton
static singleton()
Get an instance of this class.
Definition: LinkCache.php:67
MWNamespace\getCanonicalNamespaces
static getCanonicalNamespaces( $rebuild=false)
Returns array of all defined namespaces with their canonical (English) names.
Definition: MWNamespace.php:207
public
we sometimes make exceptions for this Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally NO WARRANTY BECAUSE THE PROGRAM IS LICENSED FREE OF THERE IS NO WARRANTY FOR THE TO THE EXTENT PERMITTED BY APPLICABLE LAW EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND OR OTHER PARTIES PROVIDE THE PROGRAM AS IS WITHOUT WARRANTY OF ANY EITHER EXPRESSED OR BUT NOT LIMITED THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU SHOULD THE PROGRAM PROVE YOU ASSUME THE COST OF ALL NECESSARY REPAIR OR CORRECTION IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT OR ANY OTHER PARTY WHO MAY MODIFY AND OR REDISTRIBUTE THE PROGRAM AS PERMITTED BE LIABLE TO YOU FOR INCLUDING ANY INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Programs If you develop a new and you want it to be of the greatest possible use to the public
Definition: COPYING.txt:284
NS_USER
const NS_USER
Definition: Defines.php:64
true
null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return true
Definition: hooks.txt:1956
NS_TALK
const NS_TALK
Definition: Defines.php:63
TitleMethodsTest\provideIsJsSubpage
static provideIsJsSubpage()
Definition: TitleMethodsTest.php:248
CONTENT_MODEL_JAVASCRIPT
const CONTENT_MODEL_JAVASCRIPT
Definition: Defines.php:234
TitleMethodsTest\testInNamespace
testInNamespace( $title, $ns, $expectedBool)
provideInNamespace Title::inNamespace
Definition: TitleMethodsTest.php:86
TitleMethodsTest\testIsCssJsSubpage
testIsCssJsSubpage( $title, $expectedBool)
provideIsCssJsSubpage Title::isCssJsSubpage
Definition: TitleMethodsTest.php:222
$wgContLang
this class mediates it Skin Encapsulates a look and feel for the wiki All of the functions that render HTML and make choices about how to render it are here and are called from various other places when and is meant to be subclassed with other skins that may override some of its functions The User object contains a reference to a and so rather than having a global skin object we just rely on the global User and get the skin with $wgUser and also has some character encoding functions and other locale stuff The current user interface language is instantiated as and the content language as $wgContLang
Definition: design.txt:56