Update pubsub samples [(#1092)](GoogleCloudPlatform/python-docs-sampl…

…es#1092)

samples/snippets/iam.py

@@ -23,122 +23,121 @@
 
 import argparse
 
-from google.cloud import pubsub
+from google.cloud import pubsub_v1
 
 
-def get_topic_policy(topic_name):
+def get_topic_policy(project, topic_name):
     """Prints the IAM policy for the given topic."""
-    pubsub_client = pubsub.Client()
-    topic = pubsub_client.topic(topic_name)
+    client = pubsub_v1.PublisherClient()
+    topic_path = client.topic_path(project, topic_name)
 
-    policy = topic.get_iam_policy()
+    policy = client.get_iam_policy(topic_path)
 
-    print('Policy for topic {}:'.format(topic.name))
-    print('Version: {}'.format(policy.version))
-    print('Owners: {}'.format(policy.owners))
-    print('Editors: {}'.format(policy.editors))
-    print('Viewers: {}'.format(policy.viewers))
-    print('Publishers: {}'.format(policy.publishers))
-    print('Subscribers: {}'.format(policy.subscribers))
+    print('Policy for topic {}:'.format(topic_path))
+    for binding in policy.bindings:
+        print('Role: {}, Members: {}'.format(binding.role, binding.members))
 
 
-def get_subscription_policy(topic_name, subscription_name):
+def get_subscription_policy(project, subscription_name):
     """Prints the IAM policy for the given subscription."""
-    pubsub_client = pubsub.Client()
-    topic = pubsub_client.topic(topic_name)
-    subscription = topic.subscription(subscription_name)
+    client = pubsub_v1.SubscriberClient()
+    subscription_path = client.subscription_path(project, subscription_name)
 
-    policy = subscription.get_iam_policy()
+    policy = client.get_iam_policy(subscription_path)
 
-    print('Policy for subscription {} on topic {}:'.format(
-        subscription.name, topic.name))
-    print('Version: {}'.format(policy.version))
-    print('Owners: {}'.format(policy.owners))
-    print('Editors: {}'.format(policy.editors))
-    print('Viewers: {}'.format(policy.viewers))
-    print('Publishers: {}'.format(policy.publishers))
-    print('Subscribers: {}'.format(policy.subscribers))
+    print('Policy for subscription {}:'.format(subscription_path))
+    for binding in policy.bindings:
+        print('Role: {}, Members: {}'.format(binding.role, binding.members))
 
 
-def set_topic_policy(topic_name):
+def set_topic_policy(project, topic_name):
     """Sets the IAM policy for a topic."""
-    pubsub_client = pubsub.Client()
-    topic = pubsub_client.topic(topic_name)
-    policy = topic.get_iam_policy()
+    client = pubsub_v1.PublisherClient()
+    topic_path = client.topic_path(project, topic_name)
+
+    policy = client.get_iam_policy(topic_path)
 
     # Add all users as viewers.
-    policy['roles/pubsub.viewer'] = [policy.all_users()]
-    # Add a group as publisherss.
-    publishers = policy.get('roles/pubsub.publisher', [])
-    publishers.add(policy.group('cloud-logs@google.com'))
-    policy['roles/pubsub.publisher'] = publishers
+    policy.bindings.add(
+        role='roles/pubsub.viewer',
+        members=['allUsers'])
+
+    # Add a group as a publisher.
+    policy.bindings.add(
+        role='roles/pubsub.publisher',
+        members=['group:cloud-logs@google.com'])
 
     # Set the policy
-    topic.set_iam_policy(policy)
+    policy = client.set_iam_policy(topic_path, policy)
 
-    print('IAM policy for topic {} set.'.format(topic.name))
+    print('IAM policy for topic {} set: {}'.format(
+        topic_name, policy))
 
 
-def set_subscription_policy(topic_name, subscription_name):
+def set_subscription_policy(project, subscription_name):
     """Sets the IAM policy for a topic."""
-    pubsub_client = pubsub.Client()
-    topic = pubsub_client.topic(topic_name)
-    subscription = topic.subscription(subscription_name)
-    policy = subscription.get_iam_policy()
+    client = pubsub_v1.SubscriberClient()
+    subscription_path = client.subscription_path(project, subscription_name)
+
+    policy = client.get_iam_policy(subscription_path)
 
     # Add all users as viewers.
-    policy['roles/viewer'] = [policy.all_users()]
-    # # Add a group as editors.
-    editors = policy.get('roles/editor', [])
-    editors.add(policy.group('cloud-logs@google.com'))
-    policy['roles/editor'] = editors
+    policy.bindings.add(
+        role='roles/pubsub.viewer',
+        members=['allUsers'])
+
+    # Add a group as an editor.
+    policy.bindings.add(
+        role='roles/editor',
+        members=['group:cloud-logs@google.com'])
 
     # Set the policy
-    subscription.set_iam_policy(policy)
+    policy = client.set_iam_policy(subscription_path, policy)
 
-    print('IAM policy for subscription {} on topic {} set.'.format(
-        topic.name, subscription.name))
+    print('IAM policy for subscription {} set: {}'.format(
+        subscription_name, policy))
 
 
-def check_topic_permissions(topic_name):
+def check_topic_permissions(project, topic_name):
     """Checks to which permissions are available on the given topic."""
-    pubsub_client = pubsub.Client()
-    topic = pubsub_client.topic(topic_name)
+    client = pubsub_v1.PublisherClient()
+    topic_path = client.topic_path(project, topic_name)
 
     permissions_to_check = [
         'pubsub.topics.publish',
         'pubsub.topics.update'
     ]
 
-    allowed_permissions = topic.check_iam_permissions(permissions_to_check)
+    allowed_permissions = client.test_iam_permissions(
+        topic_path, permissions_to_check)
 
     print('Allowed permissions for topic {}: {}'.format(
-        topic.name, allowed_permissions))
+        topic_path, allowed_permissions))
 
 
-def check_subscription_permissions(topic_name, subscription_name):
+def check_subscription_permissions(project, subscription_name):
     """Checks to which permissions are available on the given subscription."""
