def contains( self, a_datetime ):
"""Return True iff the interval includes the microsecond represented by a_datetime
Raises a ValueError when a_datetime is in the future and
is_ongoing is true.
"""
if LocalTimezone.in_future(a_datetime):
raise ValueError(
"It is unknown whether the ongoing interval {} contains "
"the datetime object {} because it is in the future."
.format(str(self), str(a_datetime))
)
return self.first <= a_datetime
def intersection_with( self, a_TimeInterval ):
"""Returns an interval representing the times that are in both this interval and a_TimeInterval
Note: this is fragile and depends on knowing what all the
subclasses of TimeInterval are (see my note on this method
in the TimeInterval docstring)
Raises a ValueError when this time interval contains instants
in the future and a_TimeInterval is ongoing (since you don't
know when the ongoing interval will stop.)
"""
# Detect if someone has implemented a subclass not known at
# the time of this writing and tried to find the
# intersection. Fail so this will be caught in testing.
assert(isinstance(
a_TimeInterval,
(EmptyTimeInterval, BoundedTimeInterval, OngoingTimeInterval)))
if a_TimeInterval.is_ongoing():
if LocalTimezone.in_future(self.last):
raise ValueError(
"Cannot determine the intersection between {} and {} "
"because the first includes the future and the second is "
"ongoing, so we don't know when it will stop.".format(
self, a_TimeInterval))
else:
# Here I assume that all objects with is_ongoing true
# have a first member
return (intersection_with(
self, BoundedTimeInterval(
a_TimeInterval.first, LocalTimezone.now()
)))
elif hasattr(a_TimeInterval, 'first'): #Assume BoundedTimeInterval
if ( # The two intervals overlap
a_TimeInterval.first <= self.last and
self.first <= a_TimeInterval.last):
return BoundedTimeInterval(
max(self.first, a_TimeInterval.first),
min(self.last, a_TimeInterval.last))
else:
return EmptyTimeInterval()
else: # We can assume EmptyTimeInterval due to the assert at the
# beginning of the method
return EmptyTimeInterval()
def __new__(cls, first):
"""Set the cooresponding members to the provided values
(See class docstring for member description)
"""
if first is None:
raise ValueError("The starting time of a fogbugz "
"OngoingTimeInterval must be defined.")
if tzutil.is_naive(first):
raise ValueError("Starting time of a fogbugz "
"OngoingTimeInterval must be timezone aware")
if LocalTimezone.in_future(first):
raise ValueError(
"The starting time of a fogbugz OngoingTimeInterval must not "
"be in the future. ({})".format(str(first)))
return cls.__bases__[0].__new__(cls, copy.copy(first))
