Core: Minor Bug Fixes

[abhiTronix]

Brief Description

This PR encompasses a series of enhancements and bug fixes across multiple components of the project, aimed at improving functionality, optimizing performance, and enhancing user experience.

Key Changes: 🆕

Here are the main changes included:

WebGear_RTC:

• Optimized peer connection closure to avoid redundant closures.
• Reduced unnecessary logging by only logging ICE connection state changes when they are not in a "failed" state.

StreamGear:

• Enhanced stream copy support in Single Source mode (Fixes #396)
  • Ignored stream copy parameter in Real-time Frames Mode or Custom Streams with appropriate warnings.
  • Updated -acodec handling:
  • Default to aac for Custom Streams.
  • Use stream copy (-acodec copy) for input video’s audio when Custom Streams are disabled.
  • Refined -livestream parameter usage to Real-time Frames Mode only.
  • Adjusted video and audio bitrate assignment to skip when stream copy is enabled.
  • Improved log message for -clear_prev_assets parameter.
• Moved handle streaming format to beginning to fix 'StreamGear' object has no attribute '_StreamGear__format' bug.

CamGear:

• Removed GStreamer support check.
• Improved readability of livestream warning logs.

WriterGear:

• Improved error handling in execute_ffmpeg_cmd method:
  • Raised ValueError with descriptive messages for BrokenPipeError or IOError.
  • Updated error handling per PEP 409 to preserve original exception context or suppress it based on logging settings.

NetGear: Updated parameters and documentation (Fixes #390)

• Added warning log for potential issues with flag=1 (NOBLOCK).
• Noted that track option is ignored when copy=True.

Core:

• Improved exception handling for module imports.
  • Updated import_dependency_safe in helper.py:
  • dded specific handling for ModuleNotFoundError.
  • Included original exception in ImportError for better error tracing.
  • Enhanced logging to include exception traceback when error is set to "log".
  • Enhanced import_core_dependency in __init__.py:
  • Added specific handling for ModuleNotFoundError.
  • Included original exception in ImportError for better error tracing.

Maintenance:

• Refactored colorspace handling in videocapture gears
  • Logged a warning and discarded invalid colorspace values instead of raising an exception.
  • Consolidated colorspace logging into a single line using a ternary operation.
• Simplified code using short-circuiting.
• Corrected a typo in comments.
• Removed unnecessary parentheses and type checks.
• Removed unused imports.

Docs:

• Enhanced StreamGear documentation:
  • Added a tip box on benefits of using stream copy (-vcodec copy) for faster HLS/DASH transcoding.
  • Highlighted limitations of stream copy, including incompatibility with Real-time Frames Mode and Custom Streams.
  • Clarified automatic audio stream copy (-acodec copy) usage with input video’s audio stream.
• Changed default value of copy to True in NetGear API documentation.
• Fixed typos, formatting, code highlighting, and grammar issues.

CI:

• Enhanced WebGear RTC tests
• Updated NetGear unit tests to reflect the new default for copy.
• Fixed simplejpeg and opencv not compatible with numpy==2.x.x versions.
  • Pinned numpy<2.0.0 in all CI envs.
• Added test cases for import_dependency_safe function to validate different scenarios and error handling in import_dependency_safe.
  • Ensured coverage for raise, log, silent, and unknown error types.
• Fixed invalid escape sequence in testcase string.
• Fixed python environment bugs in appveyor.yml.
• Removed pinned cryptography==38.0.4 dependency.

Requirements / Checklist

• [x] I have read the PR Guidelines.
• [x] I have read the Documentation.
• [x] I have updated the documentation accordingly(if required).

Related Issue

390

396

Context

This PR is part of ongoing efforts to improve the overall functionality, performance, and usability of the project, addressing both user-reported issues and opportunities for internal optimization.

Types of changes

• [x] Bug fix (non-breaking change which fixes an issue)
• [ ] New feature (non-breaking change which adds functionality)
• [ ] Breaking change (fix or feature that would cause existing functionality to change)

[codecov[bot]]

Codecov Report

Attention: Patch coverage is 89.04110% with 8 lines in your changes missing coverage. Please review.

Project coverage is 93.57%. Comparing base (d4243ab) to head (0d9071e).

Files	Patch %	Lines
vidgear/gears/writegear.py	0.00%	4 Missing :warning:
vidgear/gears/asyncio/webgear_rtc.py	33.33%	2 Missing :warning:
vidgear/gears/screengear.py	90.90%	1 Missing :warning:
vidgear/gears/streamgear.py	95.45%	1 Missing :warning:

Additional details and impacted files

```diff @@ Coverage Diff @@ ## testing #406 +/- ## =========================================== - Coverage 93.85% 93.57% -0.29% =========================================== Files 15 15 Lines 3092 3080 -12 =========================================== - Hits 2902 2882 -20 - Misses 190 198 +8 ```

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.