gcloud 0.0.2 → 0.0.4

data/packages/gcutil-1.7.1/lib/google_apputils/google/apputils/datelib.py

@@ -0,0 +1,421 @@
+#!/usr/bin/env python
+# Copyright 2002 Google 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.
+
+"""Set of classes and functions for dealing with dates and timestamps.
+
+The BaseTimestamp and Timestamp are timezone-aware wrappers around Python
+datetime.datetime class.
+"""
+
+
+
+import calendar
+import copy
+import datetime
+import re
+import sys
+import time
+import types
+
+from dateutil import parser
+import pytz
+
+
+_MICROSECONDS_PER_SECOND = 1000000
+_MICROSECONDS_PER_SECOND_F = float(_MICROSECONDS_PER_SECOND)
+
+
+def SecondsToMicroseconds(seconds):
+  """Convert seconds to microseconds.
+
+  Args:
+    seconds: number
+  Returns:
+    microseconds
+  """
+  return seconds * _MICROSECONDS_PER_SECOND
+
+
+def _GetCurrentTimeMicros():
+  """Get the current time in microseconds, in UTC.
+
+  Returns:
+    The number of microseconds since the epoch.
+  """
+  return int(SecondsToMicroseconds(time.time()))
+
+
+def GetSecondsSinceEpoch(time_tuple):
+  """Convert time_tuple (in UTC) to seconds (also in UTC).
+
+  Args:
+    time_tuple: tuple with at least 6 items.
+  Returns:
+    seconds.
+  """
+  return calendar.timegm(time_tuple[:6] + (0, 0, 0))
+
+
+def GetTimeMicros(time_tuple):
+  """Get a time in microseconds.
+
+  Arguments:
+    time_tuple: A (year, month, day, hour, minute, second) tuple (the python
+      time tuple format) in the UTC time zone.
+
+  Returns:
+    The number of microseconds since the epoch represented by the input tuple.
+  """
+  return int(SecondsToMicroseconds(GetSecondsSinceEpoch(time_tuple)))
+
+
+UTC = pytz.UTC
+US_PACIFIC = pytz.timezone('US/Pacific')
+
+
+class TimestampError(ValueError):
+  """Generic timestamp-related error."""
+  pass
+
+
+class TimezoneNotSpecifiedError(TimestampError):
+  """This error is raised when timezone is not specified."""
+  pass
+
+
+class TimeParseError(TimestampError):
+  """This error is raised when we can't parse the input."""
+  pass
+
+
+# TODO(user): this class needs to handle daylight better
+
+
+class LocalTimezoneClass(datetime.tzinfo):
+  """This class defines local timezone."""
+
+  ZERO = datetime.timedelta(0)
+  HOUR = datetime.timedelta(hours=1)
+
+  STDOFFSET = datetime.timedelta(seconds=-time.timezone)
+  if time.daylight:
+    DSTOFFSET = datetime.timedelta(seconds=-time.altzone)
+  else:
+    DSTOFFSET = STDOFFSET
+
+  DSTDIFF = DSTOFFSET - STDOFFSET
+
+  def utcoffset(self, dt):
+    """datetime -> minutes east of UTC (negative for west of UTC)."""
+    if self._isdst(dt):
+      return self.DSTOFFSET
+    else:
+      return self.STDOFFSET
+
+  def dst(self, dt):
+    """datetime -> DST offset in minutes east of UTC."""
+    if self._isdst(dt):
+      return self.DSTDIFF
+    else:
+      return self.ZERO
+
+  def tzname(self, dt):
+    """datetime -> string name of time zone."""
+    return time.tzname[self._isdst(dt)]
+
+  def _isdst(self, dt):
+    """Return true if given datetime is within local DST."""
+    tt = (dt.year, dt.month, dt.day, dt.hour, dt.minute, dt.second,
+          dt.weekday(), 0, -1)
+    stamp = time.mktime(tt)
+    tt = time.localtime(stamp)
+    return tt.tm_isdst > 0
+
+  def __repr__(self):
+    """Return string '<Local>'."""
+    return '<Local>'
+
+  def localize(self, dt, unused_is_dst=False):
+    """Convert naive time to local time."""
+    if dt.tzinfo is not None:
+      raise ValueError('Not naive datetime (tzinfo is already set)')
+    return dt.replace(tzinfo=self)
+
+  def normalize(self, dt, unused_is_dst=False):
+    """Correct the timezone information on the given datetime."""
+    if dt.tzinfo is None:
+      raise ValueError('Naive time - no tzinfo set')
+    return dt.replace(tzinfo=self)
+
+
+LocalTimezone = LocalTimezoneClass()
+
+
+class BaseTimestamp(datetime.datetime):
+  """Our kind of wrapper over datetime.datetime.
+
+  The objects produced by methods now, today, fromtimestamp, utcnow,
+  utcfromtimestamp are timezone-aware (with correct timezone).
+  We also overload __add__ and __sub__ method, to fix the result of arithmetic
+  operations.
+  """
+
+  LocalTimezone = LocalTimezone
+
+  @classmethod
+  def AddLocalTimezone(cls, obj):
+    """If obj is naive, add local timezone to it."""
+    if not obj.tzinfo:
+      return obj.replace(tzinfo=cls.LocalTimezone)
+    return obj
+
+  @classmethod
+  def Localize(cls, obj):
+    """If obj is naive, localize it to cls.LocalTimezone."""
+    if not obj.tzinfo:
+      return cls.LocalTimezone.localize(obj)
+    return obj
+
+  def __add__(self, *args, **kwargs):
+    """x.__add__(y) <==> x+y."""
+    r = super(BaseTimestamp, self).__add__(*args, **kwargs)
+    return type(self)(r.year, r.month, r.day, r.hour, r.minute, r.second,
+                      r.microsecond, r.tzinfo)
+
+  def __sub__(self, *args, **kwargs):
+    """x.__add__(y) <==> x-y."""
+    r = super(BaseTimestamp, self).__sub__(*args, **kwargs)
+    if isinstance(r, datetime.datetime):
+      return type(self)(r.year, r.month, r.day, r.hour, r.minute, r.second,
+                        r.microsecond, r.tzinfo)
+    return r
+
+  @classmethod
+  def now(cls, *args, **kwargs):
+    """Get a timestamp corresponding to right now.
+
+    Args:
+      args: Positional arguments to pass to datetime.datetime.now().
+      kwargs: Keyword arguments to pass to datetime.datetime.now(). If tz is not
+              specified, local timezone is assumed.
+
+    Returns:
+      A new BaseTimestamp with tz's local day and time.
+    """
+    return cls.AddLocalTimezone(
+        super(BaseTimestamp, cls).now(*args, **kwargs))
+
+  @classmethod
+  def today(cls):
+    """Current BaseTimestamp.
+
+    Same as self.__class__.fromtimestamp(time.time()).
+    Returns:
+      New self.__class__.
+    """
+    return cls.AddLocalTimezone(super(BaseTimestamp, cls).today())
+
+  @classmethod
+  def fromtimestamp(cls, *args, **kwargs):
+    """Get a new localized timestamp from a POSIX timestamp.
+
+    Args:
+      args: Positional arguments to pass to datetime.datetime.fromtimestamp().
+      kwargs: Keyword arguments to pass to datetime.datetime.fromtimestamp().
+              If tz is not specified, local timezone is assumed.
+
+    Returns:
+      A new BaseTimestamp with tz's local day and time.
+    """
+    return cls.Localize(
+        super(BaseTimestamp, cls).fromtimestamp(*args, **kwargs))
+
+  @classmethod
+  def utcnow(cls):
+    """Return a new BaseTimestamp representing UTC day and time."""
+    return super(BaseTimestamp, cls).utcnow().replace(tzinfo=pytz.utc)
+
+  @classmethod
+  def utcfromtimestamp(cls, *args, **kwargs):
+    """timestamp -> UTC datetime from a POSIX timestamp (like time.time())."""
+    return super(BaseTimestamp, cls).utcfromtimestamp(
+        *args, **kwargs).replace(tzinfo=pytz.utc)
+
+  @classmethod
+  def strptime(cls, date_string, format, tz=None):
+    """Parse date_string according to format and construct BaseTimestamp.
+
+    Args:
+      date_string: string passed to time.strptime.
+      format: format string passed to time.strptime.
+      tz: if not specified, local timezone assumed.
+    Returns:
+      New BaseTimestamp.
+    """
+    if tz is None:
+      return cls.Localize(cls(*(time.strptime(date_string, format)[:6])))
+    return tz.localize(cls(*(time.strptime(date_string, format)[:6])))
+
+  def astimezone(self, *args, **kwargs):
+    """tz -> convert to time in new timezone tz."""
+    r = super(BaseTimestamp, self).astimezone(*args, **kwargs)
+    return type(self)(r.year, r.month, r.day, r.hour, r.minute, r.second,
+                      r.microsecond, r.tzinfo)
+
+  @classmethod
+  def FromMicroTimestamp(cls, ts):
+    """Create new Timestamp object from microsecond UTC timestamp value.
+
+    Args:
+      ts: integer microsecond UTC timestamp
+    Returns:
+      New cls()
+    """
+    return cls.utcfromtimestamp(ts/_MICROSECONDS_PER_SECOND_F)
+
+  def AsSecondsSinceEpoch(self):
+    """Return number of seconds since epoch (timestamp in seconds)."""
+    return GetSecondsSinceEpoch(self.utctimetuple())
+
+  def AsMicroTimestamp(self):
+    """Return microsecond timestamp constructed from this object."""
+    return (SecondsToMicroseconds(self.AsSecondsSinceEpoch()) +
+            self.microsecond)
+
+  @classmethod
+  def combine(cls, datepart, timepart, tz=None):
+    """Combine date and time into timestamp, timezone-aware.
+
+    Args:
+      datepart: datetime.date
+      timepart: datetime.time
+      tz: timezone or None
+    Returns:
+      timestamp object
+    """
+    result = super(BaseTimestamp, cls).combine(datepart, timepart)
+    if tz:
+      result = tz.localize(result)
+    return result
+
+
+# Conversions from interval suffixes to number of seconds.
+# (m => 60s, d => 86400s, etc)
+_INTERVAL_CONV_DICT = {'s': 1}
+_INTERVAL_CONV_DICT['m'] = 60 * _INTERVAL_CONV_DICT['s']
+_INTERVAL_CONV_DICT['h'] = 60 * _INTERVAL_CONV_DICT['m']
+_INTERVAL_CONV_DICT['d'] = 24 * _INTERVAL_CONV_DICT['h']
+_INTERVAL_CONV_DICT['D'] = _INTERVAL_CONV_DICT['d']
+_INTERVAL_CONV_DICT['w'] = 7 * _INTERVAL_CONV_DICT['d']
+_INTERVAL_CONV_DICT['W'] = _INTERVAL_CONV_DICT['w']
+_INTERVAL_CONV_DICT['M'] = 30 * _INTERVAL_CONV_DICT['d']
+_INTERVAL_CONV_DICT['Y'] = 365 * _INTERVAL_CONV_DICT['d']
+_INTERVAL_REGEXP = re.compile('^([0-9]+)([%s])?' % ''.join(_INTERVAL_CONV_DICT))
+
+
+def ConvertIntervalToSeconds(interval):
+  """Convert a formatted string representing an interval into seconds.
+
+  Args:
+    interval: String to interpret as an interval.  A basic interval looks like
+      "<number><suffix>".  Complex intervals consisting of a chain of basic
+      intervals are also allowed.
+
+  Returns:
+    An integer representing the number of seconds represented by the interval
+    string, or None if the interval string could not be decoded.
+  """
+  total = 0
+  while interval:
+    match = _INTERVAL_REGEXP.match(interval)
+    if not match:
+      return None
+
+    try:
+      num = int(match.group(1))
+    except ValueError:
+      return None
+
+    suffix = match.group(2)
+    if suffix:
+      multiplier = _INTERVAL_CONV_DICT.get(suffix)
+      if not multiplier:
+        return None
+      num *= multiplier
+
+    total += num
+    interval = interval[match.end(0):]
+  return total
+
+
+class Timestamp(BaseTimestamp):
+  """This subclass contains methods to parse W3C and interval date spec.
+
+  The interval date specification is in the form "1D", where "D" can be
+  "s"econds "m"inutes "h"ours "D"ays "W"eeks "M"onths "Y"ears.
+  """
+  INTERVAL_CONV_DICT = _INTERVAL_CONV_DICT
+  INTERVAL_REGEXP = _INTERVAL_REGEXP
+
+  @classmethod
+  def _StringToTime(cls, timestring, tz=None):
+    """Use dateutil.parser to convert string into timestamp.
+
+    dateutil.parser understands ISO8601 which is really handy.
+
+    Args:
+      timestring: string with datetime
+      tz: optional timezone, if timezone is omitted from timestring.
+    Returns:
+      New Timestamp.
+    """
+    r = parser.parse(timestring)
+    if not r.tzinfo:
+      r = (tz or cls.LocalTimezone).localize(r)
+    result = cls(r.year, r.month, r.day, r.hour, r.minute, r.second,
+                 r.microsecond, r.tzinfo)
+
+    return result
+
+  @classmethod
+  def _IntStringToInterval(cls, timestring):
+    """Parse interval date specification and create a timedelta object."""
+    return datetime.timedelta(seconds=ConvertIntervalToSeconds(timestring))
+
+  @classmethod
+  def FromString(cls, value, tz=None):
+    """Try to create a Timestamp from a string."""
+    val = cls._StringToTime(value, tz)
+    if val:
+      return val
+
+    val = cls._IntStringToInterval(value)
+    if val:
+      return cls.utcnow() - val
+
+    raise TimeParseError(value)
+
+
+# What's written below is a clear python bug. I mean, okay, I can apply
+# negative timezone to it and end result will be inconversible.
+
+MAXIMUM_PYTHON_TIMESTAMP = Timestamp(
+    9999, 12, 31, 23, 59, 59, 999999, UTC)
+
+# This is also a bug. It is called 32bit time_t. I hate it.
+# This is fixed in 2.5, btw.
+
+MAXIMUM_MICROSECOND_TIMESTAMP = 0x80000000 * _MICROSECONDS_PER_SECOND - 1
+MAXIMUM_MICROSECOND_TIMESTAMP_AS_TS = Timestamp(2038, 1, 19, 3, 14, 7, 999999)

