video-processor/tests/conftest.py
Ryan Malloy 343f989714 🎬 Complete project reorganization and video-themed testing framework
MAJOR ENHANCEMENTS:
• Professional documentation structure in docs/ with symlinked examples
• Comprehensive test organization under tests/ directory
• Advanced video-themed testing framework with HTML dashboards
• Enhanced Makefile with categorized test commands

DOCUMENTATION RESTRUCTURE:
• docs/user-guide/ - User-facing guides and features
• docs/development/ - Technical documentation
• docs/migration/ - Upgrade instructions
• docs/reference/ - API references and roadmaps
• examples/ - Practical usage examples (symlinked to docs/examples)

TEST ORGANIZATION:
• tests/unit/ - Unit tests with enhanced reporting
• tests/integration/ - End-to-end tests
• tests/docker/ - Docker integration configurations
• tests/framework/ - Custom testing framework components
• tests/development-archives/ - Historical test data

TESTING FRAMEWORK FEATURES:
• Video-themed HTML dashboards with cinema aesthetics
• Quality scoring system (0-10 scale with letter grades)
• Test categorization (unit, integration, 360°, AI, streaming, performance)
• Parallel execution with configurable workers
• Performance metrics and trend analysis
• Interactive filtering and expandable test details

INTEGRATION IMPROVEMENTS:
• Updated docker-compose paths for new structure
• Enhanced Makefile with video processing test commands
• Backward compatibility with existing tests
• CI/CD ready with JSON reports and exit codes
• Professional quality assurance workflows

TECHNICAL ACHIEVEMENTS:
• 274 tests organized with smart categorization
• 94.8% unit test success rate with enhanced reporting
• Video processing domain-specific fixtures and assertions
• Beautiful dark terminal aesthetic with video processing colors
• Production-ready framework with enterprise-grade features

Commands: make test-smoke, make test-unit, make test-360, make test-all
Reports: Video-themed HTML dashboards in test-reports/
Quality: Comprehensive scoring and performance tracking
2025-09-21 23:41:16 -06:00

203 lines
5.9 KiB
Python

