Fix client_info bug, update docstrings. (#6414)

googleapis · Nov 6, 2018 · 3d47b72 · 3d47b72
1 parent 1985e8b
commit 3d47b72
Show file tree

Hide file tree

Showing 3 changed files with 151 additions and 175 deletions.
diff --git a/packages/google-cloud-kms/google/cloud/kms_v1/gapic/enums.py b/packages/google-cloud-kms/google/cloud/kms_v1/gapic/enums.py
@@ -20,7 +20,8 @@
 
 class ProtectionLevel(enum.IntEnum):
     """
-    ``ProtectionLevel`` specifies how cryptographic operations are performed.
+    ``ProtectionLevel`` specifies how cryptographic operations are
+    performed.
 
     Attributes:
       PROTECTION_LEVEL_UNSPECIFIED (int): Not specified.
@@ -36,20 +37,17 @@ class CryptoKey(object):
     class CryptoKeyPurpose(enum.IntEnum):
         """
         ``CryptoKeyPurpose`` describes the cryptographic capabilities of a
-        ``CryptoKey``. A given key can only be used for the operations allowed by
-        its purpose.
+        ``CryptoKey``. A given key can only be used for the operations allowed
+        by its purpose.
 
         Attributes:
           CRYPTO_KEY_PURPOSE_UNSPECIFIED (int): Not specified.
-          ENCRYPT_DECRYPT (int): ``CryptoKeys`` with this purpose may be used with
-          ``Encrypt`` and
+          ENCRYPT_DECRYPT (int): ``CryptoKeys`` with this purpose may be used with ``Encrypt`` and
           ``Decrypt``.
-          ASYMMETRIC_SIGN (int): ``CryptoKeys`` with this purpose may be used with
-          ``AsymmetricSign`` and
-          ``GetPublicKey``.
-          ASYMMETRIC_DECRYPT (int): ``CryptoKeys`` with this purpose may be used with
-          ``AsymmetricDecrypt`` and
+          ASYMMETRIC_SIGN (int): ``CryptoKeys`` with this purpose may be used with ``AsymmetricSign`` and
           ``GetPublicKey``.
+          ASYMMETRIC_DECRYPT (int): ``CryptoKeys`` with this purpose may be used with ``AsymmetricDecrypt``
+          and ``GetPublicKey``.
         """
         CRYPTO_KEY_PURPOSE_UNSPECIFIED = 0
         ENCRYPT_DECRYPT = 1
@@ -74,36 +72,33 @@ class AttestationFormat(enum.IntEnum):
 class CryptoKeyVersion(object):
     class CryptoKeyVersionAlgorithm(enum.IntEnum):
         """
-        The algorithm of the ``CryptoKeyVersion``, indicating what
-        parameters must be used for each cryptographic operation.
+        The algorithm of the ``CryptoKeyVersion``, indicating what parameters
+        must be used for each cryptographic operation.
 
-        The
-        ``GOOGLE_SYMMETRIC_ENCRYPTION``
-        algorithm is usable with ``CryptoKey.purpose``
-        ``ENCRYPT_DECRYPT``.
+        The ``GOOGLE_SYMMETRIC_ENCRYPTION`` algorithm is usable with
+        ``CryptoKey.purpose`` ``ENCRYPT_DECRYPT``.
 
-        Algorithms beginning with \"RSA_SIGN_\" are usable with ``CryptoKey.purpose``
-        ``ASYMMETRIC_SIGN``.
+        Algorithms beginning with "RSA\_SIGN\_" are usable with
+        ``CryptoKey.purpose`` ``ASYMMETRIC_SIGN``.
 
-        The fields in the name after \"RSA_SIGN_\" correspond to the following
+        The fields in the name after "RSA\_SIGN\_" correspond to the following
         parameters: padding algorithm, modulus bit length, and digest algorithm.
 
         For PSS, the salt length used is equal to the length of digest
-        algorithm. For example,
-        ``RSA_SIGN_PSS_2048_SHA256``
-        will use PSS with a salt length of 256 bits or 32 bytes.
+        algorithm. For example, ``RSA_SIGN_PSS_2048_SHA256`` will use PSS with a
+        salt length of 256 bits or 32 bytes.
 
-        Algorithms beginning with \"RSA_DECRYPT_\" are usable with
-        ``CryptoKey.purpose``
-        ``ASYMMETRIC_DECRYPT``.
+        Algorithms beginning with "RSA\_DECRYPT\_" are usable with
+        ``CryptoKey.purpose`` ``ASYMMETRIC_DECRYPT``.
 
-        The fields in the name after \"RSA_DECRYPT_\" correspond to the following
-        parameters: padding algorithm, modulus bit length, and digest algorithm.
+        The fields in the name after "RSA\_DECRYPT\_" correspond to the
+        following parameters: padding algorithm, modulus bit length, and digest
+        algorithm.
 
-        Algorithms beginning with \"EC_SIGN_\" are usable with ``CryptoKey.purpose``
-        ``ASYMMETRIC_SIGN``.
+        Algorithms beginning with "EC\_SIGN\_" are usable with
+        ``CryptoKey.purpose`` ``ASYMMETRIC_SIGN``.
 
-        The fields in the name after \"EC_SIGN_\" correspond to the following
+        The fields in the name after "EC\_SIGN\_" correspond to the following
         parameters: elliptic curve, digest algorithm.
 
         Attributes:
@@ -112,9 +107,9 @@ class CryptoKeyVersionAlgorithm(enum.IntEnum):
           RSA_SIGN_PSS_2048_SHA256 (int): RSASSA-PSS 2048 bit key with a SHA256 digest.
           RSA_SIGN_PSS_3072_SHA256 (int): RSASSA-PSS 3072 bit key with a SHA256 digest.
           RSA_SIGN_PSS_4096_SHA256 (int): RSASSA-PSS 4096 bit key with a SHA256 digest.
-          RSA_SIGN_PKCS1_2048_SHA256 (int): RSASSA-PKCS1-v1_5 with a 2048 bit key and a SHA256 digest.
-          RSA_SIGN_PKCS1_3072_SHA256 (int): RSASSA-PKCS1-v1_5 with a 3072 bit key and a SHA256 digest.
-          RSA_SIGN_PKCS1_4096_SHA256 (int): RSASSA-PKCS1-v1_5 with a 4096 bit key and a SHA256 digest.
+          RSA_SIGN_PKCS1_2048_SHA256 (int): RSASSA-PKCS1-v1\_5 with a 2048 bit key and a SHA256 digest.
+          RSA_SIGN_PKCS1_3072_SHA256 (int): RSASSA-PKCS1-v1\_5 with a 3072 bit key and a SHA256 digest.
+          RSA_SIGN_PKCS1_4096_SHA256 (int): RSASSA-PKCS1-v1\_5 with a 4096 bit key and a SHA256 digest.
           RSA_DECRYPT_OAEP_2048_SHA256 (int): RSAES-OAEP 2048 bit key with a SHA256 digest.
           RSA_DECRYPT_OAEP_3072_SHA256 (int): RSAES-OAEP 3072 bit key with a SHA256 digest.
           RSA_DECRYPT_OAEP_4096_SHA256 (int): RSAES-OAEP 4096 bit key with a SHA256 digest.
@@ -150,9 +145,8 @@ class CryptoKeyVersionState(enum.IntEnum):
           DESTROYED (int): This version is destroyed, and the key material is no longer stored.
           A version may not leave this state once entered.
           DESTROY_SCHEDULED (int): This version is scheduled for destruction, and will be destroyed soon.
-          Call
-          ``RestoreCryptoKeyVersion``
-          to put it back into the ``DISABLED`` state.
+          Call ``RestoreCryptoKeyVersion`` to put it back into the ``DISABLED``
+          state.
         """
         CRYPTO_KEY_VERSION_STATE_UNSPECIFIED = 0
         PENDING_GENERATION = 5
@@ -163,14 +157,14 @@ class CryptoKeyVersionState(enum.IntEnum):
 
     class CryptoKeyVersionView(enum.IntEnum):
         """
-        A view for ``CryptoKeyVersion``s. Controls the level of detail returned
-        for ``CryptoKeyVersions`` in
+        A view for ``CryptoKeyVersion``\ s. Controls the level of detail
+        returned for ``CryptoKeyVersions`` in
         ``KeyManagementService.ListCryptoKeyVersions`` and
         ``KeyManagementService.ListCryptoKeys``.
 
         Attributes:
-          CRYPTO_KEY_VERSION_VIEW_UNSPECIFIED (int): Default view for each ``CryptoKeyVersion``. Does not include
-          the ``attestation`` field.
+          CRYPTO_KEY_VERSION_VIEW_UNSPECIFIED (int): Default view for each ``CryptoKeyVersion``. Does not include the
+          ``attestation`` field.
           FULL (int): Provides all fields in each ``CryptoKeyVersion``, including the
           ``attestation``.
         """