openstack/deb-python-oauth2client
Code Issues Proposed changes

Update changelog to markdown.

Browse Source 
[skip ci]
This commit is contained in:
Craig Citro
2015-01-15 13:22:01 -08:00
parent f230907542
commit 7f19c40609
2 changed files with 216 additions and 223 deletions
Download Patch File Download Diff File Expand all files Collapse all files

223
CHANGELOG
View File

@@ -1,223 +0,0 @@
v1.4.5
Version 1.4.5
Set a shorter timeout for an Application Default Credentials issue on some
networks. (#93, #101)
Test cleanup, switch from mox to mock. (#103)
Switch docs to sphinx from epydoc.
v1.4.4
Version 1.4.4
Fix a bug in bytes/string encoding of headers.
v1.4.3
Version 1.4.3
Big thanks to @dhermes for spotting and fixing a mess in our test setup.
Fix a serious issue with tests not being run. (#86, #87, #89)
Start credentials cleanup for single 2LO/3LO call. (#83, #84)
Clean up stack traces when re-raising in some places. (#79)
Clean up doc building. (#81, #82)
Fixed minimum version for `six` dependency. (#75)
v1.4.2
Version 1.4.2
Several small bugfixes related to six/py3 support.
v1.4.1
Version 1.4.1
Fix a critical bug on import in oauth2client.tools.
v1.4
Version 1.4
Merge python3 branch! Massive thanks due to @pferate and @methane for doing
the heavy lifting.
Make oauth2client.tools import gracefully if argparse isn't present.
Change `flow.step2_exchange` to preserve the raw `id_token` in the
`token_response` field.
v1.3.2
Version 1.3.2
Quick bugfix for an issue with dict-like arguments to `flow.step2_exchange`,
which is common in some environments (such as GAE).
v1.3.1
Version 1.3.1
Quick bugfix for bad error handling in from_json.
v1.3
Version 1.3
Added support for the Google Application Default Credentials; see
https://developers.google.com/accounts/docs/application-default-credentials
for more information (thanks @orestica).
Added support for OAuth2 for devices (#3, thanks @sde-melo).
The minimum required Python version is now 2.6.
The `anyjson` submodule has been removed.
- Better exception handling around missing crypto libraries (#56).
- Improve error messages in `AccessTokenRefreshError` (#53, thanks
@erickoledadevrel).
- Drop uritemplate as a dependency.
- Handle X509 certs with PyCrypto (#51, thanks @liujin-google).
- Handle additional failure types on OSX (#32, thanks @simoncadman).
- Better unicode handling with PKCS12 passwords (#31, thanks @jterrace).
- Better retry handling with bad server replies on refresh (#29, thanks
@kaste).
- Better logging for missing `refresh_token` in server replies (#21).
- Support `login_hint` (#18, thanks @jay0lee).
- Better overwrite options in `django_orm.Storage`. (#2, thanks
@lraccomando).
v1.2
Version 1.2
The use of the gflags library is now deprecated, and is no longer a
dependency. If you are still using the oauth2client.tools.run() function
then include gflags as a dependency of your application or switch to
oauth2client.tools.run_flow.
Samples have been updated to use the new apiclient.sample_tools, and no
longer use gflags.
Added support for the experimental Object Change Notification, as found in
the Cloud Storage API.
The oauth2client App Engine decorators are now threadsafe.
- Use the following redirects feature of httplib2 where it returns the
ultimate URL after a series of redirects to avoid multiple hops for every
resumable media upload request.
- Updated AdSense Management API samples to V1.3
- Add option to automatically retry requests.
- Ability to list registered keys in multistore_file.
- User-agent must contain (gzip).
- The 'method' parameter for httplib2 is not positional. This would cause
spurious warnings in the logging.
- Making OAuth2Decorator more extensible. Fixes Issue 256.
- Update AdExchange Buyer API examples to version v1.2.
v1.1
Version 1.1
Add PEM support to SignedJWTAssertionCredentials (used to only support
PKCS12 formatted keys). Note that if you use PEM formatted keys you can use
PyCrypto 2.6 or later instead of OpenSSL.
Allow deserialized discovery docs to be passed to build_from_document().
- Make ResumableUploadError derive from HttpError.
- Many changes to move all the closures in apiclient.discovery into real
- classes and objects.
- Make from_json behavior inheritable.
- Expose the full token response in OAuth2Client and OAuth2Decorator.
- Handle reasons that are None.
- Added support for NDB based storing of oauth2client objects.
- Update grant_type for AssertionCredentials.
- Adding a .revoke() to Credentials. Closes issue 98.
- Modify oauth2client.multistore_file to store and retrieve credentials
using an arbitrary key.
- Don't accept 403 challenges by default for auth challenges.
- Set httplib2.RETRIES to 1.
- Consolidate handling of scopes.
- Upgrade to httplib2 version 0.8.
- Allow setting the response_type in OAuth2WebServerFlow.
- Ensure that dataWrapper feature is checked before using the 'data' value.
- HMAC verification does not use a constant time algorithm.
v1.0
Version 1.0
- Changes to the code for running tests and building releases.
v1.0c3
Version 1.0 Release Candidate 3
- In samples and oauth2 decorator, escape untrusted content before displaying it.
- Do not allow credentials files to be symlinks.
- Add XSRF protection to oauth2decorator callback 'state'.
- Handle uploading chunked media by stream.
- Handle passing streams directly to httplib2.
- Add support for Google Compute Engine service accounts.
- Flows no longer need to be saved between uses.
- Change GET to POST if URI is too long. Fixes issue #96.
- Add a keyring based Storage.
- More robust picking up JSON error responses.
- Make batch errors align with normal errors.
- Add a Google Compute sample.
- Token refresh to work with 'old' GData API
- Loading of client_secrets JSON file backed by a cache.
- Switch to new discovery path parameters.
- Add support for additionalProperties when printing schema'd objects.
- Fix media upload parameter names. Reviewed in http://codereview.appspot.com/6374062/
- oauth2client support for URL-encoded format of exchange token response (e.g. Facebook)
- Build cleaner and easier to read docs for dynamic surfaces.
v1.0c2
Version 1.0 Release Candidate 2
- Parameter values of None should be treated as missing. Fixes issue #144.
- Distribute the samples separately from the library source. Fixes issue #155.
- Move all remaining samples over to client_secrets.json. Fixes issue #156.
- Make locked_file.py understand win32file primitives for better awesomeness.
v1.0c1
Version 1.0 Release Candidate 1
- Documentation for the library has switched to epydoc:
http://google-api-python-client.googlecode.com/hg/docs/epy/index.html
- Many improvements for media support:
* Added media download support, including resumable downloads.
* Better handling of streams that report their size as 0.
* Update Media Upload to include io.Base and also fix some bugs.
- OAuth bug fixes and improvements.
* Remove OAuth 1.0 support.
* Added credentials_from_code and credentials_from_clientsecrets_and_code.
* Make oauth2client support Windows-friendly locking.
* Fix bug in StorageByKeyName.
* Fix None handling in Django fields. Reviewed in http://codereview.appspot.com/6298084/. Fixes issue #128.
- Add epydoc generated docs. Reviewed in http://codereview.appspot.com/6305043/
- Move to PEP386 compliant version numbers.
- New and updated samples
* Ad Exchange Buyer API v1 code samples.
* Automatically generate Samples wiki page from README files.
* Update Google Prediction samples.
* Add a Tasks sample that demonstrates Service accounts.
* new analytics api samples. Reviewed here: http://codereview.appspot.com/5494058/
- Convert all inline samples to the Farm API for consistency.
v1.0beta8
- Updated meda upload support.
- Many fixes for batch requests.
- Better handling for requests that don't require a body.
- Fix issues with Google App Engine Python 2.7 runtime.
- Better support for proxies.
- All Storages now have a .delete() method.
- Important changes which might break your code:
* apiclient.anyjson has moved to oauth2client.anyjson.
* Some calls, for example, taskqueue().lease() used to require a parameter
named body. In this new release only methods that really need to send a body
require a body parameter, and so you may get errors about an unknown
'body' parameter in your call. The solution is to remove the unneeded
body={} parameter.
v1.0beta7
- Support for batch requests. http://code.google.com/p/google-api-python-client/wiki/Batch
- Support for media upload. http://code.google.com/p/google-api-python-client/wiki/MediaUpload
- Better handling for APIs that return something other than JSON.
- Major cleanup and consolidation of the samples.
- Bug fixes and other enhancements:
72 Defect Appengine OAuth2Decorator: Convert redirect address to string
22 Defect Better error handling for unknown service name or version
48 Defect StorageByKeyName().get() has side effects
50 Defect Need sample client code for Admin Audit API
28 Defect better comments for app engine sample Nov 9
63 Enhancement Let OAuth2Decorator take a list of scope

216
CHANGELOG.md Normal file
View File

@@ -0,0 +1,216 @@
# CHANGELOG
## v1.4.5
* Set a shorter timeout for an Application Default Credentials issue on some
networks. (#93, #101)
* Test cleanup, switch from mox to mock. (#103)
* Switch docs to sphinx from epydoc.
## v1.4.4
* Fix a bug in bytes/string encoding of headers.
## v1.4.3
* Big thanks to @dhermes for spotting and fixing a mess in our test setup.
* Fix a serious issue with tests not being run. (#86, #87, #89)
* Start credentials cleanup for single 2LO/3LO call. (#83, #84)
* Clean up stack traces when re-raising in some places. (#79)
* Clean up doc building. (#81, #82)
* Fixed minimum version for `six` dependency. (#75)
## v1.4.2
* Several small bugfixes related to `six`/py3 support.
## v1.4.1
* Fix a critical bug on import in `oauth2client.tools`.
## v1.4
* Merge python3 branch! Massive thanks due to @pferate and @methane for doing
the heavy lifting.
* Make `oauth2client.tools` import gracefully if `argparse` isn't present.
* Change `flow.step2_exchange` to preserve the raw `id_token` in the
`token_response` field.
## v1.3.2
* Quick bugfix for an issue with dict-like arguments to `flow.step2_exchange`,
which is common in some environments (such as GAE).
## v1.3.1
* Quick bugfix for bad error handling in from_json.
## v1.3
* Added support for the
[Google Application Default Credentials](https://developers.google.com/accounts/docs/application-default-credentials)
for more information (thanks @orestica).
* Added support for OAuth2 for devices (#3, thanks @sde-melo).
* The minimum required Python version is now 2.6.
* The `anyjson` submodule has been removed.
* Better exception handling around missing crypto libraries (#56).
* Improve error messages in `AccessTokenRefreshError` (#53, thanks
@erickoledadevrel).
* Drop `uritemplate` as a dependency.
* Handle X509 certs with PyCrypto (#51, thanks @liujin-google).
* Handle additional failure types on OSX (#32, thanks @simoncadman).
* Better unicode handling with PKCS12 passwords (#31, thanks @jterrace).
* Better retry handling with bad server replies on refresh (#29, thanks
@kaste).
* Better logging for missing `refresh_token` in server replies (#21).
* Support `login_hint` (#18, thanks @jay0lee).
* Better overwrite options in `django_orm.Storage`. (#2, thanks @lraccomando).
## v1.2
* The use of the `gflags` library is now deprecated, and is no longer a
dependency. If you are still using the `oauth2client.tools.run()` function
then include `python-gflags` as a dependency of your application or switch to
`oauth2client.tools.run_flow`.
* Samples have been updated to use the new `apiclient.sample_tools`, and no
longer use `gflags`.
* Added support for the experimental Object Change Notification, as found in
the Cloud Storage API.
* The oauth2client App Engine decorators are now threadsafe.
* Use the following redirects feature of httplib2 where it returns the
ultimate URL after a series of redirects to avoid multiple hops for every
resumable media upload request.
* Updated AdSense Management API samples to V1.3
* Add option to automatically retry requests.
* Ability to list registered keys in `multistore_file`.
* User-agent must contain `(gzip)`.
* The `method` parameter for `httplib2` is not positional. This would cause
spurious warnings in the logging.
* Making OAuth2Decorator more extensible. Fixes Issue 256.
* Update AdExchange Buyer API examples to version v1.2.
## v1.1
* Add PEM support to `SignedJWTAssertionCredentials` (used to only support
PKCS12 formatted keys). Note that if you use PEM formatted keys you can use
PyCrypto 2.6 or later instead of OpenSSL.
* Allow deserialized discovery docs to be passed to `build_from_document()`.
* Make `ResumableUploadError` derive from `HttpError`.
* Many changes to move all the closures in `apiclient.discovery` into real
classes and objects.
* Make `from_json` behavior inheritable.
* Expose the full token response in `OAuth2Client` and `OAuth2Decorator`.
* Handle reasons that are None.
* Added support for NDB based storing of oauth2client objects.
* Update `grant_type` for `AssertionCredentials`.
* Adding a `.revoke()` to Credentials. Closes issue 98.
* Modify `oauth2client.multistore_file` to store and retrieve credentials
using an arbitrary key.
* Don't accept `403` challenges by default for auth challenges.
* Set `httplib2.RETRIES` to 1.
* Consolidate handling of scopes.
* Upgrade to httplib2 version 0.8.
* Allow setting the `response_type` in `OAuth2WebServerFlow`.
* Ensure that `dataWrapper` feature is checked before using the `data` value.
* HMAC verification does not use a constant time algorithm.
## v1.0
* Changes to the code for running tests and building releases.
## v1.0c3
* In samples and oauth2 decorator, escape untrusted content before displaying it.
* Do not allow credentials files to be symlinks.
* Add XSRF protection to oauth2decorator callback state.
* Handle uploading chunked media by stream.
* Handle passing streams directly to httplib2.
* Add support for Google Compute Engine service accounts.
* Flows no longer need to be saved between uses.
* Change GET to POST if URI is too long. Fixes issue 96.
* Add a `keyring`-based `Storage`.
* More robust picking up JSON error responses.
* Make batch errors align with normal errors.
* Add a Google Compute sample.
* Token refresh to work with old GData API.
* Loading of `client_secrets` JSON file backed by a cache.
* Switch to new discovery path parameters.
* Add support for `additionalProperties` when printing schema'd objects.
* [Fix media upload parameter names.](http://codereview.appspot.com/6374062/)
* oauth2client support for URL-encoded format of exchange token response (e.g.
Facebook)
* Build cleaner and easier to read docs for dynamic surfaces.
## v1.0c2
* Parameter values of None should be treated as missing. Fixes issue 144.
* Distribute the samples separately from the library source. Fixes issue 155.
* Move all remaining samples over to `client_secrets.json`. Fixes issue 156.
* Make `locked_file.py` understand win32file primitives for better
awesomeness.
## v1.0c1
* Documentation for the library has
[switched to epydoc](http://google-api-python-client.googlecode.com/hg/docs/epy/index.html)
* Many improvements for media support:
+ Added media download support, including resumable downloads.
+ Better handling of streams that report their size as 0.
+ Update `MediaUpload` to include `io.Base` and also fix some bugs.
* OAuth bug fixes and improvements.
+ Remove OAuth 1.0 support.
+ Added `credentials_from_code` and `credentials_from_clientsecrets_and_code`.
+ Make oauth2client support Windows-friendly locking.
+ Fix bug in `StorageByKeyName`.
+ Fix `None` handling in Django fields.
[Fixes issue 128](http://codereview.appspot.com/6298084/).
* [Add epydoc generated docs.](http://codereview.appspot.com/6305043/)
* Move to PEP386 compliant version numbers.
* New and updated samples
+ Ad Exchange Buyer API v1 code samples.
+ Automatically generate Samples wiki page from `README` files.
+ Update Google Prediction samples.
+ Add a Tasks sample that demonstrates Service accounts.
+ [new analytics api samples.](http://codereview.appspot.com/5494058/)
* Convert all inline samples to the Farm API for consistency.
## v1.0beta8
* Updated media upload support.
* Many fixes for batch requests.
* Better handling for requests that don't require a body.
* Fix issues with Google App Engine Python 2.7 runtime.
* Better support for proxies.
* All Storages now have a `.delete()` method.
* Important changes which might break your code:
+ `apiclient.anyjson` has moved to `oauth2client.anyjson`.
+ Some calls, for example, `taskqueue().lease()` used to require a parameter
named body. In this new release only methods that really need to send a
body require a body parameter, and so you may get errors about an unknown
`body` parameter in your call. The solution is to remove the unneeded
`body={}` parameter.
## v1.0beta7
* Support for
[batch requests](http://code.google.com/p/google-api-python-client/wiki/Batch).
* Support for
[media upload](http://code.google.com/p/google-api-python-client/wiki/MediaUpload).
* Better handling for APIs that return something other than JSON.
* Major cleanup and consolidation of the samples.
* Bug fixes and other enhancements:
72 Defect Appengine OAuth2Decorator: Convert redirect address to string
22 Defect Better error handling for unknown service name or version
48 Defect StorageByKeyName().get() has side effects
50 Defect Need sample client code for Admin Audit API
28 Defect better comments for app engine sample Nov 9
63 Enhancement Let OAuth2Decorator take a list of scope