GitAuto: Update pyqt5 to the latest version pyqt6

Resolves #1

What is the feature

This feature updates the project dependencies from PyQt5 to the latest version, PyQt6. The transition involves modifying the codebase to be compatible with PyQt6 and ensuring all functionalities continue to work as intended.

Why we need the feature

Upgrading to PyQt6 offers several benefits:

Access to New Features: PyQt6 provides the latest features and enhancements from the Qt6 framework.
Improved Performance: Optimization in PyQt6 can lead to better application performance.
Long-Term Support: Using the latest version ensures continued support and updates from the maintainers.
Security Improvements: Newer versions may include patches for vulnerabilities present in older versions.
Modernization: Staying up-to-date with dependencies keeps the project modern and more attractive to contributors.

How to implement and why

Step 1: Update Dependency Files

Modify requirements.txt and requirements.pytorch.txt to replace PyQt5 with PyQt6.
- Why: This ensures that the correct version of PyQt is installed when setting up the environment.

Step 2: Adjust Import Statements

Go through the codebase (e.g., start.py, files in game_manager) and update import statements:
- Change from PyQt5 imports to from PyQt6.
- Update module paths where necessary, as some modules may have moved or been renamed.

Step 3: Update API Usage

Review all PyQt-related code for API changes:
- Enums: Access enums through the class rather than the module (e.g., Qt.AlignmentFlag.AlignCenter instead of Qt.AlignCenter).
- Print Functionality: Replace deprecated functions with their updated counterparts.
- Signal and Slot Connections: Ensure that signal and slot connections comply with PyQt6's syntax.

Step 4: Modify GUI Code

Adjust GUI component initialization and usage:
- Check for changes in widget properties and methods.
- Update any deprecated methods to their new versions.

Step 5: Test the Application Thoroughly

Run the application using start.py and perform comprehensive testing:
- Verify that all GUI elements display correctly.
- Ensure event handling works as expected.
- Test interactions within game_manager and other modules.

Step 6: Update Documentation

If applicable, update any documentation in the doc directory to reflect the changes.
- Why: Keeping documentation up-to-date helps future developers understand the codebase.

Reasoning

By following these steps, we systematically transition the project to PyQt6, addressing compatibility issues and leveraging new features. This method reduces the risk of runtime errors and ensures a smooth upgrade path.

About backward compatibility

Updating to PyQt6 may break compatibility with environments that rely on PyQt5. Considerations:

Python Version: PyQt6 requires Python 3.6 or higher.
Qt6 Requirements: Ensure that all target deployment environments support Qt6.
Mitigation Strategies:
- Maintain a Legacy Branch: Keep a separate branch for PyQt5 compatibility if supporting older environments is necessary.
- Conditional Imports: Use try-except blocks to allow the code to run with either PyQt5 or PyQt6 (though this can increase complexity).

Conclusion

While backward compatibility may be affected, the benefits of upgrading to PyQt6 outweigh the drawbacks for most modern applications. It's essential to communicate these changes to all stakeholders and update environment setup instructions accordingly.

Test these changes locally

git checkout -b gitauto-wes/issue-#1-a0019640-6534-44ee-85d1-ceb784862781
git pull origin gitauto-wes/issue-#1-a0019640-6534-44ee-85d1-ceb784862781

hiroshinishio / tetris