Improve Input Validation and Increase Test Coverage

[ssuyashhhh]

Description

Many CLI-based projects in this repository do not properly validate user input, which can cause crashes when invalid values are entered. Additionally, several modules lack automated tests, making it difficult to detect regressions and ensure reliability.

Proposed Improvements

Input Validation

• Validate all user inputs before processing.
• Handle invalid numeric inputs gracefully.
• Prevent crashes caused by ValueError and similar exceptions.
• Display clear error messages and prompt users to retry.
• Create reusable helper functions for common validation tasks.

Testing

• Add comprehensive PyTest test cases.
• Cover normal cases, edge cases, and invalid inputs.
• Add tests for mathematical utilities, generators, and reusable helper functions.
• Aim for at least 80% code coverage.

Code Quality

• Refactor duplicated validation logic into reusable functions.
• Add type hints where appropriate.
• Improve exception handling.
• Ensure executable scripts use:
  if name == "main":
  main()

Acceptance Criteria

• User input is validated before processing.
• Invalid input no longer crashes applications.
• Shared validation helpers are implemented.
• New PyTest test cases are added.
• Existing functionality remains unchanged.
• Code coverage reaches at least 80% where feasible.

Benefits

• Improved user experience
• Reduced runtime errors
• Better maintainability
• Easier future contributions
• Increased confidence through automated testing

[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! 🙏

[brunda6git]

Hi, I am a GSSoC 2026 contributor and would like to work on this issue. Could you please assign it to me?

[ssuyashhhh]

@steam-bell-92 i had observed that there aren't test cases for most the games and there isn't a proper structure of error like invalid input from the user etc. So do assign me this.