Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(216)

Side by Side Diff: third_party/gcs-oauth2-boto-plugin/README.md

Issue 698893003: Update checked in version of gsutil to version 4.6 (Closed) Base URL: http://dart.googlecode.com/svn/third_party/gsutil/
Patch Set: Created 6 years, 1 month ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch | Annotate | Revision Log
OLDNEW
(Empty)
1 # gcs-oauth2-boto-plugin
2
3 gcs-oauth2-boto-plugin is a Python application whose purpose is to behave as
4 an auth plugin for the [boto] auth plugin framework for use with [OAuth 2.0]
5 credentials for the Google Cloud Platform. This plugin is compatible with
6 both [user accounts] and [service accounts], and its functionality is
7 essentially a wrapper around the oauth2client package of
8 [google-api-python-client] with the addition of automatically caching tokens
9 for the machine in a thread- and process-safe fashion.
10
11 For more information about how to use this plugin to access Google Cloud Storage
12 via boto in your application, see the [GCS documentation].
13
14 If you wish to use this plugin without using the PyPI install as instructed in
15 the documentation (e.g., for development), then you will need to manually
16 acquire the modules from the requirements.txt file.
17
18
19 When using this plugin, you must specify a client ID and secret. We offer the
20 following methods for providing this information; if multiple methods are used,
21 we will choose them in the following order:
22
23 1. .boto config, if not set
24 2. environment variables (OAUTH2_CLIENT_ID and OAUTH2_CLIENT_SECRET), if not set
25 3. CLIENT_ID and CLIENT_SECRET values set by SetFallbackClientIdAndSecret functi on.
26
27
28 The default locking mechanism used is threading.Lock. You can switch to using
29 another locking mechanism by calling SetLock. Example:
30
31 ```
32 SetLock(multiprocessing.Manager().Lock())
33 ```
34
35
36 Before submitting any code, please run the tests (e.g., by running the following
37 command from the root of this repository):
38
39 PYTHONPATH="." python -m gcs_oauth2_boto_plugin.test_oauth2_client
40
41 [boto]: https://github.com/boto/boto
42 [OAuth 2.0]: https://developers.google.com/accounts/docs/OAuth2Login
43 [user accounts]: https://developers.google.com/accounts/docs/OAuth2#installed
44 [service accounts]: https://developers.google.com/accounts/docs/OAuth2#serviceac count
45 [google-api-python-client]: https://code.google.com/p/google-api-python-client/w iki/OAuth2Client
46 [GCS documentation]: https://developers.google.com/storage/docs/gspythonlibrary
OLDNEW
« no previous file with comments | « third_party/gcs-oauth2-boto-plugin/COPYING ('k') | third_party/gcs-oauth2-boto-plugin/gcs_oauth2_boto_plugin/__init__.py » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698