-    pubsub_client = pubsub.Client()
-    topic = pubsub_client.topic(topic_name)
-    subscription = topic.subscription(subscription_name)
+    client = pubsub_v1.SubscriberClient()
+    subscription_path = client.subscription_path(project, subscription_name)
 
     permissions_to_check = [
         'pubsub.subscriptions.consume',
         'pubsub.subscriptions.update'
     ]
 
-    allowed_permissions = subscription.check_iam_permissions(
-        permissions_to_check)
+    allowed_permissions = client.test_iam_permissions(
+        subscription_path, permissions_to_check)
 
-    print('Allowed permissions for subscription {} on topic {}: {}'.format(
-        subscription.name, topic.name, allowed_permissions))
+    print('Allowed permissions for subscription {}: {}'.format(
+        subscription_path, allowed_permissions))
 
 
 if __name__ == '__main__':
     parser = argparse.ArgumentParser(
         description=__doc__,
         formatter_class=argparse.RawDescriptionHelpFormatter
     )
+    parser.add_argument('project', help='Your Google Cloud project ID')
 
     subparsers = parser.add_subparsers(dest='command')
 
@@ -148,7 +147,6 @@ def check_subscription_permissions(topic_name, subscription_name):
 
     get_subscription_policy_parser = subparsers.add_parser(
         'get-subscription-policy', help=get_subscription_policy.__doc__)
