Updated two_num.py

[dnoice]

Summary

Refactored the two_sum function to enhance clarity, improve structure, and ensure compliance with Python best practices (PEP 8). This version prioritizes intuitive logic, robust error handling, and clear documentation.

Key Changes

• Function Renaming: Renamed twoSum to two_sum to adhere to PEP 8 standards for function naming.
• Improved Variable Naming: Replaced ambiguous names (chk_map, compl) with more intuitive identifiers (seen_values, complement).
• Added Type Hints: Introduced from typing import List, Union to improve code clarity and provide IDE/linter support.
• Enhanced Docstring: Expanded the docstring to include detailed function descriptions, argument explanations, and return behavior.
• Robust Return Handling: Ensured the function explicitly returns False if no valid pair is found, improving clarity in edge cases.
• Improved Output Structure: Added a __main__ block with structured output for cleaner and more informative result display.

Rationale

These changes improve:

• Readability: Clearer variable names and enhanced documentation make the code easier to understand for future developers (and my future self).
• Maintainability: Improved structure provides a stronger foundation for future feature enhancements or modifications.
• Compliance: Aligns with Python's official best practices for formatting and style (PEP 8).