💡 [Feature]: Introduce Type Hints and Mypy Verification Across All Scripts

[knoxiboy]

❓ Problem Statement

Because Python is dynamically typed, passing the wrong data type to a function (e.g., a string instead of an int in a math script) causes runtime crashes. Without type hints, maintaining large scripts is difficult.

🚀 Proposed Enhancement

Add Python 3 standard type hints (int, str, List, Optional) to all function signatures and complex variables across the repository, and enforce them in CI using mypy.

🛠️ Suggested Implementation

1. Add type hints to all def statements: def calculate_score(points: int, bonus: float) -> float:
2. Add mypy to the requirements.txt.
3. Add a mypy . step to the GitHub Actions workflow.

Additional Notes

• I am a registered GSSoC 2026 contributor.
• I would like to implement this feature myself.

[github-actions]

⚠️ Important Contribution Guideline

Please do not open a Pull Request without being assigned to this issue first.

Please do not open a Pull Request without being assigned to this issue first.

How to proceed:

1. Comment on this issue to express interest
2. Wait for maintainers to assign you to the issue
3. Once assigned, you can start working on the PR
4. Include the assignment in your PR checklist

Thank you for helping us maintain a smooth workflow! 🙏

[knoxiboy]

/assign gssoc'26
Hi! @steam-bell-92
I would like to work on this issue under GSSoC'26. Please assign this issue to me.

[Saloni885]

Hello, I’m interested in contributing to this issue.
I can add type hints across the scripts and set up Mypy verification to improve code quality.
Kindly assign me this issue.