Upgrade gsutil to 3.4

third_party/gsutil/20110627/boto/boto/file/bucket.py

-# Copyright 2010 Google Inc.
-#
-# 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.
-
-# File representation of bucket, for use with "file://" URIs.
-
-import os
-from key import Key
-from boto.file.simpleresultset import SimpleResultSet
-from boto.s3.bucketlistresultset import BucketListResultSet
-
-class Bucket(object):
-    def __init__(self, name, contained_key):
-        """Instantiate an anonymous file-based Bucket around a single key.
-        """
-        self.name = name
-        self.contained_key = contained_key
-
-    def __iter__(self):
-        return iter(BucketListResultSet(self))
-
-    def __str__(self):
-        return 'anonymous bucket for file://' + self.contained_key
-
-    def delete_key(self, key_name, headers=None,
-                   version_id=None, mfa_token=None):
-        """
-        Deletes a key from the bucket.
-
-        :type key_name: string
-        :param key_name: The key name to delete
-
-        :type version_id: string
-        :param version_id: Unused in this subclass.
-        
-        :type mfa_token: tuple or list of strings
-        :param mfa_token: Unused in this subclass.
-        """
-        os.remove(key_name)
-
-    def get_all_keys(self, headers=None, **params):
-        """
-        This method returns the single key around which this anonymous Bucket
-        was instantiated.
-
-        :rtype: SimpleResultSet
-        :return: The result from file system listing the keys requested
-
-        """
-        key = Key(self.name, self.contained_key)
-        return SimpleResultSet([key])
-
-    def get_key(self, key_name, headers=None, version_id=None):
-        """
-        Check to see if a particular key exists within the bucket.
-        Returns: An instance of a Key object or None
-
-        :type key_name: string
-        :param key_name: The name of the key to retrieve
-
-        :type version_id: string
-        :param version_id: Unused in this subclass.
-
-        :rtype: :class:`boto.file.key.Key`
-        :returns: A Key object from this bucket.
-        """
-        fp = open(key_name, 'rb')
-        return Key(self.name, key_name, fp)
-
-    def new_key(self, key_name=None):
-        """
-        Creates a new key
-
-        :type key_name: string
-        :param key_name: The name of the key to create
-
-        :rtype: :class:`boto.file.key.Key`
-        :returns: An instance of the newly created key object
-        """
-        dir_name = os.path.dirname(key_name)
-        if dir_name and not os.path.exists(dir_name):
-            os.makedirs(dir_name)
-        fp = open(key_name, 'wb')
-        return Key(self.name, key_name, fp)