7 Commits

Author SHA1 Message Date
081bb862d3 Organize documentation into professional docs/ structure
🗂️ MAJOR DOCS REORGANIZATION: Professional documentation structure implemented

## New Documentation Architecture
docs/
├── user-guide/          # End-user documentation
├── development/         # Technical implementation details
├── migration/           # Upgrade and migration guides
├── reference/           # API references and feature lists
└── examples/            # Comprehensive usage examples

## Key Improvements
 Logical categorization of all 14 documentation files
 Professional docs/ directory following industry standards
 Updated internal links to maintain navigation
 Comprehensive docs/README.md with navigation
 Enhanced main README with docs/ integration
 Migration section added for v0.4.0 upgrade guidance

## Documentation Features
- 📖 Complete user guides with feature overviews
- 🛠️ Technical development documentation
- 🔄 Step-by-step migration instructions
- 💻 11 comprehensive examples with detailed explanations
- 📋 API references and project roadmaps
- 🎯 Quick navigation and cross-linking

This creates a professional documentation experience that scales
with the project and makes information easily discoverable.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-21 22:15:56 -06:00
f6a2ca28fe 🚀 Release v0.3.0: Complete Test Infrastructure Overhaul
MAJOR RELEASE: Comprehensive Testing Framework

📦 Version Bump: 0.2.0 → 0.3.0

🎉 ACHIEVEMENTS:
 52 passing tests (0 failures!) - Perfect compatibility achieved
 108+ test video fixtures covering every scenario
 Complete Docker integration testing environment
 Full CI/CD pipeline with GitHub Actions
 Production-ready testing infrastructure

📊 REMARKABLE IMPROVEMENT:
• Before: 17 failed, 35 passed, 7 skipped
• After: 52 passed, 7 skipped, 0 FAILED
• Success: 100% of previously failing tests now pass

🎬 TEST INFRASTRUCTURE:
• Comprehensive video processing test suite
• Edge cases: single frame, unusual resolutions, extreme aspect ratios
• Multiple codecs: H.264, H.265, VP8, VP9, Theora, MPEG4
• Audio variations: mono/stereo, sample rates, no audio, audio-only
• Visual patterns: SMPTE bars, RGB test, YUV test, checkerboard
• Motion tests: rotation, camera shake, scene changes
• Stress tests: high complexity scenes, noise patterns

🐳 DOCKER & DEVOPS:
• End-to-end Docker integration tests with PostgreSQL
• Procrastinate worker testing (2.x/3.x compatibility)
• Database migration testing in containerized environment
• GitHub Actions CI/CD pipeline with test matrix
• Makefile with simplified developer workflows

📋 DOCUMENTATION:
• Complete CHANGELOG.md with detailed release notes
• Comprehensive UPGRADE.md with migration guide
• Enhanced README.md highlighting v0.3.0 features
• Test infrastructure documentation and examples

🔧 TECHNICAL EXCELLENCE:
• Perfect API compatibility - all existing code works unchanged
• Sophisticated mocking for FFmpeg integration
• Comprehensive error handling with proper exception hierarchies
• Production-ready configuration examples

This release transforms the project from basic functionality to a
production-grade, comprehensively tested video processing library.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-05 15:23:11 -06:00
cd18a8da38 Remove unnecessary Redis service from Docker setup
Redis was included but not actually used by the video processor.
Only PostgreSQL is needed for Procrastinate job queue functionality.

- Remove redis service from docker-compose.yml
- Remove Redis dependencies from app and demo services
- Update README to reflect simplified service architecture
2025-09-05 10:46:42 -06:00
d9f1ecdcce Update README.md with v0.2.0 features
- Add v0.2.0 changelog with Procrastinate 3.x migration and Docker support
- Include Docker Quick Start section with service descriptions
- Add new examples (docker_demo.py, web_demo.py) to examples table
- Update test coverage section reflecting 43 passing tests
- Highlight new features: compatibility layer, migration utilities, Docker environment
2025-09-05 10:45:32 -06:00
5ca1b7a07d Migrate to Procrastinate 3.x with backward compatibility for 2.x
- Add comprehensive compatibility layer supporting both Procrastinate 2.x and 3.x
- Implement version-aware database migration system with pre/post migrations for 3.x
- Create worker option mapping for seamless transition between versions
- Add extensive test coverage for all compatibility features
- Update dependency constraints to support both 2.x and 3.x simultaneously
- Provide Docker containerization with uv caching and multi-service orchestration
- Include demo applications and web interface for testing capabilities
- Bump version to 0.2.0 reflecting new compatibility features

Key Features:
- Automatic version detection and feature flagging
- Unified connector creation across PostgreSQL drivers
- Worker option translation (timeout → fetch_job_polling_interval)
- Database migration utilities with CLI and programmatic interfaces
- Complete Docker Compose setup with PostgreSQL, Redis, workers, and demos

Files Added:
- src/video_processor/tasks/compat.py - Core compatibility layer
- src/video_processor/tasks/migration.py - Migration utilities
- src/video_processor/tasks/worker_compatibility.py - Worker CLI
- tests/test_procrastinate_compat.py - Compatibility tests
- tests/test_procrastinate_migration.py - Migration tests
- Dockerfile - Multi-stage build with uv caching
- docker-compose.yml - Complete development environment
- examples/docker_demo.py - Containerized demo application
- examples/web_demo.py - Flask web interface demo

Migration Support:
- Procrastinate 2.x: Single migration command compatibility
- Procrastinate 3.x: Separate pre/post migration phases
- Database URL validation and connection testing
- Version-specific feature detection and graceful degradation
2025-09-05 10:38:12 -06:00
9c0bd90299 Add optional 360° video processing dependencies
- Add video-360 extra for core 360° processing (py360convert, opencv, numpy, scipy)
- Add spatial-audio extra for spatial audio processing (librosa, soundfile)
- Add metadata-360 extra for enhanced metadata extraction (exifread)
- Add video-360-full extra for complete 360° feature set
- Update README with installation options and feature documentation
- Maintain backward compatibility with existing basic installation

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-05 09:26:30 -06:00
8253c56d2c 🎬 Initial release: Professional video processing library
 Features:
- Multi-format encoding (MP4, WebM, OGV) with two-pass encoding
- Professional quality presets (Low, Medium, High, Ultra)
- Thumbnail generation and seekbar sprite creation
- Background processing with Procrastinate integration
- Type-safe configuration with Pydantic V2
- Modern Python tooling (uv, ruff, pytest)
- Comprehensive test suite and documentation

🛠️ Tech Stack:
- Python 3.11+ with full type hints
- FFmpeg integration via ffmpeg-python
- msprites2 fork for professional sprite generation
- Procrastinate for scalable background tasks
- Storage abstraction layer (local + future S3)

📚 Includes examples, API documentation, and development guides

🚀 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-05 08:01:33 -06:00