{"action":"closed","issue":{"url":"https://api.github.com/repos/GoogleCloudPlatform/gcloud-python/issues/958","labels_url":"https://api.github.com/repos/GoogleCloudPlatform/gcloud-python/issues/958/labels{/name}","comments_url":"https://api.github.com/repos/GoogleCloudPlatform/gcloud-python/issues/958/comments","events_url":"https://api.github.com/repos/GoogleCloudPlatform/gcloud-python/issues/958/events","html_url":"https://github.com/GoogleCloudPlatform/gcloud-python/issues/958","id":92597664,"number":958,"title":"[Documentation Issue] Pub/Sub non-blocking pull subscription option is wrong.","user":{"login":"tomochikahara","id":1532891,"avatar_url":"https://avatars.githubusercontent.com/u/1532891?v=3","gravatar_id":"","url":"https://api.github.com/users/tomochikahara","html_url":"https://github.com/tomochikahara","followers_url":"https://api.github.com/users/tomochikahara/followers","following_url":"https://api.github.com/users/tomochikahara/following{/other_user}","gists_url":"https://api.github.com/users/tomochikahara/gists{/gist_id}","starred_url":"https://api.github.com/users/tomochikahara/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tomochikahara/subscriptions","organizations_url":"https://api.github.com/users/tomochikahara/orgs","repos_url":"https://api.github.com/users/tomochikahara/repos","events_url":"https://api.github.com/users/tomochikahara/events{/privacy}","received_events_url":"https://api.github.com/users/tomochikahara/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/GoogleCloudPlatform/gcloud-python/labels/docs","name":"docs","color":"0052cc"},{"url":"https://api.github.com/repos/GoogleCloudPlatform/gcloud-python/labels/pubsub","name":"pubsub","color":"eb6420"}],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-07-02T09:49:30Z","updated_at":"2015-07-02T16:16:51Z","closed_at":"2015-07-02T16:16:51Z","body":"Page Name: pubsub-usage\r\nRelease: 0.6.0\r\n\r\nThe bottommost one.\r\n\r\n```diff\r\nFetch messages for a pull subscription without blocking (none pending):\r\n\r\n>>> from gcloud.pubsub import Topic\r\n>>> from gcloud.pubsub import Subscription\r\n>>> topic = Topic('topic_name')\r\n>>> subscription = Subscription('subscription_name', topic)\r\n- >>> received = subscription.pull(max_messages=1)  # API request\r\n+ >>> received = subscription.pull(return_immediately=True)  # API request\r\n>>> messages = [recv[1] for recv in received]\r\n>>> [message.id for message in messages]\r\n[]\r\n```"}}