"""Pytest configuration and shared fixtures."""
import asyncio
import shutil
import tempfile
from collections.abc import Generator
from pathlib import Path
from unittest.mock import AsyncMock, Mock
import pytest
from video_processor import ProcessorConfig, VideoProcessor
# Import our testing framework components
from tests.framework.fixtures import VideoTestFixtures
from tests.framework.config import TestingConfig
from tests.framework.quality import QualityMetricsCalculator
# Legacy fixtures (maintained for backward compatibility)
@pytest.fixture
def temp_dir() -> Generator[Path, None, None]:
"""Create a temporary directory for test outputs."""
temp_path = Path(tempfile.mkdtemp())
yield temp_path
shutil.rmtree(temp_path, ignore_errors=True)
@pytest.fixture
def default_config(temp_dir: Path) -> ProcessorConfig:
"""Create a default test configuration."""
return ProcessorConfig(
base_path=temp_dir,
output_formats=["mp4", "webm"],
quality_preset="medium",
thumbnail_timestamp=1,
sprite_interval=2.0,
generate_thumbnails=True,
generate_sprites=True,
)
@pytest.fixture
def processor(default_config: ProcessorConfig) -> VideoProcessor:
"""Create a VideoProcessor instance."""
return VideoProcessor(default_config)
@pytest.fixture
def video_fixtures_dir() -> Path:
"""Path to video fixtures directory."""
return Path(__file__).parent / "fixtures" / "videos"
@pytest.fixture
def valid_video(video_fixtures_dir: Path) -> Path:
"""Path to a valid test video."""
video_path = video_fixtures_dir / "valid" / "standard_h264.mp4"
if not video_path.exists():
pytest.skip(
f"Test video not found: {video_path}. Run: python tests/fixtures/generate_fixtures.py"
)
return video_path
@pytest.fixture
def corrupt_video(video_fixtures_dir: Path) -> Path:
"""Path to a corrupted test video."""
video_path = video_fixtures_dir / "corrupt" / "bad_header.mp4"
if not video_path.exists():
pytest.skip(
f"Corrupt video not found: {video_path}. Run: python tests/fixtures/generate_fixtures.py"
)
return video_path
@pytest.fixture
def edge_case_video(video_fixtures_dir: Path) -> Path:
"""Path to an edge case test video."""
video_path = video_fixtures_dir / "edge_cases" / "one_frame.mp4"
if not video_path.exists():
pytest.skip(
f"Edge case video not found: {video_path}. Run: python tests/fixtures/generate_fixtures.py"
)
return video_path
@pytest.fixture
async def mock_procrastinate_app():
"""Mock Procrastinate application for testing."""
app = Mock()
app.tasks = Mock()
app.tasks.process_video_async = AsyncMock()
app.tasks.process_video_async.defer_async = AsyncMock(
return_value=Mock(id="test-job-123")
)
app.tasks.generate_thumbnail_async = AsyncMock()
app.tasks.generate_thumbnail_async.defer_async = AsyncMock(
return_value=Mock(id="test-thumbnail-job-456")
)
return app
@pytest.fixture
def mock_ffmpeg_success(monkeypatch):
"""Mock successful FFmpeg execution."""
def mock_run(*args, **kwargs):
return Mock(returncode=0, stdout=b"", stderr=b"")
monkeypatch.setattr("subprocess.run", mock_run)
@pytest.fixture
def mock_ffmpeg_failure(monkeypatch):
"""Mock failed FFmpeg execution."""
def mock_run(*args, **kwargs):
return Mock(returncode=1, stdout=b"", stderr=b"Error: Invalid input file")
monkeypatch.setattr("subprocess.run", mock_run)
# Async event loop fixture for async tests
@pytest.fixture
def event_loop():
"""Create an instance of the default event loop for the test session."""
loop = asyncio.new_event_loop()
yield loop
loop.close()
# Enhanced fixtures from our testing framework
@pytest.fixture
def enhanced_temp_dir() -> Generator[Path, None, None]:
"""Enhanced temporary directory with proper cleanup and structure."""
return VideoTestFixtures.enhanced_temp_dir()
@pytest.fixture
def video_config(enhanced_temp_dir: Path) -> ProcessorConfig:
"""Enhanced video processor configuration for testing."""
return VideoTestFixtures.video_config(enhanced_temp_dir)
@pytest.fixture
def enhanced_processor(video_config: ProcessorConfig) -> VideoProcessor:
"""Enhanced video processor with test-specific configurations."""
return VideoTestFixtures.enhanced_processor(video_config)
@pytest.fixture
def mock_ffmpeg_environment(monkeypatch):
"""Comprehensive FFmpeg mocking environment."""
return VideoTestFixtures.mock_ffmpeg_environment(monkeypatch)
@pytest.fixture
def test_video_scenarios():
"""Predefined test video scenarios for comprehensive testing."""
return VideoTestFixtures.test_video_scenarios()
@pytest.fixture
def performance_benchmarks():
"""Performance benchmarks for different video processing operations."""
return VideoTestFixtures.performance_benchmarks()
@pytest.fixture
def video_360_fixtures():
"""Specialized fixtures for 360° video testing."""
return VideoTestFixtures.video_360_fixtures()
@pytest.fixture
def ai_analysis_fixtures():
"""Fixtures for AI-powered video analysis testing."""
return VideoTestFixtures.ai_analysis_fixtures()
@pytest.fixture
def streaming_fixtures():
"""Fixtures for streaming and adaptive bitrate testing."""
return VideoTestFixtures.streaming_fixtures()
@pytest.fixture
async def async_test_environment():
"""Async environment setup for testing async video processing."""
return VideoTestFixtures.async_test_environment()
@pytest.fixture
def mock_procrastinate_advanced():
"""Advanced Procrastinate mocking with realistic behavior."""
return VideoTestFixtures.mock_procrastinate_advanced()
# Framework fixtures (quality_tracker, test_artifacts_dir, video_test_config, video_assert)
# are defined in pytest_plugin.py
# This conftest.py contains legacy fixtures for backward compatibility