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 [Proposal]: -vcodec copy HLS #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

• I have read the PR Guidelines.
• I have read the Documentation.
• 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

• 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]

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 ⚠️
vidgear/gears/asyncio/webgear_rtc.py	33.33%	2 Missing ⚠️
vidgear/gears/screengear.py	90.90%	1 Missing ⚠️
vidgear/gears/streamgear.py	95.45%	1 Missing ⚠️

Additional details and impacted files

@@             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     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.