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	/**
22	* @author Jean-Sébastien Conan <jean-sebastien.conan@vesperiagroup.com>
23	*/
24
25	namespace oat\taoTests\models\runner\time;
26
27	/**
28	* Interface ExtraTime
29	*
30	* Describes the API needed to manage extra time added to a timer.
31	*
32	* @package oat\taoTests\models\runner\time
33	*/
34	interface ExtraTime
35	{
36	/**
37	* Gets the added extra time
38	* @return float
39	*/
40	public function getExtraTime();
41
42	/**
43	* Sets the added extra time
44	* @param float $time
45	* @return ExtraTime
46	*/
47	public function setExtraTime($time);
48
49	/**
50	* Gets the amount of already consumed extra time. If tags are provided, only take care of the related time.
51	* @param string|array $tags A tag or a list of tags to filter
52	* @return float
53	*/
54	public function getConsumedExtraTime($tags = null);
55
56	/**
57	* Gets the amount of remaining extra time
58	* @return float
59	*/
60	public function getRemainingExtraTime();
61	}