oppia · chris7716 · Jan 27, 2023 · Jan 9, 2021 · Jan 9, 2021 · Jan 9, 2021
@@ -318,6 +318,10 @@ export default {
   // eslint-disable-next-line max-len
   "MATH_SVG_FILENAME_REGEX": "mathImg_[a-z0-9_]+_height_[0-9d]+_width_[0-9d]+_vertical_[0-9d]+.(svg)$",
 
+  // This regex validates whether a given string is in the format of YYYY-MM-DD
+  // format.
+  "DATE_REGEX": "^[0-9]{4}-[0-9]{1,2}-[0-9]{1,2}$",
+
   // The SVG tag-specific attribute allowlist is based on the list of tags and
   // and attributes specified in this project:
   // https://github.com/cure53/DOMPurify
@@ -6928,5 +6932,7 @@ export default {
     "param_changes", "auto_tts_enabled", "correctness_feedback_enabled",
     "edits_allowed"
   ],
-  "NON_METADATA_PROPERTIES": ["id", "states"]
+  "NON_METADATA_PROPERTIES": ["id", "states"],
+  "CONTRIBUTOR_CERTIFICATE_WIDTH": 1493,
+  "CONTRIBUTOR_CERTIFICATE_HEIGHT": 1313
 } as const;
@@ -16,6 +16,7 @@
 
 from __future__ import annotations
 
+import datetime
 import json
 
 from core import feconf
@@ -935,6 +936,84 @@ def get(
         self.render_json(self.values)
 
 
+class ContributorCertificateHandler(
+    base.BaseHandler[Dict[str, str], Dict[str, str]]
+):
+    """Returns contributor certificate."""
+
+    GET_HANDLER_ERROR_RETURN_TYPE = feconf.HANDLER_TYPE_JSON
+    URL_PATH_ARGS_SCHEMAS = {
+        'username': {
+            'schema': {
+                'type': 'basestring',
+                'validators': [{
+                    'id': 'has_length_at_most',
+                    'max_value': constants.MAX_USERNAME_LENGTH
+                }]
+            }
+        },
+        'suggestion_type': {
+            'schema': {
+                'type': 'basestring',
+                'choices': feconf.SUGGESTION_TYPE_CHOICES
+            }
+        }
+    }
+    HANDLER_ARGS_SCHEMAS = {
+        'GET': {
+            'from_date': {
+                'schema': {
+                    'type': 'basestring',
+                    'validators': [{
+                        'id': 'is_regex_matched',
+                        'regex_pattern': constants.DATE_REGEX
+                    }]
+                }
+            },
+            'to_date': {
+                'schema': {
+                    'type': 'basestring',
+                    'validators': [{
+                        'id': 'is_regex_matched',
+                        'regex_pattern': constants.DATE_REGEX
+                    }]
+                }
+            },
+            'language': {
+                'schema': {
+                    'type': 'basestring',
+                    'validators': [{
+                        'id': 'is_supported_audio_language_code'
+                    }]
+                },
+                'default_value': None
+            },
+        }
+    }
+
+    @acl_decorators.can_fetch_all_contributor_dashboard_stats
+    def get(
+        self, username: str, suggestion_type: str
+    ) -> None:
+        """Handles GET requests."""
+        assert self.normalized_request is not None
+        from_date = self.normalized_request['from_date']
+        to_date = self.normalized_request['to_date']
+        language = self.normalized_request.get('language')
-        language = self.normalized_request.get('language')
+        language = self.normalized_request['language']
-        language = self.normalized_request.get('language')
+        language = self.normalized_request['language']
+
+        from_datetime = datetime.datetime.strptime(from_date, '%Y-%m-%d')
+        to_datetime = datetime.datetime.strptime(to_date, '%Y-%m-%d')
+        if to_datetime.date() > datetime.datetime.now().date():
+            raise self.InvalidInputException(
+                'To date should not be a future date.')
+
+        response = suggestion_services.generate_contributor_certificate_data(
+            username, suggestion_type, language, from_datetime,
+            to_datetime)
+
+        self.render_json(response)
+
+
 class ContributorAllStatsSummariesHandler(
     base.BaseHandler[Dict[str, str], Dict[str, str]]
 ):

@@ -1943,3 +1943,75 @@ def test_get_all_stats_of_other_users_raises_error(self) -> None:
                 self.OWNER_USERNAME))
 
         self.logout()
