Index: third_party/gsutil/boto/boto/ec2/__init__.py |
diff --git a/third_party/gsutil/boto/boto/ec2/__init__.py b/third_party/gsutil/boto/boto/ec2/__init__.py |
new file mode 100644 |
index 0000000000000000000000000000000000000000..cc1e582f0e74172441568e579fb68aab3d12caae |
--- /dev/null |
+++ b/third_party/gsutil/boto/boto/ec2/__init__.py |
@@ -0,0 +1,96 @@ |
+# Copyright (c) 2006-2008 Mitch Garnaat http://garnaat.org/ |
+# |
+# Permission is hereby granted, free of charge, to any person obtaining a |
+# copy of this software and associated documentation files (the |
+# "Software"), to deal in the Software without restriction, including |
+# without limitation the rights to use, copy, modify, merge, publish, dis- |
+# tribute, sublicense, and/or sell copies of the Software, and to permit |
+# persons to whom the Software is furnished to do so, subject to the fol- |
+# lowing conditions: |
+# |
+# The above copyright notice and this permission notice shall be included |
+# in all copies or substantial portions of the Software. |
+# |
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS |
+# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL- |
+# ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT |
+# SHALL THE AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, |
+# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS |
+# IN THE SOFTWARE. |
+# |
+""" |
+This module provides an interface to the Elastic Compute Cloud (EC2) |
+service from AWS. |
+""" |
+from boto.ec2.connection import EC2Connection |
+from boto.regioninfo import RegionInfo |
+ |
+ |
+RegionData = { |
+ 'us-east-1': 'ec2.us-east-1.amazonaws.com', |
+ 'us-west-1': 'ec2.us-west-1.amazonaws.com', |
+ 'us-west-2': 'ec2.us-west-2.amazonaws.com', |
+ 'sa-east-1': 'ec2.sa-east-1.amazonaws.com', |
+ 'eu-west-1': 'ec2.eu-west-1.amazonaws.com', |
+ 'ap-northeast-1': 'ec2.ap-northeast-1.amazonaws.com', |
+ 'ap-southeast-1': 'ec2.ap-southeast-1.amazonaws.com', |
+ 'ap-southeast-2': 'ec2.ap-southeast-2.amazonaws.com', |
+} |
+ |
+ |
+def regions(**kw_params): |
+ """ |
+ Get all available regions for the EC2 service. |
+ You may pass any of the arguments accepted by the EC2Connection |
+ object's constructor as keyword arguments and they will be |
+ passed along to the EC2Connection object. |
+ |
+ :rtype: list |
+ :return: A list of :class:`boto.ec2.regioninfo.RegionInfo` |
+ """ |
+ regions = [] |
+ for region_name in RegionData: |
+ region = RegionInfo(name=region_name, |
+ endpoint=RegionData[region_name], |
+ connection_cls=EC2Connection) |
+ regions.append(region) |
+ return regions |
+ |
+ |
+def connect_to_region(region_name, **kw_params): |
+ """ |
+ Given a valid region name, return a |
+ :class:`boto.ec2.connection.EC2Connection`. |
+ Any additional parameters after the region_name are passed on to |
+ the connect method of the region object. |
+ |
+ :type: str |
+ :param region_name: The name of the region to connect to. |
+ |
+ :rtype: :class:`boto.ec2.connection.EC2Connection` or ``None`` |
+ :return: A connection to the given region, or None if an invalid region |
+ name is given |
+ """ |
+ for region in regions(**kw_params): |
+ if region.name == region_name: |
+ return region.connect(**kw_params) |
+ return None |
+ |
+ |
+def get_region(region_name, **kw_params): |
+ """ |
+ Find and return a :class:`boto.ec2.regioninfo.RegionInfo` object |
+ given a region name. |
+ |
+ :type: str |
+ :param: The name of the region. |
+ |
+ :rtype: :class:`boto.ec2.regioninfo.RegionInfo` |
+ :return: The RegionInfo object for the given region or None if |
+ an invalid region name is provided. |
+ """ |
+ for region in regions(**kw_params): |
+ if region.name == region_name: |
+ return region |
+ return None |