Upgrade gsutil to 3.4

third_party/gsutil/boto/boto/ec2/cloudwatch/alarm.py

Index: third_party/gsutil/boto/boto/ec2/cloudwatch/alarm.py
diff --git a/third_party/gsutil/20110627/boto/boto/ec2/cloudwatch/alarm.py b/third_party/gsutil/boto/boto/ec2/cloudwatch/alarm.py
similarity index 57%
rename from third_party/gsutil/20110627/boto/boto/ec2/cloudwatch/alarm.py
rename to third_party/gsutil/boto/boto/ec2/cloudwatch/alarm.py
index 78d352ee637cb3eb8f5897e11f8ea2512128d51c..539ad9504ca5034fb15c300b946f292a62f23529 100644
--- a/third_party/gsutil/20110627/boto/boto/ec2/cloudwatch/alarm.py
+++ b/third_party/gsutil/boto/boto/ec2/cloudwatch/alarm.py
@@ -23,11 +23,30 @@
 from datetime import datetime
 from boto.resultset import ResultSet
 from boto.ec2.cloudwatch.listelement import ListElement
+from boto.ec2.cloudwatch.dimension import Dimension
 
 try:
-    import json
-except ImportError:
     import simplejson as json
+except ImportError:
+    import json
+
+
+class MetricAlarms(list):
+    def __init__(self, connection=None):
+        """
+        Parses a list of MetricAlarms.
+        """
+        list.__init__(self)
+        self.connection = connection
+
+    def startElement(self, name, attrs, connection):
+        if name == 'member':
+            metric_alarm = MetricAlarm(connection)
+            self.append(metric_alarm)
+            return metric_alarm
+
+    def endElement(self, name, value, connection):
+        pass
 
 
 class MetricAlarm(object):
@@ -45,9 +64,11 @@ class MetricAlarm(object):
     _rev_cmp_map = dict((v, k) for (k, v) in _cmp_map.iteritems())
 
     def __init__(self, connection=None, name=None, metric=None,
-                 namespace=None, statistic=None, comparison=None, threshold=None,
-                 period=None, evaluation_periods=None, unit=None, description='',
-                 dimensions=[]):
+                 namespace=None, statistic=None, comparison=None,
+                 threshold=None, period=None, evaluation_periods=None,
+                 unit=None, description='', dimensions=None,
+                 alarm_actions=None, insufficient_data_actions=None,
+                 ok_actions=None):
         """
         Creates a new Alarm.
 
@@ -61,66 +82,104 @@ class MetricAlarm(object):
         :param namespace: The namespace for the alarm's metric.
 
         :type statistic: str
-        :param statistic: The statistic to apply to the alarm's associated metric. Can
-                          be one of 'SampleCount', 'Average', 'Sum', 'Minimum', 'Maximum'
+        :param statistic: The statistic to apply to the alarm's associated
+                          metric.
+                          Valid values: SampleCount|Average|Sum|Minimum|Maximum
 
         :type comparison: str
-        :param comparison: Comparison used to compare statistic with threshold. Can be
-                           one of '>=', '>', '<', '<='
+        :param comparison: Comparison used to compare statistic with threshold.
+                           Valid values: >= | > | < | <=
 
         :type threshold: float
-        :param threshold: The value against which the specified statistic is compared.
+        :param threshold: The value against which the specified statistic
+                          is compared.
 
         :type period: int
-        :param period: The period in seconds over which teh specified statistic is applied.
+        :param period: The period in seconds over which teh specified
+                       statistic is applied.
 
         :type evaluation_periods: int
-        :param evaluation_period: The number of periods over which data is compared to
-                                  the specified threshold
+        :param evaluation_period: The number of periods over which data is
+                                  compared to the specified threshold.
 
         :type unit: str
-        :param unit: Allowed Values are: Seconds, Microseconds, Milliseconds, Bytes, 
-                     Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, 
-                     Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, 
-                     Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, 
-                     Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, 
-                     Count/Second, None
+        :param unit: Allowed Values are:
+                     Seconds|Microseconds|Milliseconds,
+                     Bytes|Kilobytes|Megabytes|Gigabytes|Terabytes,
+                     Bits|Kilobits|Megabits|Gigabits|Terabits,
+                     Percent|Count|
+                     Bytes/Second|Kilobytes/Second|Megabytes/Second|
+                     Gigabytes/Second|Terabytes/Second,
+                     Bits/Second|Kilobits/Second|Megabits/Second,
+                     Gigabits/Second|Terabits/Second|Count/Second|None
 
         :type description: str
         :param description: Description of MetricAlarm
 
-        :type dimensions list of dicts
+        :type dimensions: list of dicts
         :param description: Dimensions of alarm, such as:
-                            [{'InstanceId':'i-0123456,i-0123457'}]
+                            [{'InstanceId':['i-0123456,i-0123457']}]
+        
+        :type alarm_actions: list of strs
+        :param alarm_actions: A list of the ARNs of the actions to take in
+                              ALARM state
+        
+        :type insufficient_data_actions: list of strs
+        :param insufficient_data_actions: A list of the ARNs of the actions to
+                                          take in INSUFFICIENT_DATA state
+        
+        :type ok_actions: list of strs
+        :param ok_actions: A list of the ARNs of the actions to take in OK state
         """
         self.name = name
         self.connection = connection
         self.metric = metric
         self.namespace = namespace
         self.statistic = statistic
