3 use Wikimedia\Rdbms\DatabaseDomain
;
6 * @covers Wikimedia\Rdbms\DatabaseDomain
8 class DatabaseDomainTest
extends PHPUnit\Framework\TestCase
{
10 use MediaWikiCoversValidator
;
11 use PHPUnit4And6Compat
;
13 public static function provideConstruct() {
16 [ 'foo', 'bar', 'baz_', 'foo-bar-baz_' ],
18 [ null, null, '', '' ],
19 'Invalid $database' =>
20 [ 0, 'bar', '', '', true ],
22 [ 'foo', 0, '', '', true ],
24 [ 'foo', 'bar', 0, '', true ],
26 [ 'foo-bar', 'baz', 'baa_', 'foo?hbar-baz-baa_' ],
28 [ 'foo?bar', 'baz', 'baa_', 'foo??bar-baz-baa_' ],
33 * @dataProvider provideConstruct
35 public function testConstruct( $db, $schema, $prefix, $id, $exception = false ) {
37 $this->setExpectedException( InvalidArgumentException
::class );
38 new DatabaseDomain( $db, $schema, $prefix );
42 $domain = new DatabaseDomain( $db, $schema, $prefix );
43 $this->assertInstanceOf( DatabaseDomain
::class, $domain );
44 $this->assertEquals( $db, $domain->getDatabase() );
45 $this->assertEquals( $schema, $domain->getSchema() );
46 $this->assertEquals( $prefix, $domain->getTablePrefix() );
47 $this->assertEquals( $id, $domain->getId() );
48 $this->assertEquals( $id, strval( $domain ), 'toString' );
51 public static function provideNewFromId() {
54 [ 'foo', 'foo', null, '' ],
56 [ 'foo-bar_', 'foo', null, 'bar_' ],
58 [ 'foo-bar-baz_', 'foo', 'bar', 'baz_' ],
60 [ 'foo?hbar-baz-baa_', 'foo-bar', 'baz', 'baa_' ],
62 [ 'foo??bar-baz-baa_', 'foo?bar', 'baz', 'baa_' ],
64 [ 'foo?bar-baz-baa_', 'foo?bar', 'baz', 'baa_' ],
66 [ 'foo-bar-baz-baa_', '', '', '', true ],
68 [ DatabaseDomain
::newUnspecified(), null, null, '' ],
73 * @dataProvider provideNewFromId
75 public function testNewFromId( $id, $db, $schema, $prefix, $exception = false ) {
77 $this->setExpectedException( InvalidArgumentException
::class );
78 DatabaseDomain
::newFromId( $id );
81 $domain = DatabaseDomain
::newFromId( $id );
82 $this->assertInstanceOf( DatabaseDomain
::class, $domain );
83 $this->assertEquals( $db, $domain->getDatabase() );
84 $this->assertEquals( $schema, $domain->getSchema() );
85 $this->assertEquals( $prefix, $domain->getTablePrefix() );
88 public static function provideEquals() {
91 [ 'foo', 'foo', null, '' ],
93 [ 'foo-bar_', 'foo', null, 'bar_' ],
95 [ 'foo-bar-baz_', 'foo', 'bar', 'baz_' ],
97 [ 'foo?hbar-baz-baa_', 'foo-bar', 'baz', 'baa_' ],
99 [ 'foo??bar-baz-baa_', 'foo?bar', 'baz', 'baa_' ],
101 [ '', null, null, '' ],
106 * @dataProvider provideEquals
107 * @covers Wikimedia\Rdbms\DatabaseDomain::equals
109 public function testEquals( $id, $db, $schema, $prefix ) {
110 $fromId = DatabaseDomain
::newFromId( $id );
111 $this->assertInstanceOf( DatabaseDomain
::class, $fromId );
113 $constructed = new DatabaseDomain( $db, $schema, $prefix );
115 $this->assertTrue( $constructed->equals( $id ), 'constructed equals string' );
116 $this->assertTrue( $fromId->equals( $id ), 'fromId equals string' );
118 $this->assertTrue( $constructed->equals( $fromId ), 'compare constructed to newId' );
119 $this->assertTrue( $fromId->equals( $constructed ), 'compare newId to constructed' );
123 * @covers Wikimedia\Rdbms\DatabaseDomain::newUnspecified
125 public function testNewUnspecified() {
126 $domain = DatabaseDomain
::newUnspecified();
127 $this->assertInstanceOf( DatabaseDomain
::class, $domain );
128 $this->assertTrue( $domain->equals( '' ) );
129 $this->assertSame( null, $domain->getDatabase() );
130 $this->assertSame( null, $domain->getSchema() );
131 $this->assertSame( '', $domain->getTablePrefix() );
134 public static function provideIsCompatible() {
137 [ 'foo', 'foo', null, '', true ],
139 [ 'foo-bar_', 'foo', null, 'bar_', true ],
140 'db+schema+prefix' =>
141 [ 'foo-bar-baz_', 'foo', 'bar', 'baz_', true ],
142 'db+dontcare_schema+prefix' =>
143 [ 'foo-bar-baz_', 'foo', null, 'baz_', false ],
145 [ 'foo?hbar-baz-baa_', 'foo-bar', 'baz', 'baa_', true ],
147 [ 'foo??bar-baz-baa_', 'foo?bar', 'baz', 'baa_', true ],
149 [ '', null, null, '', true ],
150 'dontcaredb+dontcaredbschema+prefix' =>
151 [ 'mywiki-mediawiki-prefix_', null, null, 'prefix_', false ],
152 'dontcaredb+schema+prefix' =>
153 [ 'mywiki-schema-prefix_', null, 'schema', 'prefix_', false ],
154 'db+dontcareschema+prefix' =>
155 [ 'mywiki-schema-prefix_', 'mywiki', null, 'prefix_', false ],
156 'postgres-db-jobqueue' =>
157 [ 'postgres-mediawiki-', 'postgres', null, '', false ]
162 * @dataProvider provideIsCompatible
163 * @covers Wikimedia\Rdbms\DatabaseDomain::isCompatible
165 public function testIsCompatible( $id, $db, $schema, $prefix, $transitive ) {
166 $compareIdObj = DatabaseDomain
::newFromId( $id );
167 $this->assertInstanceOf( DatabaseDomain
::class, $compareIdObj );
169 $fromId = new DatabaseDomain( $db, $schema, $prefix );
171 $this->assertTrue( $fromId->isCompatible( $id ), 'constructed equals string' );
172 $this->assertTrue( $fromId->isCompatible( $compareIdObj ), 'fromId equals string' );
174 $this->assertEquals( $transitive, $compareIdObj->isCompatible( $fromId ),
175 'test transitivity of nulls components' );
178 public static function provideIsCompatible2() {
180 'db+schema+prefix' =>
181 [ 'mywiki-schema-prefix_', 'thatwiki', 'schema', 'prefix_' ],
182 'dontcaredb+dontcaredbschema+prefix' =>
183 [ 'thatwiki-mediawiki-otherprefix_', null, null, 'prefix_' ],
184 'dontcaredb+schema+prefix' =>
185 [ 'mywiki-otherschema-prefix_', null, 'schema', 'prefix_' ],
186 'db+dontcareschema+prefix' =>
187 [ 'notmywiki-schema-prefix_', 'mywiki', null, 'prefix_' ],
192 * @dataProvider provideIsCompatible2
193 * @covers Wikimedia\Rdbms\DatabaseDomain::isCompatible
195 public function testIsCompatible2( $id, $db, $schema, $prefix ) {
196 $compareIdObj = DatabaseDomain
::newFromId( $id );
197 $this->assertInstanceOf( DatabaseDomain
::class, $compareIdObj );
199 $fromId = new DatabaseDomain( $db, $schema, $prefix );
201 $this->assertFalse( $fromId->isCompatible( $id ), 'constructed equals string' );
202 $this->assertFalse( $fromId->isCompatible( $compareIdObj ), 'fromId equals string' );
206 * @covers Wikimedia\Rdbms\DatabaseDomain::isUnspecified
208 public function testIsUnspecified() {
209 $domain = new DatabaseDomain( null, null, '' );
210 $this->assertTrue( $domain->isUnspecified() );
211 $domain = new DatabaseDomain( 'mywiki', null, '' );
212 $this->assertFalse( $domain->isUnspecified() );
213 $domain = new DatabaseDomain( 'mywiki', null, '' );
214 $this->assertFalse( $domain->isUnspecified() );