From 30329a0cfd8a4c5a2ad4ea78def217cf6ea8076f Mon Sep 17 00:00:00 2001 From: Danny Hermes Date: Tue, 4 Aug 2015 09:34:17 -0700 Subject: [PATCH] Renaming latest->stable, master->latest. See #1026 for context. --- index.html | 2 +- latest/.buildinfo | 2 +- latest/_modules/gcloud/connection.html | 12 +- latest/_modules/gcloud/credentials.html | 12 +- latest/_modules/gcloud/datastore/batch.html | 12 +- latest/_modules/gcloud/datastore/client.html | 50 +- latest/_modules/gcloud/datastore/entity.html | 12 +- latest/_modules/gcloud/datastore/key.html | 12 +- latest/_modules/gcloud/datastore/query.html | 38 +- .../gcloud/datastore/transaction.html | 12 +- latest/_modules/gcloud/exceptions.html | 12 +- latest/_modules/gcloud/pubsub/client.html | 12 +- latest/_modules/gcloud/pubsub/connection.html | 12 +- .../_modules/gcloud/pubsub/subscription.html | 12 +- latest/_modules/gcloud/pubsub/topic.html | 12 +- latest/_modules/gcloud/storage/acl.html | 12 +- latest/_modules/gcloud/storage/blob.html | 12 +- latest/_modules/gcloud/storage/bucket.html | 135 +--- .../_modules/gcloud/storage/connection.html | 12 +- latest/_modules/index.html | 12 +- latest/_sources/bigquery-usage.txt | 456 ++++++++++++- latest/_sources/index.txt | 6 +- latest/bigquery-usage.html | 431 +++++++++++- latest/datastore-batches.html | 12 +- latest/datastore-client.html | 25 +- latest/datastore-entities.html | 12 +- latest/datastore-keys.html | 12 +- latest/datastore-overview.html | 12 +- latest/datastore-queries.html | 35 +- latest/datastore-transactions.html | 12 +- latest/gcloud-api.html | 12 +- latest/genindex.html | 30 +- latest/index.html | 16 +- latest/objects.inv | Bin 2305 -> 2294 bytes latest/pubsub-api.html | 12 +- latest/pubsub-subscription.html | 16 +- latest/pubsub-topic.html | 16 +- latest/pubsub-usage.html | 14 +- latest/py-modindex.html | 12 +- latest/search.html | 12 +- latest/searchindex.js | 2 +- latest/storage-acl.html | 12 +- latest/storage-api.html | 14 +- latest/storage-blobs.html | 12 +- latest/storage-buckets.html | 141 +--- master/_sources/bigquery-usage.txt | 557 --------------- master/bigquery-usage.html | 644 ------------------ master/objects.inv | Bin 2294 -> 0 bytes master/searchindex.js | 1 - {master => stable}/.buildinfo | 2 +- .../_modules/gcloud/connection.html | 12 +- .../_modules/gcloud/credentials.html | 12 +- .../_modules/gcloud/datastore/batch.html | 12 +- .../_modules/gcloud/datastore/client.html | 50 +- .../_modules/gcloud/datastore/entity.html | 12 +- .../_modules/gcloud/datastore/key.html | 12 +- .../_modules/gcloud/datastore/query.html | 38 +- .../gcloud/datastore/transaction.html | 12 +- .../_modules/gcloud/exceptions.html | 12 +- .../_modules/gcloud/pubsub/client.html | 12 +- .../_modules/gcloud/pubsub/connection.html | 12 +- .../_modules/gcloud/pubsub/subscription.html | 12 +- .../_modules/gcloud/pubsub/topic.html | 12 +- .../_modules/gcloud/storage/acl.html | 12 +- .../_modules/gcloud/storage/blob.html | 12 +- .../_modules/gcloud/storage/bucket.html | 135 +++- .../_modules/gcloud/storage/connection.html | 12 +- {master => stable}/_modules/index.html | 12 +- stable/_sources/bigquery-usage.txt | 123 ++++ .../_sources/datastore-batches.txt | 0 .../_sources/datastore-client.txt | 0 .../_sources/datastore-entities.txt | 0 .../_sources/datastore-keys.txt | 0 .../_sources/datastore-overview.txt | 0 .../_sources/datastore-queries.txt | 0 .../_sources/datastore-transactions.txt | 0 {master => stable}/_sources/gcloud-api.txt | 0 {master => stable}/_sources/index.txt | 6 +- {master => stable}/_sources/pubsub-api.txt | 0 .../_sources/pubsub-subscription.txt | 0 {master => stable}/_sources/pubsub-topic.txt | 0 {master => stable}/_sources/pubsub-usage.txt | 0 {master => stable}/_sources/storage-acl.txt | 0 {master => stable}/_sources/storage-api.txt | 0 {master => stable}/_sources/storage-blobs.txt | 0 .../_sources/storage-buckets.txt | 0 {master => stable}/_static/ajax-loader.gif | Bin {master => stable}/_static/basic.css | 0 {master => stable}/_static/classic.css | 0 {master => stable}/_static/comment-bright.png | Bin {master => stable}/_static/comment-close.png | Bin {master => stable}/_static/comment.png | Bin {master => stable}/_static/css/github.min.css | 0 {master => stable}/_static/css/main.css | 0 {master => stable}/_static/css/normalize.css | 0 {master => stable}/_static/doctools.js | 0 {master => stable}/_static/down-pressed.png | Bin {master => stable}/_static/down.png | Bin {master => stable}/_static/favicon.ico | Bin {master => stable}/_static/file.png | Bin .../_static/images/datastore-logo.png | Bin {master => stable}/_static/images/favicon.ico | Bin .../_static/images/icon-arrow-bullet.svg | 0 .../_static/images/icon-dropdown-faq.svg | 0 .../_static/images/icon-dropdown.svg | 0 .../_static/images/icon-lang-nodejs.svg | 0 .../_static/images/icon-lang-python.svg | 0 .../_static/images/icon-lang-ruby.svg | 0 .../_static/images/icon-link-github.svg | 0 .../images/icon-link-package-manager.svg | 0 .../images/icon-link-stackoverflow.svg | 0 .../_static/images/icon-menu.svg | 0 .../_static/images/icon-table-check.svg | 0 {master => stable}/_static/images/lang-bg.png | Bin .../_static/images/logo-full.svg | 0 {master => stable}/_static/images/logo.svg | 0 .../_static/images/storage-logo.png | Bin {master => stable}/_static/jquery-1.11.1.js | 0 {master => stable}/_static/jquery.js | 0 {master => stable}/_static/js/main.js | 0 {master => stable}/_static/js/plugins.js | 0 .../_static/js/vendor/jquery-1.10.2.min.js | 0 .../_static/js/vendor/modernizr-2.6.2.min.js | 0 .../_static/js/vendor/prettify.js | 0 {master => stable}/_static/minus.png | Bin {master => stable}/_static/plus.png | Bin {master => stable}/_static/pygments.css | 0 {master => stable}/_static/searchtools.js | 0 {master => stable}/_static/sidebar.js | 0 .../_static/underscore-1.3.1.js | 0 {master => stable}/_static/underscore.js | 0 {master => stable}/_static/up-pressed.png | Bin {master => stable}/_static/up.png | Bin {master => stable}/_static/websupport.js | 0 stable/bigquery-usage.html | 253 +++++++ {master => stable}/datastore-batches.html | 12 +- {master => stable}/datastore-client.html | 25 +- {master => stable}/datastore-entities.html | 12 +- {master => stable}/datastore-keys.html | 12 +- {master => stable}/datastore-overview.html | 12 +- {master => stable}/datastore-queries.html | 35 +- .../datastore-transactions.html | 12 +- {master => stable}/gcloud-api.html | 12 +- {master => stable}/genindex.html | 30 +- {master => stable}/index.html | 16 +- stable/objects.inv | Bin 0 -> 2305 bytes {master => stable}/pubsub-api.html | 12 +- {master => stable}/pubsub-subscription.html | 16 +- {master => stable}/pubsub-topic.html | 16 +- {master => stable}/pubsub-usage.html | 14 +- {master => stable}/py-modindex.html | 12 +- {master => stable}/search.html | 12 +- stable/searchindex.js | 1 + {master => stable}/storage-acl.html | 12 +- {master => stable}/storage-api.html | 14 +- {master => stable}/storage-blobs.html | 12 +- {master => stable}/storage-buckets.html | 141 +++- versions.html | 4 +- versions.json | 2 +- 159 files changed, 2088 insertions(+), 2088 deletions(-) delete mode 100644 master/_sources/bigquery-usage.txt delete mode 100644 master/bigquery-usage.html delete mode 100644 master/objects.inv delete mode 100644 master/searchindex.js rename {master => stable}/.buildinfo (82%) rename {master => stable}/_modules/gcloud/connection.html (99%) rename {master => stable}/_modules/gcloud/credentials.html (99%) rename {master => stable}/_modules/gcloud/datastore/batch.html (99%) rename {master => stable}/_modules/gcloud/datastore/client.html (94%) rename {master => stable}/_modules/gcloud/datastore/entity.html (98%) rename {master => stable}/_modules/gcloud/datastore/key.html (99%) rename {master => stable}/_modules/gcloud/datastore/query.html (97%) rename {master => stable}/_modules/gcloud/datastore/transaction.html (98%) rename {master => stable}/_modules/gcloud/exceptions.html (98%) rename {master => stable}/_modules/gcloud/pubsub/client.html (98%) rename {master => stable}/_modules/gcloud/pubsub/connection.html (96%) rename {master => stable}/_modules/gcloud/pubsub/subscription.html (99%) rename {master => stable}/_modules/gcloud/pubsub/topic.html (99%) rename {master => stable}/_modules/gcloud/storage/acl.html (99%) rename {master => stable}/_modules/gcloud/storage/blob.html (99%) rename {master => stable}/_modules/gcloud/storage/bucket.html (90%) rename {master => stable}/_modules/gcloud/storage/connection.html (96%) rename {master => stable}/_modules/index.html (95%) create mode 100644 stable/_sources/bigquery-usage.txt rename {master => stable}/_sources/datastore-batches.txt (100%) rename {master => stable}/_sources/datastore-client.txt (100%) rename {master => stable}/_sources/datastore-entities.txt (100%) rename {master => stable}/_sources/datastore-keys.txt (100%) rename {master => stable}/_sources/datastore-overview.txt (100%) rename {master => stable}/_sources/datastore-queries.txt (100%) rename {master => stable}/_sources/datastore-transactions.txt (100%) rename {master => stable}/_sources/gcloud-api.txt (100%) rename {master => stable}/_sources/index.txt (90%) rename {master => stable}/_sources/pubsub-api.txt (100%) rename {master => stable}/_sources/pubsub-subscription.txt (100%) rename {master => stable}/_sources/pubsub-topic.txt (100%) rename {master => stable}/_sources/pubsub-usage.txt (100%) rename {master => stable}/_sources/storage-acl.txt (100%) rename {master => stable}/_sources/storage-api.txt (100%) rename {master => stable}/_sources/storage-blobs.txt (100%) rename {master => stable}/_sources/storage-buckets.txt (100%) rename {master => stable}/_static/ajax-loader.gif (100%) rename {master => stable}/_static/basic.css (100%) rename {master => stable}/_static/classic.css (100%) rename {master => stable}/_static/comment-bright.png (100%) rename {master => stable}/_static/comment-close.png (100%) rename {master => stable}/_static/comment.png (100%) rename {master => stable}/_static/css/github.min.css (100%) rename {master => stable}/_static/css/main.css (100%) rename {master => stable}/_static/css/normalize.css (100%) rename {master => stable}/_static/doctools.js (100%) rename {master => stable}/_static/down-pressed.png (100%) rename {master => stable}/_static/down.png (100%) rename {master => stable}/_static/favicon.ico (100%) rename {master => stable}/_static/file.png (100%) rename {master => stable}/_static/images/datastore-logo.png (100%) rename {master => stable}/_static/images/favicon.ico (100%) rename {master => stable}/_static/images/icon-arrow-bullet.svg (100%) rename {master => stable}/_static/images/icon-dropdown-faq.svg (100%) rename {master => stable}/_static/images/icon-dropdown.svg (100%) rename {master => stable}/_static/images/icon-lang-nodejs.svg (100%) rename {master => stable}/_static/images/icon-lang-python.svg (100%) rename {master => stable}/_static/images/icon-lang-ruby.svg (100%) rename {master => stable}/_static/images/icon-link-github.svg (100%) rename {master => stable}/_static/images/icon-link-package-manager.svg (100%) rename {master => stable}/_static/images/icon-link-stackoverflow.svg (100%) rename {master => stable}/_static/images/icon-menu.svg (100%) rename {master => stable}/_static/images/icon-table-check.svg (100%) rename {master => stable}/_static/images/lang-bg.png (100%) rename {master => stable}/_static/images/logo-full.svg (100%) rename {master => stable}/_static/images/logo.svg (100%) rename {master => stable}/_static/images/storage-logo.png (100%) rename {master => stable}/_static/jquery-1.11.1.js (100%) rename {master => stable}/_static/jquery.js (100%) rename {master => stable}/_static/js/main.js (100%) rename {master => stable}/_static/js/plugins.js (100%) rename {master => stable}/_static/js/vendor/jquery-1.10.2.min.js (100%) rename {master => stable}/_static/js/vendor/modernizr-2.6.2.min.js (100%) rename {master => stable}/_static/js/vendor/prettify.js (100%) rename {master => stable}/_static/minus.png (100%) rename {master => stable}/_static/plus.png (100%) rename {master => stable}/_static/pygments.css (100%) rename {master => stable}/_static/searchtools.js (100%) rename {master => stable}/_static/sidebar.js (100%) rename {master => stable}/_static/underscore-1.3.1.js (100%) rename {master => stable}/_static/underscore.js (100%) rename {master => stable}/_static/up-pressed.png (100%) rename {master => stable}/_static/up.png (100%) rename {master => stable}/_static/websupport.js (100%) create mode 100644 stable/bigquery-usage.html rename {master => stable}/datastore-batches.html (98%) rename {master => stable}/datastore-client.html (93%) rename {master => stable}/datastore-entities.html (97%) rename {master => stable}/datastore-keys.html (98%) rename {master => stable}/datastore-overview.html (97%) rename {master => stable}/datastore-queries.html (93%) rename {master => stable}/datastore-transactions.html (98%) rename {master => stable}/gcloud-api.html (99%) rename {master => stable}/genindex.html (98%) rename {master => stable}/index.html (92%) create mode 100644 stable/objects.inv rename {master => stable}/pubsub-api.html (98%) rename {master => stable}/pubsub-subscription.html (98%) rename {master => stable}/pubsub-topic.html (98%) rename {master => stable}/pubsub-usage.html (99%) rename {master => stable}/py-modindex.html (97%) rename {master => stable}/search.html (96%) create mode 100644 stable/searchindex.js rename {master => stable}/storage-acl.html (99%) rename {master => stable}/storage-api.html (96%) rename {master => stable}/storage-blobs.html (99%) rename {master => stable}/storage-buckets.html (85%) diff --git a/index.html b/index.html index dedafe85eeb6..689412caee22 100755 --- a/index.html +++ b/index.html @@ -68,7 +68,7 @@

