Normalize away extra empty line after method docstring.
Merge remote-tracking branch 'upstream/master'
Moar empty-lines-after-docstring.
Remove 'poetry' in docstrings.
Remove moar spurious blank lines, docstring poetry.
Even moar spurious blank lines, docstring poetry.
Moar spurious blank lines.
Document exceptions (currently) raised from 'Bucket.delete'.

Note that #164 would change this (by adding fine-grained exceptions
for 409, 401, etc.).

Fixes #159 (but should be revisited if #164 lands).
Make 'Bucket.delete_keys' return a useful result.

Result is a list of (key, success) tuples, one per requested key.

Fixes #161.

Addresses #160 (users who want to delete without raising can use
'Bucket.delete_keys([key])' instead of 'Bucket.delete_key(key)').
Make 'Bucket.delete_keys' take an 'on_error' callback.

If passed, the callback will be called once for each key not found,
with the offending key.
Document exceptions (currently) raised from 'Connection.create_bucket'.

Note that #164 would change this (by adding fine-grained exceptions
for 409, 401, etc.).

Fixes #166 (but should be revisited if #164 lands).
Rename key iterators to indicate they are implementation details of Key.

Rename 'key.KeyIterator' -> 'key._KeyIterator'

Move / rename 'iterator.KeyDataIterator' -> 'key._KeyDataIterator'.

Fixes #244.
Merge pull request #322 from tseaver/166-document_exceptions_for_connection_create_bucket

Fix #166: Document exceptions (currently) raised from 'Connection.create_bucket'.
Merge pull request #321 from tseaver/159-document_exceptions_for_bucket_delete

Fix #159: Document exceptions (currently) raised from 'Bucket.delete'.
Fixing corner case where lint doesn't run outside of a PR.
Merge pull request #323 from tseaver/244-rename-key_data_iterator-not_api

Fix #244: Rename key iterators to indicate they are implementation details of Key.
Merge pull request #325 from dhermes/make-lint-run-always

Fixing corner case where lint doesn't run outside of a PR.
Rename upload/download methods to clarify directionality.

- 'set_contents*' -> 'upload'.

- 'get_contents* -> 'download'.

Original boto-like names retained as aliases per @jgeewax.

Fixes #148.
Merge pull request #320 from tseaver/148-rename_key_upload_download_methods

Rename upload/download methods to clarify directionality.
Allow clearing an ACL.