1	<?php
2
3	/**
4	* This program is free software; you can redistribute it and/or
5	* modify it under the terms of the GNU General Public License
6	* as published by the Free Software Foundation; under version 2
7	* of the License (non-upgradable).
8	*
9	* This program is distributed in the hope that it will be useful,
10	* but WITHOUT ANY WARRANTY; without even the implied warranty of
11	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12	* GNU General Public License for more details.
13	*
14	* You should have received a copy of the GNU General Public License
15	* along with this program; if not, write to the Free Software
16	* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
17	*
18	* Copyright (c) 2016 (original work) Open Assessment Technologies SA ;
19	*/
20
21	namespace oat\taoQtiTest\models;
22
23	use qtism\runtime\tests\AssessmentTestSession;
24
25	/**
26	* @author Jean-Sébastien Conan <jean-sebastien.conan@vesperiagroup.com>
27	*/
28
29	/**
30	* Interface TestContextBuilder.
31	*
32	* Provides a way to extend the assessment test context.
33	*
34	* @package oat\taoQtiTest\models
35	*/
36	interface TestContextBuilder
37	{
38	/**
39	* Extends an already built context
40	*
41	* @param array $context A reference to the context to extend
42	* @param AssessmentTestSession $session A given AssessmentTestSession object.
43	* @param array $testMeta An associative array containing meta-data about the test definition taken by the
44	*                        candidate.
45	* @param string $qtiTestDefinitionUri The URI of a reference to an Assessment Test definition in the knowledge
46	*                                     base.
47	* @param string $qtiTestCompilationUri The Uri of a reference to an Assessment Test compilation in the knowledge
48	*                                      base.
49	* @param string $standalone
50	* @param array $compilationDirs An array containing respectively the private and public compilation directories.
51	* @return array The context of the candidate session.
52	*/
53	public function extendAssessmentTestContext(
54	array &$context,
55	AssessmentTestSession $session,
56	array $testMeta,
57	$qtiTestDefinitionUri,
58	$qtiTestCompilationUri,
59	$standalone,
60	$compilationDirs
61	);
62	}