Thijs/wiki.techinc.nl
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
wiki.techinc.nl/tests/phpunit/includes/api/query/ApiQueryContinueTest.php

314 lines
11 KiB
PHP
Raw Normal View History

API continue param to streamline iteration of complex queries Greatly simplifies query result iteration by the clients by providing a mechanism to track sub-iterations (props in generated set) Assuming the client has the param=>value dictionary with the original request parameters, client will only need to perform this operation in their language to get all results from the server regardless of what query they make. $request = array_merge( $request, $result['continue'] ); Related changes: * Moved dieContinueUsageIf() from ApiQueryBase to ApiBase * Internal calls will also return unused param warnings * Reworked query unit tests for easier testing Change-Id: Ieb45241fc6db2109f1d92fa3381165ec30701b63
2013-03-02 00:06:46 +00:00
<?php
/**
* Copyright © 2013 Yuri Astrakhan "<Firstname><Lastname>@gmail.com"
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
* http://www.gnu.org/copyleft/gpl.html
*/
require_once( 'ApiQueryContinueTestBase.php' );
/**
* These tests validate the new continue functionality of the api query module by
* doing multiple requests with varying parameters, merging the results, and checking
* that the result matches the full data received in one no-limits call.
*
* @group API
* @group Database
* @group medium
*/
class ApiQueryContinueTest extends ApiQueryContinueTestBase {
/**
* Create a set of pages. These must not change, otherwise the tests might give wrong results.
* @see MediaWikiTestCase::addDBData()
*/
function addDBData() {
try {
$this->editPage( 'Template:AQCT-T1', '**Template:AQCT-T1**' );
$this->editPage( 'Template:AQCT-T2', '**Template:AQCT-T2**' );
$this->editPage( 'Template:AQCT-T3', '**Template:AQCT-T3**' );
$this->editPage( 'Template:AQCT-T4', '**Template:AQCT-T4**' );
$this->editPage( 'Template:AQCT-T5', '**Template:AQCT-T5**' );
$this->editPage( 'AQCT-1', '**AQCT-1** {{AQCT-T2}} {{AQCT-T3}} {{AQCT-T4}} {{AQCT-T5}}' );
$this->editPage( 'AQCT-2', '[[AQCT-1]] **AQCT-2** {{AQCT-T3}} {{AQCT-T4}} {{AQCT-T5}}' );
$this->editPage( 'AQCT-3', '[[AQCT-1]] [[AQCT-2]] **AQCT-3** {{AQCT-T4}} {{AQCT-T5}}' );
$this->editPage( 'AQCT-4', '[[AQCT-1]] [[AQCT-2]] [[AQCT-3]] **AQCT-4** {{AQCT-T5}}' );
$this->editPage( 'AQCT-5', '[[AQCT-1]] [[AQCT-2]] [[AQCT-3]] [[AQCT-4]] **AQCT-5**' );
} catch ( Exception $e ) {
$this->exceptionFromAddDBData = $e;
}
}
/**
* Test smart continue - list=allpages
* @medium
*/
public function test1List() {
$this->mVerbose = false;
$mk = function( $l ) {
return array(
'list' => 'allpages',
'apprefix' => 'AQCT-',
'aplimit' => "$l",
);
};
$data = $this->query( $mk(99), 1, '1L', false );
// 1 list
$this->checkC( $data, $mk(1), 5, '1L-1' );
$this->checkC( $data, $mk(2), 3, '1L-2' );
$this->checkC( $data, $mk(3), 2, '1L-3' );
$this->checkC( $data, $mk(4), 2, '1L-4' );
$this->checkC( $data, $mk(5), 1, '1L-5' );
}
/**
* Test smart continue - list=allpages|alltransclusions
* @medium
*/
public function test2Lists() {
$this->mVerbose = false;
$mk = function( $l1, $l2 ) {
return array(
'list' => 'allpages|alltransclusions',
'apprefix' => 'AQCT-',
'atprefix' => 'AQCT-',
'atunique' => '',
'aplimit' => "$l1",
'atlimit' => "$l2",
);
};
// 2 lists
$data = $this->query( $mk(99,99), 1, '2L', false );
$this->checkC( $data, $mk(1,1), 5, '2L-11' );
$this->checkC( $data, $mk(2,2), 3, '2L-22' );
$this->checkC( $data, $mk(3,3), 2, '2L-33' );
$this->checkC( $data, $mk(4,4), 2, '2L-44' );
$this->checkC( $data, $mk(5,5), 1, '2L-55' );
}
/**
* Test smart continue - generator=allpages, prop=links
* @medium
*/
public function testGen1Prop() {
$this->mVerbose = false;
$mk = function( $g, $p ) {
return array(
'generator' => 'allpages',
'gapprefix' => 'AQCT-',
'gaplimit' => "$g",
'prop' => 'links',
'pllimit' => "$p",
);
};
// generator + 1 prop
$data = $this->query( $mk(99,99), 1, 'G1P', false );
$this->checkC( $data, $mk(1,1), 11, 'G1P-11' );
$this->checkC( $data, $mk(2,2), 6, 'G1P-22' );
$this->checkC( $data, $mk(3,3), 4, 'G1P-33' );
$this->checkC( $data, $mk(4,4), 3, 'G1P-44' );
$this->checkC( $data, $mk(5,5), 2, 'G1P-55' );
}
/**
* Test smart continue - generator=allpages, prop=links|templates
* @medium
*/
public function testGen2Prop() {
$this->mVerbose = false;
$mk = function( $g, $p1, $p2 ) {
return array(
'generator' => 'allpages',
'gapprefix' => 'AQCT-',
'gaplimit' => "$g",
'prop' => 'links|templates',
'pllimit' => "$p1",
'tllimit' => "$p2",
);
};
// generator + 2 props
$data = $this->query( $mk(99,99,99), 1, 'G2P', false );
$this->checkC( $data, $mk(1,1,1), 16, 'G2P-111' );
$this->checkC( $data, $mk(2,2,2), 9, 'G2P-222' );
$this->checkC( $data, $mk(3,3,3), 6, 'G2P-333' );
$this->checkC( $data, $mk(4,4,4), 4, 'G2P-444' );
$this->checkC( $data, $mk(5,5,5), 2, 'G2P-555' );
$this->checkC( $data, $mk(5,1,1), 10, 'G2P-511' );
$this->checkC( $data, $mk(4,2,2), 7, 'G2P-422' );
$this->checkC( $data, $mk(2,3,3), 7, 'G2P-233' );
$this->checkC( $data, $mk(2,4,4), 5, 'G2P-244' );
$this->checkC( $data, $mk(1,5,5), 5, 'G2P-155' );
}
/**
* Test smart continue - generator=allpages, prop=links, list=alltransclusions
* @medium
*/
public function testGen1Prop1List() {
$this->mVerbose = false;
$mk = function( $g, $p, $l ) {
return array(
'generator' => 'allpages',
'gapprefix' => 'AQCT-',
'gaplimit' => "$g",
'prop' => 'links',
'pllimit' => "$p",
'list' => 'alltransclusions',
'atprefix' => 'AQCT-',
'atunique' => '',
'atlimit' => "$l",
);
};
// generator + 1 prop + 1 list
$data = $this->query( $mk(99,99,99), 1, 'G1P1L', false );
$this->checkC( $data, $mk(1,1,1), 11, 'G1P1L-111' );
$this->checkC( $data, $mk(2,2,2), 6, 'G1P1L-222' );
$this->checkC( $data, $mk(3,3,3), 4, 'G1P1L-333' );
$this->checkC( $data, $mk(4,4,4), 3, 'G1P1L-444' );
$this->checkC( $data, $mk(5,5,5), 2, 'G1P1L-555' );
$this->checkC( $data, $mk(5,5,1), 4, 'G1P1L-551' );
$this->checkC( $data, $mk(5,5,2), 2, 'G1P1L-552' );
}
/**
* Test smart continue - generator=allpages, prop=links|templates,
* list=alllinks|alltransclusions, meta=siteinfo
* @medium
*/
public function testGen2Prop2List1Meta() {
$this->mVerbose = false;
$mk = function( $g, $p1, $p2, $l1, $l2 ) {
return array(
'generator' => 'allpages',
'gapprefix' => 'AQCT-',
'gaplimit' => "$g",
'prop' => 'links|templates',
'pllimit' => "$p1",
'tllimit' => "$p2",
'list' => 'alllinks|alltransclusions',
'alprefix' => 'AQCT-',
'alunique' => '',
'allimit' => "$l1",
'atprefix' => 'AQCT-',
'atunique' => '',
'atlimit' => "$l2",
'meta' => 'siteinfo',
'siprop' => 'namespaces',
);
};
// generator + 1 prop + 1 list
$data = $this->query( $mk(99,99,99,99,99), 1, 'G2P2L1M', false );
$this->checkC( $data, $mk(1,1,1,1,1), 16, 'G2P2L1M-11111' );
$this->checkC( $data, $mk(2,2,2,2,2), 9, 'G2P2L1M-22222' );
$this->checkC( $data, $mk(3,3,3,3,3), 6, 'G2P2L1M-33333' );
$this->checkC( $data, $mk(4,4,4,4,4), 4, 'G2P2L1M-44444' );
$this->checkC( $data, $mk(5,5,5,5,5), 2, 'G2P2L1M-55555' );
$this->checkC( $data, $mk(5,5,5,1,1), 4, 'G2P2L1M-55511' );
$this->checkC( $data, $mk(5,5,5,2,2), 2, 'G2P2L1M-55522' );
$this->checkC( $data, $mk(5,1,1,5,5), 10, 'G2P2L1M-51155' );
$this->checkC( $data, $mk(5,2,2,5,5), 5, 'G2P2L1M-52255' );
}
/**
* Test smart continue - generator=templates, prop=templates
* @medium
*/
public function testSameGenAndProp() {
$this->mVerbose = false;
$mk = function( $g, $gDir, $p, $pDir ) {
return array(
'titles' => 'AQCT-1',
'generator' => 'templates',
'gtllimit' => "$g",
'gtldir' => $gDir ? 'ascending' : 'descending',
'prop' => 'templates',
'tllimit' => "$p",
'tldir' => $pDir ? 'ascending' : 'descending',
);
};
// generator + 1 prop
$data = $this->query( $mk(99,true,99,true), 1, 'G=P', false );
$this->checkC( $data, $mk(1,true,1,true), 4, 'G=P-1t1t' );
$this->checkC( $data, $mk(2,true,2,true), 2, 'G=P-2t2t' );
$this->checkC( $data, $mk(3,true,3,true), 2, 'G=P-3t3t' );
$this->checkC( $data, $mk(1,true,3,true), 4, 'G=P-1t3t' );
$this->checkC( $data, $mk(3,true,1,true), 2, 'G=P-3t1t' );
$this->checkC( $data, $mk(1,true,1,false), 4, 'G=P-1t1f' );
$this->checkC( $data, $mk(2,true,2,false), 2, 'G=P-2t2f' );
$this->checkC( $data, $mk(3,true,3,false), 2, 'G=P-3t3f' );
$this->checkC( $data, $mk(1,true,3,false), 4, 'G=P-1t3f' );
$this->checkC( $data, $mk(3,true,1,false), 2, 'G=P-3t1f' );
$this->checkC( $data, $mk(1,false,1,true), 4, 'G=P-1f1t' );
$this->checkC( $data, $mk(2,false,2,true), 2, 'G=P-2f2t' );
$this->checkC( $data, $mk(3,false,3,true), 2, 'G=P-3f3t' );
$this->checkC( $data, $mk(1,false,3,true), 4, 'G=P-1f3t' );
$this->checkC( $data, $mk(3,false,1,true), 2, 'G=P-3f1t' );
$this->checkC( $data, $mk(1,false,1,false), 4, 'G=P-1f1f' );
$this->checkC( $data, $mk(2,false,2,false), 2, 'G=P-2f2f' );
$this->checkC( $data, $mk(3,false,3,false), 2, 'G=P-3f3f' );
$this->checkC( $data, $mk(1,false,3,false), 4, 'G=P-1f3f' );
$this->checkC( $data, $mk(3,false,1,false), 2, 'G=P-3f1f' );
}
/**
* Test smart continue - generator=allpages, list=allpages
* @medium
*/
public function testSameGenList() {
$this->mVerbose = false;
$mk = function( $g, $gDir, $l, $pDir ) {
return array(
'generator' => 'allpages',
'gapprefix' => 'AQCT-',
'gaplimit' => "$g",
'gapdir' => $gDir ? 'ascending' : 'descending',
'list' => 'allpages',
'apprefix' => 'AQCT-',
'aplimit' => "$l",
'apdir' => $pDir ? 'ascending' : 'descending',
);
};
// generator + 1 list
$data = $this->query( $mk(99,true,99,true), 1, 'G=L', false );
$this->checkC( $data, $mk(1,true,1,true), 5, 'G=L-1t1t' );
$this->checkC( $data, $mk(2,true,2,true), 3, 'G=L-2t2t' );
$this->checkC( $data, $mk(3,true,3,true), 2, 'G=L-3t3t' );
$this->checkC( $data, $mk(1,true,3,true), 5, 'G=L-1t3t' );
$this->checkC( $data, $mk(3,true,1,true), 5, 'G=L-3t1t' );
$this->checkC( $data, $mk(1,true,1,false), 5, 'G=L-1t1f' );
$this->checkC( $data, $mk(2,true,2,false), 3, 'G=L-2t2f' );
$this->checkC( $data, $mk(3,true,3,false), 2, 'G=L-3t3f' );
$this->checkC( $data, $mk(1,true,3,false), 5, 'G=L-1t3f' );
$this->checkC( $data, $mk(3,true,1,false), 5, 'G=L-3t1f' );
$this->checkC( $data, $mk(1,false,1,true), 5, 'G=L-1f1t' );
$this->checkC( $data, $mk(2,false,2,true), 3, 'G=L-2f2t' );
$this->checkC( $data, $mk(3,false,3,true), 2, 'G=L-3f3t' );
$this->checkC( $data, $mk(1,false,3,true), 5, 'G=L-1f3t' );
$this->checkC( $data, $mk(3,false,1,true), 5, 'G=L-3f1t' );
$this->checkC( $data, $mk(1,false,1,false), 5, 'G=L-1f1f' );
$this->checkC( $data, $mk(2,false,2,false), 3, 'G=L-2f2f' );
$this->checkC( $data, $mk(3,false,3,false), 2, 'G=L-3f3f' );
$this->checkC( $data, $mk(1,false,3,false), 5, 'G=L-1f3f' );
$this->checkC( $data, $mk(3,false,1,false), 5, 'G=L-3f1f' );
}
}
Reference in a new issue Copy permalink