Update README.rst sample. (#3879)

lukesneeringer · web-flow · commit aef68ec284aa · 2017-08-24T16:17:37.000-07:00
diff --git a/README.rst b/README.rst
@@ -47,18 +47,67 @@ to Cloud Pub/Sub using this Client Library.
 
 .. _Pub/Sub documentation: http://google-cloud-python.readthedocs.io/en/latest/pubsub/index.html
 
-To get started with this API, you'll need to create
 
-.. code:: python
+Publishing
+----------
 
+To publish data to Cloud Pub/Sub you must create a topic, and then publish
+messages to it
+
+.. code-block:: python
+
+    import os
     from google.cloud import pubsub
 
-    client = pubsub.Client()
-    topic = client.topic('topic_name')
-    topic.create()
+    publisher = pubsub.PublisherClient()
+    topic = 'projects/{project_id}/topics/{topic}'.format(
+        project_id=os.getenv('GOOGLE_CLOUD_PROJECT'),
+        topic='MY_TOPIC_NAME',  # Set this to something appropriate.
+    )
+    publisher.create_topic()
+    publisher.publish(topic, b'My first message!', spam='eggs')
+
+To learn more, consult the :doc:`publishing documentation`_.
+
+.. _publishing documentation: http://google-cloud-python.readthedocs.io/en/latest/pubsub/publisher/index.html
+
+
+Subscribing
+-----------
+
+To subscribe to data in Cloud Pub/Sub, you create a subscription based on
+the topic, and subscribe to that.
+
+.. code-block:: python
+
+    import os
+    from google.cloud import pubsub
+
+    subscriber = pubsub.SubscriberClient()
+    topic = 'projects/{project_id}/topics/{topic}'.format(
+        project_id=os.getenv('GOOGLE_CLOUD_PROJECT'),
+        topic='MY_TOPIC_NAME',  # Set this to something appropriate.
+    )
+    subscription_name = 'projects/{project_id}/subscriptions/{sub}'.format(
+        project_id=os.getenv('GOOGLE_CLOUD_PROJECT'),
+        sub='MY_SUBSCRIPTION_NAME',  # Set this to something appropriate.
+    )
+    subscription = subscriber.create_subscription(topic, subscription)
+
+The subscription is opened asychronously, and messages are processed by
+use of a callback.
+
+.. code-block:: python
+
+    def callback(message):
+        print(message.data)
+        message.ack()
+    subscription.open(callback)
+
+To learn more, consult the :doc:`subscriber documentation`_.
+
+.. _subscriber documentation: http://google-cloud-python.readthedocs.io/en/latest/pubsub/subscriber/index.html
 
-    topic.publish('this is the message_payload',
-                  attr1='value1', attr2='value2')
 
 .. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-pubsub.svg
    :target: https://pypi.org/project/google-cloud-pubsub/
diff --git a/setup.py b/setup.py
@@ -61,7 +61,7 @@
 
 setup(
     name='google-cloud-pubsub',
-    version='0.28.1',
+    version='0.28.2',
     description='Python Client for Google Cloud Pub/Sub',
     long_description=README,
     namespace_packages=[
