feat: allow modifying lerner name size on PDF certificate

Author: Agrendalath

CHANGELOG.rst

@@ -16,6 +16,13 @@ Unreleased
 
 *
 
+0.2.4 - 2025-09-07
+
+Added
+=====
+
+* Option to customize the learner's name size on the PDF certificate.
+
 0.2.3 - 2025-08-18
 
 Modified

learning_credentials/generators.py

@@ -89,7 +89,7 @@ def hex_to_rgb(hex_color: str) -> tuple[float, float, float]:
     pdf_canvas = canvas.Canvas(io.BytesIO(), pagesize=(template_width, template_height))
 
     # Write the learner name.
-    pdf_canvas.setFont(font, 32)
+    pdf_canvas.setFont(font, options.get('name_size', 32))
     name_color = options.get('name_color', '#000')
     pdf_canvas.setFillColorRGB(*hex_to_rgb(name_color))
 
@@ -184,6 +184,7 @@ def generate_pdf_credential(
       - font: The name of the font to use.
       - name_y: The Y coordinate of the name on the credential (vertical position on the template).
       - name_color: The color of the name on the credential (hexadecimal color code).
+      - name_size: The font size of the name on the credential. The default value is 32.
       - context_name: Specify the custom course or Learning Path name.
       - context_name_y: The Y coordinate of the context name on the credential (vertical position on the template).
       - context_name_color: The color of the context name on the credential (hexadecimal color code).

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "learning-credentials"
-version = "0.2.3"
+version = "0.2.4"
 description = "A pluggable service for preparing Open edX credentials."
 dynamic = ["readme"]
 requires-python = ">=3.11"

tests/test_generators.py

@@ -76,6 +76,7 @@ def test_register_font_with_custom_font(mock_register_font: Mock, mock_font_clas
                 'context_name_color': '#9B192A',
                 'issue_date_color': '#f59a8e',
                 'context_name_size': 20,
+                'name_size': 24,
             },
             {
                 'name_color': (17 / 255, 34 / 255, 51 / 255),
@@ -131,7 +132,7 @@ def test_write_text_on_template(mock_canvas_class: Mock, context_name: str, opti
     assert canvas_object.drawString.call_count == 3 + context_name.count('\n')
 
     # Check the calls to setFont, setFillColorRGB and drawString methods on Canvas object
-    assert canvas_object.setFont.call_args_list[0] == call(font, 32)
+    assert canvas_object.setFont.call_args_list[0] == call(font, options.get('name_size', 32))
     assert canvas_object.setFillColorRGB.call_args_list[0] == call(*expected_name_color)
     assert canvas_object.drawString.call_args_list[0] == call(expected_name_x, expected_name_y, username)
     assert mock_canvas_class.return_value.stringWidth.mock_calls[0][1] == (username,)