1 # Copyright (c) 2012 The Chromium Authors. All rights reserved.
2 # Use of this source code is governed by a BSD-style license that can be
3 # found in the LICENSE file.
6 """A module that contains a queue for running sharded tests."""
11 class ShardedTestsQueue(object):
12 """A queue for managing pending tests across different runners.
14 This class should only be used when sharding.
17 num_devices: an integer; the number of attached Android devices.
18 tests: a list of tests to be run.
19 tests_queue: if sharding, a JoinableQueue object that holds tests from
20 |tests|. Otherwise, a list holding tests.
21 results_queue: a Queue object to hold TestResults objects.
23 _STOP_SENTINEL
= 'STOP' # sentinel value for iter()
25 def __init__(self
, num_devices
, tests
):
26 assert num_devices
> 1, 'At least two devices must be attached.'
27 self
.num_devices
= num_devices
28 self
.tests_queue
= multiprocessing
.Queue()
30 self
.tests_queue
.put(test
)
31 for _
in xrange(self
.num_devices
):
32 self
.tests_queue
.put(ShardedTestsQueue
._STOP
_SENTINEL
)
35 """Returns an iterator with the test cases."""
36 return iter(self
.tests_queue
.get
, ShardedTestsQueue
._STOP
_SENTINEL
)