stevezau/media_preview_generator 2.0.0

🚀 Major Refactor and Modernization

on GitHub

Overview

Complete transformation from monolithic script to production-ready Python package with comprehensive testing, documentation, and deployment capabilities.

🏗️ Architecture & Structure Overhaul

• Complete refactor from single plex_generate_previews.py to modular package structure
• Split into focused modules: cli.py, config.py, gpu_detection.py, media_processing.py, plex_client.py, worker.py, utils.py
• Added proper package structure with __init__.py and __main__.py
• Implemented clean separation of concerns with dedicated classes and functions

🧪 Testing Infrastructure

• Comprehensive test suite with pytest framework
• Created test modules: test_basic.py, test_cli.py, test_gpu_ci.py
• Added GPU testing capabilities with test_gpu_local.py
• Implemented CI/CD pipeline with GitHub Actions workflows
• Added test configuration files: pytest.ini, requirements-test.txt, run_tests.py

🚀 CI/CD & Deployment

• Added GitHub Actions workflows for automated testing and PyPI publishing
• Created publish_pypi.yml for automated package releases
• Added test.yml for continuous integration testing
• Updated Dockerfile with modern Python practices and multi-stage builds

📦 Package Management

• Migrated from requirements.txt to pyproject.toml for modern Python packaging
• Added proper package metadata, dependencies, and build configuration
• Implemented version checking system with version_check.py
• Added console script entry point for CLI access

🎯 CLI & Configuration

• Complete CLI rewrite with modern argument parsing and help system
• Added comprehensive configuration management with environment variables
• Implemented advanced path mapping for Docker/remote deployments
• Added GPU selection and thread configuration options
• Enhanced logging with multiple levels and structured output

🖥️ GPU & Hardware Support

• Expanded GPU detection to support NVIDIA, AMD, Intel, and WSL2
• Added multi-GPU support with selective GPU usage
• Implemented hardware acceleration for CUDA, VAAPI, QSV, and D3D11VA
• Added GPU capability detection and validation

📚 Documentation

• Completely rewrote README.md with comprehensive usage examples
• Added detailed troubleshooting guides and FAQ sections
• Included Docker Compose examples for different GPU types
• Added path mapping documentation for complex deployments
• Created step-by-step installation guides for various platforms

🔧 Code Quality & Maintenance

• Removed legacy code and unused dependencies
• Added proper error handling and graceful failure modes
• Implemented structured logging with Rich library integration
• Added comprehensive docstrings and inline documentation
• Updated .gitignore and development environment configuration

🐳 Docker & Containerization

• Enhanced Docker support with GPU acceleration
• Added support for multiple GPU types in containers
• Improved volume mounting and path mapping
• Added user/group configuration for proper permissions

📊 Impact

• 36 files changed: 4,284 additions, 909 deletions
• 10 commits including complete refactor, testing infrastructure, documentation updates, and bug fixes
• Transformation from single-file script to professional Python package

🎯 Key Benefits

• ✅ Production-ready code with minimal technical debt
• ✅ Comprehensive testing and CI/CD pipeline
• ✅ Modern Python packaging and distribution
• ✅ Enhanced GPU support and hardware acceleration
• ✅ Professional documentation and user guides
• ✅ Improved maintainability and extensibility

This represents a complete modernization of the project from a single-file script to a professional, production-ready Python package with comprehensive testing, documentation, and deployment capabilities.