Pubsub basic API broken

[kardamom]

In 0.28.1:
Python 3.6.1 (v3.6.1:69c0db5050, Mar 21 2017, 01:21:04)
[GCC 4.2.1 (Apple Inc. build 5666) (dot 3)] on darwin
Type "help", "copyright", "credits" or "license" for more information.

from google.cloud import pubsub
cl = pubsub.Client()
Traceback (most recent call last):
File "", line 1, in
AttributeError: module 'google.cloud.pubsub' has no attribute 'Client'

In 0.27:
Python 3.6.1 (v3.6.1:69c0db5050, Mar 21 2017, 01:21:04)
[GCC 4.2.1 (Apple Inc. build 5666) (dot 3)] on darwin
Type "help", "copyright", "credits" or "license" for more information.

from google.cloud import pubsub
cl = pubsub.Client()
quit()

[lukesneeringer]

Actually, this is not an error. We made a very sweeping change to the API (primarily at the request of the Pub/Sub team), as noted in the release notes.

The documentation on the new surface is here.

[lukesneeringer]

Hey @kardamom, I saw you made a comment in #3863 that the API was ahead of the docs -- did I miss a link somewhere?

[kardamom]

'Using the API': https://github.com/GoogleCloudPlatform/google-cloud-python/tree/master/pubsub

[lukesneeringer]

Sure enough, I missed one. #3876 filed to update it, will merge when CI goes green.