-        self.threshold = float(threshold) if threshold is not None else None
+        if threshold is not None:
+            self.threshold = float(threshold)
+        else:
+            self.threshold = None
         self.comparison = self._cmp_map.get(comparison)
-        self.period = int(period) if period is not None else None
-        self.evaluation_periods = int(evaluation_periods) if evaluation_periods is not None else None
+        if period is not None:
+            self.period = int(period)
+        else:
+            self.period = None
+        if evaluation_periods is not None:
+            self.evaluation_periods = int(evaluation_periods)
+        else:
+            self.evaluation_periods = None
         self.actions_enabled = None
         self.alarm_arn = None
         self.last_updated = None
         self.description = description
         self.dimensions = dimensions
-        self.insufficient_data_actions = []
-        self.ok_actions = []
         self.state_reason = None
         self.state_value = None
         self.unit = unit
-        alarm_action = []
-        self.alarm_actions = ListElement(alarm_action)
+        self.alarm_actions = alarm_actions
+        self.insufficient_data_actions = insufficient_data_actions
+        self.ok_actions = ok_actions
 
     def __repr__(self):
-        return 'MetricAlarm:%s[%s(%s) %s %s]' % (self.name, self.metric, self.statistic, self.comparison, self.threshold)
+        return 'MetricAlarm:%s[%s(%s) %s %s]' % (self.name, self.metric,
+                                                 self.statistic,
+                                                 self.comparison,
+                                                 self.threshold)
 
     def startElement(self, name, attrs, connection):
         if name == 'AlarmActions':
+            self.alarm_actions = ListElement()
             return self.alarm_actions
+        elif name == 'InsufficientDataActions':
+            self.insufficient_data_actions = ListElement()
+            return self.insufficient_data_actions
+        elif name == 'OKActions':
+            self.ok_actions = ListElement()
+            return self.ok_actions
+        elif name == 'Dimensions':
+            self.dimensions = Dimension()
+            return self.dimensions
         else:
             pass
 
@@ -181,11 +240,14 @@ class MetricAlarm(object):
     def disable_actions(self):
         return self.connection.disable_alarm_actions([self.name])
 
-    def describe_history(self, start_date=None, end_date=None, max_records=None, history_item_type=None, next_token=None):
-        return self.connection.describe_alarm_history(self.name, start_date, end_date,
-                                                      max_records, history_item_type, next_token)
+    def describe_history(self, start_date=None, end_date=None, max_records=None,
+                         history_item_type=None, next_token=None):
+        return self.connection.describe_alarm_history(self.name, start_date,
+                                                      end_date, max_records,
+                                                      history_item_type,
+                                                      next_token)
 
-    def add_alarm_action(self, sns_topic=None):
+    def add_alarm_action(self, action_arn=None):
         """
         Adds an alarm action, represented as an SNS topic, to this alarm. 
         What do do when alarm is triggered.
@@ -194,11 +256,41 @@ class MetricAlarm(object):
         :param action_arn: SNS topics to which notification should be 
                            sent if the alarm goes to state ALARM.
         """
-        if not sns_topic:
+        if not action_arn:
             return # Raise exception instead?
         self.actions_enabled = 'true'
-        self.alarm_actions.append(sns_topic)
+        self.alarm_actions.append(action_arn)
+
+    def add_insufficient_data_action(self, action_arn=None):
+        """
+        Adds an insufficient_data action, represented as an SNS topic, to
+        this alarm. What to do when the insufficient_data state is reached.
+
+        :type action_arn: str
+        :param action_arn: SNS topics to which notification should be 
+                           sent if the alarm goes to state INSUFFICIENT_DATA.
+        """
+        if not action_arn:
+            return
+        self.actions_enabled = 'true'
+        self.insufficient_data_actions.append(action_arn)
+    
+    def add_ok_action(self, action_arn=None):
+        """
+        Adds an ok action, represented as an SNS topic, to this alarm. What
+        to do when the ok state is reached.
+
+        :type action_arn: str
+        :param action_arn: SNS topics to which notification should be 
+                           sent if the alarm goes to state INSUFFICIENT_DATA.
+        """
+        if not action_arn:
+            return
+        self.actions_enabled = 'true'
+        self.ok_actions.append(action_arn)
 
+    def delete(self):
+        self.connection.delete_alarms([self.name])
 
 class AlarmHistoryItem(object):
     def __init__(self, connection=None):