data/packages/gcutil-1.7.1/lib/google_apputils/google/apputils/debug.py

@@ -0,0 +1,60 @@
+#!/usr/bin/env python
+# Copyright 2004 Google 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 this module to add a hook to call pdb on uncaught exceptions.
+
+To enable this, do the following in your top-level application:
+
+import google.apputils.debug
+
+and then in your main():
+
+google.apputils.debug.Init()
+
+Then run your program with --pdb.
+"""
+
+
+
+import sys
+
+import gflags as flags
+
+flags.DEFINE_boolean('pdb', 0, 'Drop into pdb on uncaught exceptions')
+
+old_excepthook = None
+
+
+def _DebugHandler(exc_class, value, tb):
+  if not flags.FLAGS.pdb or hasattr(sys, 'ps1') or not sys.stderr.isatty():
+    # we aren't in interactive mode or we don't have a tty-like
+    # device, so we call the default hook
+    old_excepthook(exc_class, value, tb)
+  else:
+    # Don't impose import overhead on apps that never raise an exception.
+    import traceback
+    import pdb
+    # we are in interactive mode, print the exception...
+    traceback.print_exception(exc_class, value, tb)
+    print
+    # ...then start the debugger in post-mortem mode.
+    pdb.pm()
+
+
+def Init():
+  # Must back up old excepthook.
+  global old_excepthook  # pylint: disable-msg=W0603
+  old_excepthook = sys.excepthook
+  sys.excepthook = _DebugHandler