One-line install

- + Report an Issue @@ -73,7 +73,7 @@

Python

@@ -537,8 +537,8 @@

Source code for gcloud.connection

 
  • ACL
  • Pub/Sub
  • Using the API
  • -
  • Subscriptions
  • Topics
  • +
  • Subscriptions
  • BigQuery
  • diff --git a/latest/_modules/gcloud/credentials.html b/latest/_modules/gcloud/credentials.html index 54e0bb38fd46..95dc804dbc57 100644 --- a/latest/_modules/gcloud/credentials.html +++ b/latest/_modules/gcloud/credentials.html @@ -5,7 +5,7 @@ - gcloud.credentials — gcloud 0.7.0 documentation + gcloud.credentials — gcloud 777c6ac documentation @@ -15,7 +15,7 @@ - + @@ -59,7 +59,7 @@

    - + Report an Issue @@ -73,7 +73,7 @@

    Python

    @@ -465,8 +465,8 @@

    Source code for gcloud.credentials

     
  • ACL
  • Pub/Sub
  • Using the API
  • -
  • Subscriptions
  • Topics
  • +
  • Subscriptions
  • BigQuery
  • diff --git a/latest/_modules/gcloud/datastore/batch.html b/latest/_modules/gcloud/datastore/batch.html index da2ad1705849..1e10dbbd5721 100644 --- a/latest/_modules/gcloud/datastore/batch.html +++ b/latest/_modules/gcloud/datastore/batch.html @@ -5,7 +5,7 @@ - gcloud.datastore.batch — gcloud 0.7.0 documentation + gcloud.datastore.batch — gcloud 777c6ac documentation @@ -15,7 +15,7 @@ - + @@ -59,7 +59,7 @@

    - + Report an Issue @@ -73,7 +73,7 @@

    Python

    @@ -394,8 +394,8 @@

    Source code for gcloud.datastore.batch

     
  • ACL
  • Pub/Sub
  • Using the API
  • -
  • Subscriptions
  • Topics
  • +
  • Subscriptions
  • BigQuery
  • diff --git a/latest/_modules/gcloud/datastore/client.html b/latest/_modules/gcloud/datastore/client.html index 0bccf4f5eb1c..be2ba3239521 100644 --- a/latest/_modules/gcloud/datastore/client.html +++ b/latest/_modules/gcloud/datastore/client.html @@ -5,7 +5,7 @@ - gcloud.datastore.client — gcloud 0.7.0 documentation + gcloud.datastore.client — gcloud 777c6ac documentation @@ -15,7 +15,7 @@ - + @@ -59,7 +59,7 @@

    - + Report an Issue @@ -73,7 +73,7 @@

    Python

    @@ -107,6 +107,7 @@

    Source code for gcloud.datastore.client

     from gcloud._helpers import _LocalStack
     from gcloud._helpers import _app_engine_id
     from gcloud._helpers import _compute_engine_id
    +from gcloud.client import Client as _BaseClient
     from gcloud.datastore import helpers
     from gcloud.datastore.connection import Connection
     from gcloud.datastore.batch import Batch
    @@ -114,26 +115,22 @@ 

    Source code for gcloud.datastore.client

     from gcloud.datastore.key import Key
     from gcloud.datastore.query import Query
     from gcloud.datastore.transaction import Transaction
    +from gcloud.environment_vars import DATASET
    +from gcloud.environment_vars import GCD_DATASET
     
     
     _MAX_LOOPS = 128
     """Maximum number of iterations to wait for deferred keys."""
     
    -_DATASET_ENV_VAR_NAME = 'GCLOUD_DATASET_ID'
    -"""Environment variable defining default dataset ID."""
    -
    -_GCD_DATASET_ENV_VAR_NAME = 'DATASTORE_DATASET'
    -"""Environment variable defining default dataset ID under GCD."""
    -
     
     def _get_production_dataset_id():
         """Gets the production application ID if it can be inferred."""
    -    return os.getenv(_DATASET_ENV_VAR_NAME)
    +    return os.getenv(DATASET)
     
     
     def _get_gcd_dataset_id():
         """Gets the GCD application ID if it can be inferred."""
    -    return os.getenv(_GCD_DATASET_ENV_VAR_NAME)
    +    return os.getenv(GCD_DATASET)
     
     
     def _determine_default_dataset_id(dataset_id=None):
    @@ -247,7 +244,7 @@ 

    Source code for gcloud.datastore.client

         return results
     
     
    -
    [docs]class Client(object): +
    [docs]class Client(_BaseClient): """Convenience wrapper for invoking APIs/factories w/ a dataset ID. :type dataset_id: string @@ -256,20 +253,29 @@

    Source code for gcloud.datastore.client

         :type namespace: string
         :param namespace: (optional) namespace to pass to proxied API methods.
     
    -    :type connection: :class:`gcloud.datastore.connection.Connection`, or None
    -    :param connection: (optional) connection to pass to proxied API methods
    +    :type credentials: :class:`oauth2client.client.OAuth2Credentials` or
    +                       :class:`NoneType`
    +    :param credentials: The OAuth2 Credentials to use for the connection
    +                        owned by this client. If not passed (and if no ``http``
    +                        object is passed), falls back to the default inferred
    +                        from the environment.
    +
    +    :type http: :class:`httplib2.Http` or class that defines ``request()``.
    +    :param http: An optional HTTP object to make requests. If not passed, an
    +                 ``http`` object is created that is bound to the
    +                 ``credentials`` for the current object.
         """
    +    _connection_class = Connection
     
    -    def __init__(self, dataset_id=None, namespace=None, connection=None):
    +    def __init__(self, dataset_id=None, namespace=None,
    +                 credentials=None, http=None):
             dataset_id = _determine_default_dataset_id(dataset_id)
             if dataset_id is None:
                 raise EnvironmentError('Dataset ID could not be inferred.')
             self.dataset_id = dataset_id
    -        if connection is None:
    -            connection = Connection.from_environment()
    -        self.connection = connection
    -        self._batch_stack = _LocalStack()
             self.namespace = namespace
    +        self._batch_stack = _LocalStack()
    +        super(Client, self).__init__(credentials, http)
     
         def _push_batch(self, batch):
             """Push a batch/transaction onto our stack.
    @@ -563,8 +569,8 @@ 

    Source code for gcloud.datastore.client

     
  • ACL
  • Pub/Sub
  • Using the API
  • -
  • Subscriptions
  • Topics
  • +
  • Subscriptions
  • BigQuery
  • diff --git a/latest/_modules/gcloud/datastore/entity.html b/latest/_modules/gcloud/datastore/entity.html index 4cfdb46a63d0..7e5d84425d8a 100644 --- a/latest/_modules/gcloud/datastore/entity.html +++ b/latest/_modules/gcloud/datastore/entity.html @@ -5,7 +5,7 @@ - gcloud.datastore.entity — gcloud 0.7.0 documentation + gcloud.datastore.entity — gcloud 777c6ac documentation @@ -15,7 +15,7 @@ - + @@ -59,7 +59,7 @@

    - + Report an Issue @@ -73,7 +73,7 @@

    Python

    @@ -244,8 +244,8 @@

    Source code for gcloud.datastore.entity

     
  • ACL
  • Pub/Sub
  • Using the API
  • -
  • Subscriptions
  • Topics
  • +
  • Subscriptions
  • BigQuery
  • diff --git a/latest/_modules/gcloud/datastore/key.html b/latest/_modules/gcloud/datastore/key.html index 112d107e064f..a2065e34369e 100644 --- a/latest/_modules/gcloud/datastore/key.html +++ b/latest/_modules/gcloud/datastore/key.html @@ -5,7 +5,7 @@ - gcloud.datastore.key — gcloud 0.7.0 documentation + gcloud.datastore.key — gcloud 777c6ac documentation @@ -15,7 +15,7 @@ - + @@ -59,7 +59,7 @@

    - + Report an Issue @@ -73,7 +73,7 @@

    Python

    @@ -562,8 +562,8 @@

    Source code for gcloud.datastore.key

     
  • ACL
  • Pub/Sub
  • Using the API
  • -
  • Subscriptions
  • Topics
  • +
  • Subscriptions
  • BigQuery
  • diff --git a/latest/_modules/gcloud/datastore/query.html b/latest/_modules/gcloud/datastore/query.html index 542b3b92ca2a..9958907e4674 100644 --- a/latest/_modules/gcloud/datastore/query.html +++ b/latest/_modules/gcloud/datastore/query.html @@ -5,7 +5,7 @@ - gcloud.datastore.query — gcloud 0.7.0 documentation + gcloud.datastore.query — gcloud 777c6ac documentation @@ -15,7 +15,7 @@ - + @@ -59,7 +59,7 @@

    - + Report an Issue @@ -73,7 +73,7 @@

    Python

    @@ -422,7 +422,31 @@

    Source code for gcloud.datastore.query

     
     
    [docs]class Iterator(object): - """Represent the state of a given execution of a Query.""" + """Represent the state of a given execution of a Query. + + :type query: :class:`gcloud.datastore.query.Query` + :param query: Query object holding permanent configuration (i.e. + things that don't change on with each page in + a results set). + + :type client: :class:`gcloud.datastore.client.Client` + :param client: The client used to make a request. + + :type limit: integer + :param limit: (Optional) Limit the number of results returned. + + :type offset: integer + :param offset: (Optional) Defaults to 0. Offset used to begin + a query. + + :type start_cursor: bytes + :param start_cursor: (Optional) Cursor to begin paging through + query results. + + :type end_cursor: bytes + :param end_cursor: (Optional) Cursor to end paging through + query results. + """ _NOT_FINISHED = datastore_pb.QueryResultBatch.NOT_FINISHED @@ -597,8 +621,8 @@

    Source code for gcloud.datastore.query

     
  • ACL
  • Pub/Sub
  • Using the API
  • -
  • Subscriptions
  • Topics
  • +
  • Subscriptions
  • BigQuery
  • diff --git a/latest/_modules/gcloud/datastore/transaction.html b/latest/_modules/gcloud/datastore/transaction.html index 5bd2067b71c0..97ee1d476405 100644 --- a/latest/_modules/gcloud/datastore/transaction.html +++ b/latest/_modules/gcloud/datastore/transaction.html @@ -5,7 +5,7 @@ - gcloud.datastore.transaction — gcloud 0.7.0 documentation + gcloud.datastore.transaction — gcloud 777c6ac documentation @@ -15,7 +15,7 @@ - + @@ -59,7 +59,7 @@

    - + Report an Issue @@ -73,7 +73,7 @@

    Python

    @@ -281,8 +281,8 @@

    Source code for gcloud.datastore.transaction

    ACL
     
  • Pub/Sub
  • Using the API
  • -
  • Subscriptions
  • Topics
  • +
  • Subscriptions
  • BigQuery
  • diff --git a/latest/_modules/gcloud/exceptions.html b/latest/_modules/gcloud/exceptions.html index ae2128526e57..d9dca18b13f7 100644 --- a/latest/_modules/gcloud/exceptions.html +++ b/latest/_modules/gcloud/exceptions.html @@ -5,7 +5,7 @@ - gcloud.exceptions — gcloud 0.7.0 documentation + gcloud.exceptions — gcloud 777c6ac documentation @@ -15,7 +15,7 @@ - + @@ -59,7 +59,7 @@

    - + Report an Issue @@ -73,7 +73,7 @@

    Python

    @@ -326,8 +326,8 @@

    Source code for gcloud.exceptions

     
  • ACL
  • Pub/Sub
  • Using the API
  • -
  • Subscriptions
  • Topics
  • +
  • Subscriptions
  • BigQuery
  • diff --git a/latest/_modules/gcloud/pubsub/client.html b/latest/_modules/gcloud/pubsub/client.html index 69f1a97e5c5d..f675ae7de5c9 100644 --- a/latest/_modules/gcloud/pubsub/client.html +++ b/latest/_modules/gcloud/pubsub/client.html @@ -5,7 +5,7 @@ - gcloud.pubsub.client — gcloud 0.7.0 documentation + gcloud.pubsub.client — gcloud 777c6ac documentation @@ -15,7 +15,7 @@ - + @@ -59,7 +59,7 @@

    - + Report an Issue @@ -73,7 +73,7 @@

    Python

    @@ -253,8 +253,8 @@

    Source code for gcloud.pubsub.client

     
  • ACL
  • Pub/Sub
  • Using the API
  • -
  • Subscriptions
  • Topics
  • +
  • Subscriptions
  • BigQuery
  • diff --git a/latest/_modules/gcloud/pubsub/connection.html b/latest/_modules/gcloud/pubsub/connection.html index f789fbab8259..b37fbafdfce9 100644 --- a/latest/_modules/gcloud/pubsub/connection.html +++ b/latest/_modules/gcloud/pubsub/connection.html @@ -5,7 +5,7 @@ - gcloud.pubsub.connection — gcloud 0.7.0 documentation + gcloud.pubsub.connection — gcloud 777c6ac documentation @@ -15,7 +15,7 @@ - + @@ -59,7 +59,7 @@

    - + Report an Issue @@ -73,7 +73,7 @@

    Python

    @@ -146,8 +146,8 @@

    Source code for gcloud.pubsub.connection

     
  • ACL
  • Pub/Sub
  • Using the API
  • -
  • Subscriptions
  • Topics
  • +
  • Subscriptions
  • BigQuery
  • diff --git a/latest/_modules/gcloud/pubsub/subscription.html b/latest/_modules/gcloud/pubsub/subscription.html index c2b1f3af4148..3a326b943a8b 100644 --- a/latest/_modules/gcloud/pubsub/subscription.html +++ b/latest/_modules/gcloud/pubsub/subscription.html @@ -5,7 +5,7 @@ - gcloud.pubsub.subscription — gcloud 0.7.0 documentation + gcloud.pubsub.subscription — gcloud 777c6ac documentation @@ -15,7 +15,7 @@ - + @@ -59,7 +59,7 @@

    - + Report an Issue @@ -73,7 +73,7 @@

    Python

    @@ -372,8 +372,8 @@

    Source code for gcloud.pubsub.subscription

     
  • ACL
  • Pub/Sub
  • Using the API
  • -
  • Subscriptions
  • Topics
  • +
  • Subscriptions
  • BigQuery
  • diff --git a/latest/_modules/gcloud/pubsub/topic.html b/latest/_modules/gcloud/pubsub/topic.html index 985b8a3b0cab..06bcf1a05169 100644 --- a/latest/_modules/gcloud/pubsub/topic.html +++ b/latest/_modules/gcloud/pubsub/topic.html @@ -5,7 +5,7 @@ - gcloud.pubsub.topic — gcloud 0.7.0 documentation + gcloud.pubsub.topic — gcloud 777c6ac documentation @@ -15,7 +15,7 @@ - + @@ -59,7 +59,7 @@

    - + Report an Issue @@ -73,7 +73,7 @@

    Python

    @@ -379,8 +379,8 @@

    Source code for gcloud.pubsub.topic

     
  • ACL
  • Pub/Sub
  • Using the API
  • -
  • Subscriptions
  • Topics
  • +
  • Subscriptions
  • BigQuery
  • diff --git a/latest/_modules/gcloud/storage/acl.html b/latest/_modules/gcloud/storage/acl.html index 26013d719c67..debc9c75933c 100644 --- a/latest/_modules/gcloud/storage/acl.html +++ b/latest/_modules/gcloud/storage/acl.html @@ -5,7 +5,7 @@ - gcloud.storage.acl — gcloud 0.7.0 documentation + gcloud.storage.acl — gcloud 777c6ac documentation @@ -15,7 +15,7 @@ - + @@ -59,7 +59,7 @@

    - + Report an Issue @@ -73,7 +73,7 @@

    Python

    @@ -597,8 +597,8 @@

    Source code for gcloud.storage.acl

     
  • ACL
  • Pub/Sub
  • Using the API
  • -
  • Subscriptions
  • Topics
  • +
  • Subscriptions
  • BigQuery
  • diff --git a/latest/_modules/gcloud/storage/blob.html b/latest/_modules/gcloud/storage/blob.html index a03012a1916f..a7964339b1ce 100644 --- a/latest/_modules/gcloud/storage/blob.html +++ b/latest/_modules/gcloud/storage/blob.html @@ -5,7 +5,7 @@ - gcloud.storage.blob — gcloud 0.7.0 documentation + gcloud.storage.blob — gcloud 777c6ac documentation @@ -15,7 +15,7 @@ - + @@ -59,7 +59,7 @@

    - + Report an Issue @@ -73,7 +73,7 @@

    Python

    @@ -928,8 +928,8 @@

    Source code for gcloud.storage.blob

     
  • ACL
  • Pub/Sub
  • Using the API
  • -
  • Subscriptions
  • Topics
  • +
  • Subscriptions
  • BigQuery
  • diff --git a/latest/_modules/gcloud/storage/bucket.html b/latest/_modules/gcloud/storage/bucket.html index 91549ae9a258..6003360b858d 100644 --- a/latest/_modules/gcloud/storage/bucket.html +++ b/latest/_modules/gcloud/storage/bucket.html @@ -5,7 +5,7 @@ - gcloud.storage.bucket — gcloud 0.7.0 documentation + gcloud.storage.bucket — gcloud 777c6ac documentation @@ -15,7 +15,7 @@ - + @@ -59,7 +59,7 @@

    - + Report an Issue @@ -73,7 +73,7 @@

    Python

    @@ -105,7 +105,6 @@

    Source code for gcloud.storage.bucket

     
     import datetime
     import copy
    -import os
     
     import pytz
     import six
    @@ -188,6 +187,31 @@ 

    Source code for gcloud.storage.bucket

         def __repr__(self):
             return '<Bucket: %s>' % self.name
     
    +    @property
    +    def client(self):
    +        """The client bound to this bucket."""
    +        return self._client
    +
    +
    [docs] def blob(self, blob_name, chunk_size=None): + """Factory constructor for blob object. + + .. note:: + This will not make an HTTP request; it simply instantiates + a blob object owned by this bucket. + + :type blob_name: string + :param blob_name: The name of the blob to be instantiated. + + :type chunk_size: integer + :param chunk_size: The size of a chunk of data whenever iterating + (1 MB). This must be a multiple of 256 KB per the + API specification. + + :rtype: :class:`gcloud.storage.blob.Blob` + :returns: The blob object created. + """ + return Blob(name=blob_name, bucket=self, chunk_size=chunk_size) +
    [docs] def exists(self, client=None): """Determines whether or not this bucket exists. @@ -267,11 +291,6 @@

    Source code for gcloud.storage.bucket

     
             return self.path_helper(self.name)
     
    -    @property
    -    def client(self):
    -        """The client bound to this bucket."""
    -        return self._client
    -
     
    [docs] def get_blob(self, blob_name, client=None): """Get a blob object by name. @@ -530,98 +549,6 @@

    Source code for gcloud.storage.bucket

                 method='POST', path=api_path, _target_object=new_blob)
             new_blob._set_properties(copy_result)
             return new_blob
    -
    -
    [docs] def upload_file(self, filename, blob_name=None, client=None): - """Shortcut method to upload a file into this bucket. - - Use this method to quickly put a local file in Cloud Storage. - - For example:: - - >>> from gcloud import storage - >>> client = storage.Client() - >>> bucket = client.get_bucket('my-bucket') - >>> bucket.upload_file('~/my-file.txt', 'remote-text-file.txt') - >>> print bucket.list_blobs() - [<Blob: my-bucket, remote-text-file.txt>] - - If you don't provide a blob name, we will try to upload the file - using the local filename (**not** the complete path):: - - >>> from gcloud import storage - >>> client = storage.Client() - >>> bucket = client.get_bucket('my-bucket') - >>> bucket.upload_file('~/my-file.txt') - >>> print bucket.list_blobs() - [<Blob: my-bucket, my-file.txt>] - - :type filename: string - :param filename: Local path to the file you want to upload. - - :type blob_name: string - :param blob_name: The name of the blob to upload the file to. If this - is blank, we will try to upload the file to the root - of the bucket with the same name as on your local - file system. - - :type client: :class:`gcloud.storage.client.Client` or ``NoneType`` - :param client: Optional. The client to use. If not passed, falls back - to the ``client`` stored on the current bucket. - - :rtype: :class:`Blob` - :returns: The updated Blob object. - """ - if blob_name is None: - blob_name = os.path.basename(filename) - blob = Blob(bucket=self, name=blob_name) - blob.upload_from_filename(filename, client=client) - return blob -
    -
    [docs] def upload_file_object(self, file_obj, blob_name=None, client=None): - """Shortcut method to upload a file object into this bucket. - - Use this method to quickly put a local file in Cloud Storage. - - For example:: - - >>> from gcloud import storage - >>> client = storage.Client() - >>> bucket = client.get_bucket('my-bucket') - >>> bucket.upload_file(open('~/my-file.txt'), 'remote-text-file.txt') - >>> print bucket.list_blobs() - [<Blob: my-bucket, remote-text-file.txt>] - - If you don't provide a blob name, we will try to upload the file - using the local filename (**not** the complete path):: - - >>> from gcloud import storage - >>> client = storage.Client() - >>> bucket = client.get_bucket('my-bucket') - >>> bucket.upload_file(open('~/my-file.txt')) - >>> print bucket.list_blobs() - [<Blob: my-bucket, my-file.txt>] - - :type file_obj: file - :param file_obj: A file handle open for reading. - - :type blob_name: string - :param blob_name: The name of the blob to upload the file to. If this - is blank, we will try to upload the file to the root - of the bucket with the same name as on your local - file system. - - :type client: :class:`gcloud.storage.client.Client` or ``NoneType`` - :param client: Optional. The client to use. If not passed, falls back - to the ``client`` stored on the current bucket. - - :rtype: :class:`Blob` - :returns: The updated Blob object. - """ - if blob_name is None: - blob_name = os.path.basename(file_obj.name) - blob = Blob(bucket=self, name=blob_name) - blob.upload_from_file(file_obj, client=client) - return blob
    @property def cors(self): @@ -962,8 +889,8 @@

    Source code for gcloud.storage.bucket

     
  • ACL
  • Pub/Sub
  • Using the API
  • -
  • Subscriptions
  • Topics
  • +
  • Subscriptions
  • BigQuery
  • diff --git a/latest/_modules/gcloud/storage/connection.html b/latest/_modules/gcloud/storage/connection.html index b460f0f87574..0a203a78b1e6 100644 --- a/latest/_modules/gcloud/storage/connection.html +++ b/latest/_modules/gcloud/storage/connection.html @@ -5,7 +5,7 @@ - gcloud.storage.connection — gcloud 0.7.0 documentation + gcloud.storage.connection — gcloud 777c6ac documentation @@ -15,7 +15,7 @@ - + @@ -59,7 +59,7 @@

    - + Report an Issue @@ -73,7 +73,7 @@

    Python

    @@ -147,8 +147,8 @@

    Source code for gcloud.storage.connection

     
  • ACL
  • Pub/Sub
  • Using the API
  • -
  • Subscriptions
  • Topics
  • +
  • Subscriptions
  • BigQuery
  • diff --git a/latest/_modules/index.html b/latest/_modules/index.html index eb44902102ce..3b594d7c4c39 100644 --- a/latest/_modules/index.html +++ b/latest/_modules/index.html @@ -5,7 +5,7 @@ - Overview: module code — gcloud 0.7.0 documentation + Overview: module code — gcloud 777c6ac documentation @@ -15,7 +15,7 @@ - +