def get_object(self, object_name):
"""
Return an L{Object} instance for an existing storage object.
If an object with a name matching object_name does not exist
then a L{NoSuchObject} exception is raised.
>>> obj = container.get_object('old_object')
>>> obj.name
'old_object'
@param object_name: the name of the object to retrieve
@type object_name: str
@rtype: L{Object}
@return: an Object representing the storage object requested
"""
return Object(self, object_name, force_exists=True)
def create_object(self, object_name):
"""
Return an L{Object} instance, creating it if necessary.
When passed the name of an existing object, this method will
return an instance of that object, otherwise it will create a
new one.
>>> container.create_object('new_object')
<cloudfiles.storage_object.Object object at 0xb778366c>
>>> obj = container.create_object('new_object')
>>> obj.name
'new_object'
@type object_name: str
@param object_name: the name of the object to create
@rtype: L{Object}
@return: an object representing the newly created storage object
"""
return Object(self, object_name)
