libcloud-notifications mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From to...@apache.org
Subject [5/6] git commit: docs: Update upgrade notes.
Date Mon, 09 Dec 2013 14:25:06 GMT
docs: Update upgrade notes.


Project: http://git-wip-us.apache.org/repos/asf/libcloud/repo
Commit: http://git-wip-us.apache.org/repos/asf/libcloud/commit/0e8c2f06
Tree: http://git-wip-us.apache.org/repos/asf/libcloud/tree/0e8c2f06
Diff: http://git-wip-us.apache.org/repos/asf/libcloud/diff/0e8c2f06

Branch: refs/heads/trunk
Commit: 0e8c2f06e2b6c1ca245f86000471563d4aaeaa79
Parents: ec90fcb
Author: Tomaz Muraus <tomaz@apache.org>
Authored: Mon Dec 9 15:13:36 2013 +0100
Committer: Tomaz Muraus <tomaz@apache.org>
Committed: Mon Dec 9 15:13:36 2013 +0100

----------------------------------------------------------------------
 docs/upgrade_notes.rst | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/libcloud/blob/0e8c2f06/docs/upgrade_notes.rst
----------------------------------------------------------------------
diff --git a/docs/upgrade_notes.rst b/docs/upgrade_notes.rst
index 8b0065d..41aa17e 100644
--- a/docs/upgrade_notes.rst
+++ b/docs/upgrade_notes.rst
@@ -15,6 +15,33 @@ single class plus ``region`` argument model.
 More information on how this affects existing drivers and your code can be
 found bellow.
 
+Default Content-Type is now provided if none is supplied and none can be guessed
+--------------------------------------------------------------------------------
+
+In older versions, Libcloud would throw an exception when a content type is not
+supplied and none can't be automatically detected when uploading an object.
+
+This has changed with the 0.14.0 release. Now if no content type is specified
+and none can't be detected, a default content type of
+``application/octet-stream`` is used.
+
+If you want to preserve the old behavior, you can set ``strict_mode`` attribute
+on the driver object to ``True``.
+
+.. sourcecode:: python
+
+    from libcloud.storage.types import Provider
+    from libcloud.stoage.providers import get_driver
+
+    cls = get_driver(Provider.CLOUDFILES)
+    driver = cls('username', 'api key')
+
+    driver.strict_mode = True
+
+If you are not using strict mode and you are uploading a binary object, we
+still encourage you to practice Python's "explicit is better than implicit"
+mantra and explicitly specify Content-Type of ``application/octet-stream``.
+
 libcloud.security.VERIFY_SSL_CERT_STRICT variable has been removed
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 


Mime
View raw message