-    get_subscription_policy_parser.add_argument('topic_name')
     get_subscription_policy_parser.add_argument('subscription_name')
 
     set_topic_policy_parser = subparsers.add_parser(
@@ -157,7 +155,6 @@ def check_subscription_permissions(topic_name, subscription_name):
 
     set_subscription_policy_parser = subparsers.add_parser(
         'set-subscription-policy', help=set_subscription_policy.__doc__)
-    set_subscription_policy_parser.add_argument('topic_name')
     set_subscription_policy_parser.add_argument('subscription_name')
 
     check_topic_permissions_parser = subparsers.add_parser(
@@ -167,20 +164,19 @@ def check_subscription_permissions(topic_name, subscription_name):
     check_subscription_permissions_parser = subparsers.add_parser(
         'check-subscription-permissions',
         help=check_subscription_permissions.__doc__)
-    check_subscription_permissions_parser.add_argument('topic_name')
     check_subscription_permissions_parser.add_argument('subscription_name')
 
     args = parser.parse_args()
 
     if args.command == 'get-topic-policy':
-        get_topic_policy(args.topic_name)
+        get_topic_policy(args.project, args.topic_name)
     elif args.command == 'get-subscription-policy':
-        get_subscription_policy(args.topic_name, args.subscription_name)
+        get_subscription_policy(args.project, args.subscription_name)
     elif args.command == 'set-topic-policy':
-        set_topic_policy(args.topic_name)
+        set_topic_policy(args.project, args.topic_name)
     elif args.command == 'set-subscription-policy':
-        set_subscription_policy(args.topic_name, args.subscription_name)
+        set_subscription_policy(args.project, args.subscription_name)
     elif args.command == 'check-topic-permissions':
-        check_topic_permissions(args.topic_name)
+        check_topic_permissions(args.project, args.topic_name)
     elif args.command == 'check-subscription-permissions':
-        check_subscription_permissions(args.topic_name, args.subscription_name)
+        check_subscription_permissions(args.project, args.subscription_name)

samples/snippets/iam_test.py

@@ -12,94 +12,100 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from google.cloud import pubsub
+import os
+
+from google.cloud import pubsub_v1
 import pytest
 
 import iam
 
-TEST_TOPIC = 'iam-test-topic'
-TEST_SUBSCRIPTION = 'iam-test-subscription'
+PROJECT = os.environ['GCLOUD_PROJECT']
+TOPIC = 'iam-test-topic'
+SUBSCRIPTION = 'iam-test-subscription'
 
 
 @pytest.fixture(scope='module')
-def test_topic():
-    client = pubsub.Client()
-    topic = client.topic(TEST_TOPIC)
+def publisher_client():
+    yield pubsub_v1.PublisherClient()
 
-    if not topic.exists():
-        topic.create()
 
-    yield topic
+@pytest.fixture(scope='module')
+def topic(publisher_client):
+    topic_path = publisher_client.topic_path(PROJECT, TOPIC)
 
-    if topic.exists():
-        topic.delete()
+    try:
+        publisher_client.delete_topic(topic_path)
+    except:
+        pass
 
+    publisher_client.create_topic(topic_path)
 
-@pytest.fixture
-def test_subscription(test_topic):
-    subscription = test_topic.subscription(TEST_SUBSCRIPTION)
-    yield subscription
-    if subscription.exists():
-        subscription.delete()
+    yield topic_path
 
 
-def test_get_topic_policy(test_topic, capsys):
-    iam.get_topic_policy(test_topic.name)
+@pytest.fixture(scope='module')
+def subscriber_client():
+    yield pubsub_v1.SubscriberClient()
 
-    out, _ = capsys.readouterr()
-    assert test_topic.name in out
 
+@pytest.fixture
+def subscription(subscriber_client, topic):
+    subscription_path = subscriber_client.subscription_path(
+        PROJECT, SUBSCRIPTION)
+
+    try:
+        subscriber_client.delete_subscription(subscription_path)
+    except:
+        pass
 
-def test_get_subscription_policy(test_subscription, capsys):
-    test_subscription.create()
+    subscriber_client.create_subscription(subscription_path, topic=topic)
 
-    iam.get_subscription_policy(
-        test_subscription.topic.name,
-        test_subscription.name)
+    yield subscription_path
+
+
+def test_get_topic_policy(topic, capsys):
+    iam.get_topic_policy(PROJECT, TOPIC)
 
     out, _ = capsys.readouterr()
-    assert test_subscription.topic.name in out
-    assert test_subscription.name in out
+    assert topic in out
+
 
+def test_get_subscription_policy(subscription, capsys):
+    iam.get_subscription_policy(PROJECT, SUBSCRIPTION)
+
+    out, _ = capsys.readouterr()
+    assert subscription in out
 
-def test_set_topic_policy(test_topic):
-    iam.set_topic_policy(test_topic.name)
 
-    policy = test_topic.get_iam_policy()
-    assert policy.viewers
-    assert policy['roles/pubsub.publisher']
+def test_set_topic_policy(publisher_client, topic):
+    iam.set_topic_policy(PROJECT, TOPIC)
 
+    policy = publisher_client.get_iam_policy(topic)
+    assert 'roles/pubsub.publisher' in str(policy)
+    assert 'allUsers' in str(policy)
 
-def test_set_subscription_policy(test_subscription):
-    test_subscription.create()
 
-    iam.set_subscription_policy(
-        test_subscription.topic.name,
-        test_subscription.name)
+def test_set_subscription_policy(subscriber_client, subscription):
+    iam.set_subscription_policy(PROJECT, SUBSCRIPTION)
 
-    policy = test_subscription.get_iam_policy()
-    assert policy.viewers
-    assert policy.editors
+    policy = subscriber_client.get_iam_policy(subscription)
+    assert 'roles/pubsub.viewer' in str(policy)
+    assert 'allUsers' in str(policy)
 
 
-def test_check_topic_permissions(test_topic, capsys):
-    iam.check_topic_permissions(test_topic.name)
+def test_check_topic_permissions(topic, capsys):
+    iam.check_topic_permissions(PROJECT, TOPIC)
 
     out, _ = capsys.readouterr()
 
-    assert test_topic.name in out
+    assert topic in out
     assert 'pubsub.topics.publish' in out
 
 
-def test_check_subscription_permissions(test_subscription, capsys):
-    test_subscription.create()
-
-    iam.check_subscription_permissions(
-        test_subscription.topic.name,
-        test_subscription.name)
+def test_check_subscription_permissions(subscription, capsys):
+    iam.check_subscription_permissions(PROJECT, SUBSCRIPTION)
 
     out, _ = capsys.readouterr()
 
-    assert test_subscription.topic.name in out
-    assert test_subscription.name in out
+    assert subscription in out
     assert 'pubsub.subscriptions.consume' in out