Open Stack

We are happy to announce the release of:

python-swiftclient 3.1.0: OpenStack Object Storage API Client Library

This release is part of the newton release series.

With source available at:

    https://git.openstack.org/cgit/openstack/python-swiftclient

With package available at:

    https://pypi.python.org/pypi/python-swiftclient

Please report issues through launchpad:

    https://bugs.launchpad.net/python-swiftclient

For more details, please see below.

3.1.0
^^^^^

New Features

* Added a copy object method.

* Arbitrary query strings can now be passed into container
  functions.

* Client certificate and key can now be specified via CLI options
  (--os-cert/--os-key) or environment variables ($OS_CERT/$OS_KEY).

* A new CLI option *--ignore-checksum* can be specified to turn off
  checksum validation. In the SDK, the new *checksum=True* parameter
  can be used for the same purpose.

* Added --json option to *swift capabilities* / *swift info*

* Default to v3 auth if we find a (user|project)-domain-(name|id)
  option.

* Added a Python version constraint of >= Py27.

* *client.py* will now retry on a 401 (auth error) even if *retries*
  is set to zero.

* Fixed *swift download* when *marker* was specified.

* Object segments uploaded via swiftclient are now given the content
  type "application/swiftclient-segment".

* "Directory marker" objects are now given a "application/directory"
  content type to match both Swift's *staticweb* feature and other
  ecosystem tools.

* Strip leading/trailing whitespace from headers (otherwise, new
  versions of the requests library will raise an InvalidHeader error).
  Additionally, header values with standard types (integer, float, or
  bool) are coerced to strings before being sent to a socket.

* Non-python dependencies are now specified in bindep.txt. Currently
  this only lists a single dependency for testing (PyPy), but if
  future dependencies are added, they will be included in this file.

* Client exceptions now include response headers. One benefit is
  that this allows clients to see transaction IDs without needing to
  turn on debug logging.

* Client connections now accept gzip-encoded responses.

* Various other minor bug fixes and improvements.

Changes in python-swiftclient 3.0.0..3.1.0
------------------------------------------

cbd71a8 authors/changelog updates for 3.1.0 release
f728027 Accept gzip-encoded API responses
8753c4d Add swift tempurl and swift auth command docstring
96f0031 boolean logic cleanup in service.Swift[Copy|Post]Object
ab60e08 Convert numeric and boolean header values to strings
daed43a Fix examples and missing code-block
fd675b2 Use mock patch to handle get_auth_keystone
4a2465f Add copy object method
8fbe118 Strip leading/trailing whitespace from headers
b1539d9 Move other-requirements.txt to bindep.txt
ed4ee79 reenable sidebar links
335570e Add --json option to `swift capabilities` / `swift info`
d460db8 Modify assert
dca4ea5 Fix unicode issues in tempurl command
5be9b7e fixing nit picks in python-swiftclient doc
b940310 Add other-requirements.txt
1349409 Add python version constraint python>=2.7
f4f2e6c Add __ne__ built-in function
439330c Query string functionality for containers
a62b7ee client: renew token on 401 even if retries is 0
69bf463 Add an option: disable etag check on downloads
ff505d7 Suppress InsecureRequestWarning when using --insecure
2e78ca5 Fixed a typo in SwiftService API doc
659470e Update the home-page with developer documentation
bf5846f Migrated contributing file from .md to .rst
0225950 Correct doc string for http_conn argument
a0d65e4 Tighten up testing for sloppy auth version
fd5579a Check responses when retrying bodies
67f629c Default to v3 auth if we find a (user|project)-domain-(name|id) option
c376631 Pull option processing out to service.py
5b714f1 Parse options to dict
3a5a25f Add new doc structure and contents for swiftclient
450f505 Support client certificate/key
909bdf8 Fix downloading from "marker" item
9fd537a Use application/directory content-type for dir markers
4a6fa02 Identify segments uploaded via swiftclient
17aa6c7 Port from optparse to argparse
f86b2d8 Clean up some unnecessary variables
51a8a5a Fix SwiftPostObject options usage in SwiftService
67db164 Removes redundant "to"
d2bd2f0 Initialize delete_object mock *before* creating all the threads
f5224a6 Add tests for thread option validation
52eab61 Move python-keystoneclient to "extras"
965fd4d Initialise delete_object mock before it's called
9b8ab67 Include response headers in ClientExceptions
f179c36 Drop *.dbm* before running tests
00de6cf Check threads number options validation


Diffstat (except docs and test files)
-------------------------------------

.mailmap                                           |   2 +
AUTHORS                                            |  17 +-
CONTRIBUTING.md                                    |  12 -
CONTRIBUTING.rst                                   |  18 +
ChangeLog                                          |  49 +
README.rst                                         |   2 +-
bindep.txt                                         |   5 +
examples/capabilities.py                           |  20 +
examples/copy.py                                   |  30 +
examples/delete.py                                 |  34 +
examples/download.py                               |  37 +
examples/list.py                                   |  32 +
examples/post.py                                   |  31 +
examples/stat.py                                   |  25 +
examples/upload.py                                 |  72 ++
releasenotes/notes/310-notes-03040158a8683dd8.yaml |  38 +
setup.cfg                                          |   6 +-
setup.py                                           |   6 +-
swiftclient/client.py                              | 328 ++++---
swiftclient/exceptions.py                          |  15 +-
swiftclient/multithreading.py                      |   1 -
swiftclient/service.py                             | 299 ++++++-
swiftclient/shell.py                               | 985 ++++++++++++---------
swiftclient/utils.py                               |  50 +-
test-requirements.txt                              |   1 -
tox.ini                                            |   5 +-
41 files changed, 4714 insertions(+), 1677 deletions(-)


Requirements updates
--------------------

diff --git a/test-requirements.txt b/test-requirements.txt
index 044f7c3..0a81398 100644
--- a/test-requirements.txt
+++ b/test-requirements.txt
@@ -6 +5,0 @@ oslosphinx
-python-keystoneclient>=0.7.0