Revize 35a4e794

Added docstrings describing the reasons why an InvalidCertificateAttribute error might be raised in the CertificateService.

src/services/certificate_service.py

@@ -51 +51 @@
 
     @staticmethod
     def __check_subject_is_valid(subject: Subject):
+        """
+        Checks whether the given subject is valid
+        :param subject: A subject to be verified
+        :raises InvalidCertificateAttribute: When a subject with an invalid attribute is passed
+        """
         if subject.country is not None and len(subject.country) != 2:
             raise InvalidSubjectAttribute("Country code", "Must consist of exactly 2 letters.")
 
@@ -65 +70 @@
         :param extensions: Name of the section in the configuration representing extensions
         :param usages: A dictionary containing usages of the certificate to be generated (see constants.py)
         :param days: Number of days for which the generated cert. will be considered valid
+        :raises InvalidCertificateAttribute: when a subject with an invalid attribute is passed
         :return: An instance of Certificate class representing the generated root CA cert
         """
 
@@ -140 +146 @@
         :param extensions: Extensions to be used when generating the certificate
         :param usages: A dictionary containing usages of the certificate to be generated (see constants.py)
         :param days: Number of days for which the generated cert. will be considered valid
+        :raises InvalidCertificateAttribute: when a subject with an invalid attribute is passed
         :return: An instance of Certificate class representing the generated intermediate CA cert
         """
 
@@ -194 +201 @@
         :param extensions: Extensions to be used when generating the certificate
         :param usages: A dictionary containing usages of the certificate to be generated (see constants.py)
         :param days: Number of days for which the generated cert. will be considered valid
+        :raises InvalidCertificateAttribute: when a subject with an invalid attribute is passed
         :return: An instance of Certificate class representing the generated cert
         """