adding docstring warnings that EncryptionSuite, KDFSuite, and AuthenticationSuite members must only be used as part of an AlgorithmSuite

Author: mattsb42-aws

src/aws_encryption_sdk/identifiers.py

@@ -28,6 +28,8 @@
 class EncryptionSuite(Enum):
     """Static definition of encryption algorithm details.
 
+    .. warning:: These members must only be used as part of an AlgorithmSuite.
+
     :param algorithm: Encryption algorithm to use
     :type algorithm: cryptography.io ciphers algorithm object
     :param mode: Encryption mode in which to operate
@@ -73,6 +75,8 @@ def valid_kdf(self, kdf):
 class KDFSuite(Enum):
     """Static definition of key derivation algorithm details.
 
+    .. warning:: These members must only be used as part of an AlgorithmSuite.
+
     :param algorithm: KDF algorithm to use
     :type algorithm: cryptography.io KDF object
     :param int input_length: Number of bytes of input data to feed into KDF function
@@ -108,6 +112,8 @@ def input_length(self, encryption):
 class AuthenticationSuite(Enum):
     """Static definition of authentication algorithm details.
 
+    .. warning:: These members must only be used as part of an AlgorithmSuite.
+
     :param algorithm: Information needed by signing algorithm to define behavior
     :type algorithm: may vary (currently only ECC curve object)
     :param hash_algorithm: Hash algorithm to use in signature