89c6c7435b
In order to avoid naming conflicts which can easily occur if we name our time module as a python builtin just pick a name that doesn't conflict (it still retains the same meaning). Change-Id: Ia19f3776689d2b1f31f7cbfaa15e53f99a3ee900
70 lines
2.2 KiB
Python
70 lines
2.2 KiB
Python
# -*- coding: utf-8 -*-
|
|
|
|
# Copyright (C) 2014 Yahoo! Inc. All Rights Reserved.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
# not use this file except in compliance with the License. You may obtain
|
|
# a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
# License for the specific language governing permissions and limitations
|
|
# under the License.
|
|
|
|
import threading
|
|
|
|
from taskflow.types import timing as tt
|
|
|
|
|
|
class Latch(object):
|
|
"""A class that ensures N-arrivals occur before unblocking."""
|
|
|
|
def __init__(self, count):
|
|
count = int(count)
|
|
if count <= 0:
|
|
raise ValueError("Count must be greater than zero")
|
|
self._count = count
|
|
self._cond = threading.Condition()
|
|
|
|
@property
|
|
def needed(self):
|
|
"""Returns how many decrements are needed before latch is released."""
|
|
return max(0, self._count)
|
|
|
|
def countdown(self):
|
|
"""Decrements the internal counter due to an arrival."""
|
|
self._cond.acquire()
|
|
try:
|
|
self._count -= 1
|
|
if self._count <= 0:
|
|
self._cond.notify_all()
|
|
finally:
|
|
self._cond.release()
|
|
|
|
def wait(self, timeout=None):
|
|
"""Waits until the latch is released.
|
|
|
|
NOTE(harlowja): if a timeout is provided this function will wait
|
|
until that timeout expires, if the latch has been released before the
|
|
timeout expires then this will return True, otherwise it will
|
|
return False.
|
|
"""
|
|
w = None
|
|
if timeout is not None:
|
|
w = tt.StopWatch(timeout).start()
|
|
self._cond.acquire()
|
|
try:
|
|
while self._count > 0:
|
|
if w is not None:
|
|
if w.expired():
|
|
return False
|
|
else:
|
|
timeout = w.leftover()
|
|
self._cond.wait(timeout)
|
|
return True
|
|
finally:
|
|
self._cond.release()
|