+
+    def test_get_contributor_certificate(self) -> None:
+        score_category: str = (
+            suggestion_models.SCORE_TYPE_TRANSLATION +
+            suggestion_models.SCORE_CATEGORY_DELIMITER + 'English')
+        change_cmd = {
+            'cmd': 'add_translation',
+            'content_id': 'content',
+            'language_code': 'hi',
+            'content_html': '',
+            'state_name': 'Introduction',
+            'translation_html': '<p>Translation for content.</p>'
+        }
+        suggestion_models.GeneralSuggestionModel.create(
+            feconf.SUGGESTION_TYPE_TRANSLATE_CONTENT,
+            feconf.ENTITY_TYPE_EXPLORATION,
+            'exp1', 1, suggestion_models.STATUS_ACCEPTED, self.owner_id,
+            self.OWNER_USERNAME, change_cmd, score_category,
+            'exploration.exp1.thread_6', 'hi')
+        from_date = datetime.datetime.today() - datetime.timedelta(days=1)
+        from_date_str = from_date.strftime('%Y-%m-%d')
+        to_date = datetime.datetime.today()
+        to_date_str = to_date.strftime('%Y-%m-%d')
+
+        self.login(self.OWNER_EMAIL)
+
+        response = self.get_json(
+            '/contributorcertificate/%s/%s?language=%s&'
+            'from_date=%s&to_date=%s' % (
+                self.OWNER_USERNAME, feconf.SUGGESTION_TYPE_TRANSLATE_CONTENT,
+                'hi', from_date_str, to_date_str
+            )
+        )
+
+        self.assertEqual(
+            response,
+            {
+                'from_date': from_date.strftime('%d %b %Y'),
+                'to_date': to_date.strftime('%d %b %Y'),
+                'contribution_hours': '0.01',
+                'team_lead': feconf.TRANSLATION_TEAM_LEAD,
+                'language': 'Hindi'
+            }
+        )
+
+        self.logout()
+
+    def test_get_contributor_certificate_raises_invalid_date_exception(
+        self
+    ) -> None:
+        from_date = datetime.datetime.today() - datetime.timedelta(days=1)
+        from_date_str = from_date.strftime('%Y-%m-%d')
+        to_date = datetime.datetime.today() + datetime.timedelta(days=1)
+        to_date_str = to_date.strftime('%Y-%m-%d')
+
+        self.login(self.OWNER_EMAIL)
+
+        response = self.get_json(
+            '/contributorcertificate/%s/%s?language=%s&'
+            'from_date=%s&to_date=%s' % (
+                self.OWNER_USERNAME, feconf.SUGGESTION_TYPE_TRANSLATE_CONTENT,
+                'hi', from_date_str, to_date_str
+            ),
+            expected_status_int=400
+        )
+
+        self.assertEqual(
+            response['error'],
+            'To date should not be a future date.'
+        )
+
+        self.logout()
@@ -1823,6 +1823,52 @@ def to_frontend_dict(self) -> QuestionReviewStatsFrontendDict:
         }
 
 
+class ContributorCertificateInfoDict(TypedDict):
+    """Dictionary representing the ContributorCertificateInfo object."""
+
+    from_date: str
+    to_date: str
+    team_lead: str
+    contribution_hours: str
+    language: Optional[str]
+
+
+class ContributorCertificateInfo:
+    """Encapsulates key information that is used to generate contributor
+    certificate.
+    """
+
+    def __init__(
+        self,
+        from_date: str,
+        to_date: str,
+        team_lead: str,
+        contribution_hours: str,
+        language: Optional[str]
+    ) -> None:
+        self.from_date = from_date
+        self.to_date = to_date
+        self.team_lead = team_lead
+        self.contribution_hours = contribution_hours
+        self.language = language
+
+    def to_dict(self) -> ContributorCertificateInfoDict:
+        """Returns a dict representation of a ContributorCertificateInfo
+        domain object.
+
+        Returns:
+            dict. A dict representation of a ContributorCertificateInfo
+            domain object.
+        """
+        return {
+            'from_date': self.from_date,
+            'to_date': self.to_date,
+            'team_lead': self.team_lead,
+            'contribution_hours': self.contribution_hours,
+            'language': self.language
+        }
+
+
 class ContributorMilestoneEmailInfo:
     """Encapsulates key information that is used to create the email content for
     notifying contributors about milestones they achieved.