Oslogin: add 'synth.py'. (#6086)

Closes #6074.

oslogin/google/cloud/oslogin_v1/__init__.py

@@ -1,3 +1,5 @@
+# -*- coding: utf-8 -*-
+#
 # Copyright 2018 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

oslogin/google/cloud/oslogin_v1/gapic/transports/os_login_service_grpc_transport.py

@@ -0,0 +1,180 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright 2018 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import google.api_core.grpc_helpers
+
+from google.cloud.oslogin_v1.proto import oslogin_pb2_grpc
+
+
+class OsLoginServiceGrpcTransport(object):
+    """gRPC transport class providing stubs for
+    google.cloud.oslogin.v1 OsLoginService API.
+
+    The transport provides access to the raw gRPC stubs,
+    which can be used to take advantage of advanced
+    features of gRPC.
+    """
+    # The scopes needed to make gRPC calls to all of the methods defined
+    # in this service.
+    _OAUTH_SCOPES = (
+        'https://www.googleapis.com/auth/cloud-platform',
+        'https://www.googleapis.com/auth/cloud-platform.read-only',
+        'https://www.googleapis.com/auth/compute',
+        'https://www.googleapis.com/auth/compute.readonly',
+    )
+
+    def __init__(self,
+                 channel=None,
+                 credentials=None,
+                 address='oslogin.googleapis.com:443'):
+        """Instantiate the transport class.
+
+        Args:
+            channel (grpc.Channel): A ``Channel`` instance through
+                which to make calls. This argument is mutually exclusive
+                with ``credentials``; providing both will raise an exception.
+            credentials (google.auth.credentials.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            address (str): The address where the service is hosted.
+        """
+        # If both `channel` and `credentials` are specified, raise an
+        # exception (channels come with credentials baked in already).
+        if channel is not None and credentials is not None:
+            raise ValueError(
+                'The `channel` and `credentials` arguments are mutually '
+                'exclusive.', )
+
+        # Create the channel.
+        if channel is None:
+            channel = self.create_channel(
+                address=address,
+                credentials=credentials,
+            )
+
+        # gRPC uses objects called "stubs" that are bound to the
+        # channel and provide a basic method for each RPC.
+        self._stubs = {
+            'os_login_service_stub':
+            oslogin_pb2_grpc.OsLoginServiceStub(channel),
+        }
+
+    @classmethod
+    def create_channel(cls,
+                       address='oslogin.googleapis.com:443',
+                       credentials=None):
+        """Create and return a gRPC channel object.
+
+        Args:
+            address (str): The host for the channel to use.
+            credentials (~.Credentials): The
+                authorization credentials to attach to requests. These
+                credentials identify this application to the service. If
+                none are specified, the client will attempt to ascertain
+                the credentials from the environment.
+
+        Returns:
+            grpc.Channel: A gRPC channel object.
+        """
+        return google.api_core.grpc_helpers.create_channel(
+            address,
+            credentials=credentials,
+            scopes=cls._OAUTH_SCOPES,
+        )
+
+    @property
+    def delete_posix_account(self):
+        """Return the gRPC stub for {$apiMethod.name}.
+
+        Deletes a POSIX account.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs['os_login_service_stub'].DeletePosixAccount
+
+    @property
+    def delete_ssh_public_key(self):
+        """Return the gRPC stub for {$apiMethod.name}.
+
+        Deletes an SSH public key.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs['os_login_service_stub'].DeleteSshPublicKey
+
+    @property
+    def get_login_profile(self):
+        """Return the gRPC stub for {$apiMethod.name}.
+
+        Retrieves the profile information used for logging in to a virtual machine
+        on Google Compute Engine.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs['os_login_service_stub'].GetLoginProfile
+
+    @property
+    def get_ssh_public_key(self):
+        """Return the gRPC stub for {$apiMethod.name}.
+
+        Retrieves an SSH public key.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs['os_login_service_stub'].GetSshPublicKey
+
+    @property
+    def import_ssh_public_key(self):
+        """Return the gRPC stub for {$apiMethod.name}.
+
+        Adds an SSH public key and returns the profile information. Default POSIX
+        account information is set when no username and UID exist as part of the
+        login profile.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs['os_login_service_stub'].ImportSshPublicKey
+
+    @property
+    def update_ssh_public_key(self):
+        """Return the gRPC stub for {$apiMethod.name}.
+
+        Updates an SSH public key and returns the profile information. This method
+        supports patch semantics.
+
+        Returns:
+            Callable: A callable which accepts the appropriate
+                deserialized request object and returns a
+                deserialized response object.
+        """
+        return self._stubs['os_login_service_stub'].UpdateSshPublicKey