Home       Trees       Indices       Help   
pulp
Package pulp :: Package messaging :: Module window :: Class Window
[hide private]
[frames] | no frames]

Class Window

source code

??-173 --+
         |
        Window

Represents a maintenance (time) window. An empty Window defines an unbounded window. A begin of 'None' = UTC now. An end of 'None' = begin plus 1 hour.

Instance Methods [hide private]
 
__init__(self, *D, **window) source code
bool
match(self)
Get whether the current datetime (UTC) falls within the window.		 source code
bool
future(self)
Get whether window is in the future.		 source code
bool
past(self)
Get whether window is in the past.		 source code
dict
__setbegin(self, window)
Set the proper window beginning.		 source code
dict
__setend(self, window)
Set the proper window ending.		 source code
bool
__hasduration(self, window)
Get whether one of the duration keywords are specified in the window definition.		 source code
(datetime, datetime)
__dates(self)
Convert to datetime objects.		 source code
 
__str__(self) source code
Class Variables [hide private]
str FORMAT = '%Y-%m-%dT%H:%M:%S'
The datetime format.
[str,..] DURATION = 'days', 'seconds', 'minutes', 'hours', 'weeks'
The duration keywords.
Method Details [hide private]

__init__(self, *D, **window)
(Constructor)

source code 
Parameters:
  • D ([dict,..]) - A (optional) dictionary.
  • window - The window specification:
    • begin

    One of:

    • end
    • days
    • seconds
    • minutes
    • hours
    • weeks

Note: An empty window indicates an unbounded window.

match(self)

source code 

Get whether the current datetime (UTC) falls within the window.

Returns: bool
True when matched.

Note: Empty = match ALL.

future(self)

source code 

Get whether window is in the future.

Returns: bool
True if begin > utcnow().

Note: Empty = match ALL.

past(self)

source code 

Get whether window is in the past.

Returns: bool
True if utcnow() > end.

Note: Empty = match ALL.

__setbegin(self, window)

source code 

Set the proper window beginning. Performs:

  • Convert to string if dt object.
  • Default to UTC (now) when value is (None).
Parameters:
  • window (dict) - The window specification.
Returns: dict
The updated window.

__setend(self, window)

source code 

Set the proper window ending. Performs:

  • Convert to string if dt object.
  • Default begin plus 1 hour when value is (None).
Parameters:
  • window (dict) - The window specification.
Returns: dict
The updated window.

__hasduration(self, window)

source code 

Get whether one of the duration keywords are specified in the window definition.

Parameters:
  • window (dict) - The window specification.
Returns: bool
True if found.

__dates(self)

source code 

Convert to datetime objects.

Returns: (datetime, datetime)
(begin, end)

Class Variable Details [hide private]

FORMAT

The datetime format. ISO 8601
Type:
str
Value:
'%Y-%m-%dT%H:%M:%S'

   Home       Trees       Indices       Help   
pulp
Generated by Epydoc 3.0.1 on Tue Sep 7 12:30:32 2010 http://epydoc.sourceforge.net