Add comprehensive test suite and Docker Hub CI/CD automation

[Jackie264]

📋 Summary

This PR adds a comprehensive test suite and complete Docker Hub CI/CD automation to the docker2compose project. It includes 40 unit tests and automated multi-platform Docker image builds with push to Docker Hub.

🧪 Test Suite Features

Test Coverage (40 tests total)

• test_d2c.py (15 tests): Core functionality including configuration management, container analysis, and service conversion
• test_cron_utils.py (9 tests): CRON expression normalization and validation utilities
• test_scheduler.py (11 tests): Scheduler functionality, signal handling, and lifecycle management
• test_web_ui.py (5 tests): Web UI utilities and subprocess handling

Test Infrastructure

• pytest.ini: Test configuration with proper Python path setup
• run_tests.py: Convenient test runner script with clear output
• tests/README.md: Comprehensive documentation for the test suite
• Multi-Python support: Tests run on Python 3.9, 3.10, 3.11, and 3.12

🐳 Docker Hub CI/CD Automation

GitHub Actions Workflows

1. test.yml: Comprehensive testing on multiple Python versions
2. docker-publish.yml: Multi-platform Docker builds and pushes

Automated Features

• ✅ Multi-platform builds: linux/amd64, linux/arm64, linux/arm/v7
• ✅ Multi-registry push: Docker Hub, GitHub Container Registry, Ali Cloud
• ✅ Automated testing: Full test suite runs before builds
• ✅ Smart tagging: Version tags, branch tags, latest tags, commit SHAs
• ✅ Docker Hub sync: Automatic README and description updates
• ✅ Security: Token-based authentication with GitHub Secrets

Trigger Conditions

• Push to master branch → Build and push latest tag
• Create version tag (v*.*.*) → Build and push version tag
• Manual trigger via GitHub Actions UI
• Pull requests → Run tests only (no image builds)

📊 Image Repositories

After setup, images will be available at:

• Docker Hub: jackie264/docker2compose
• GitHub Container Registry: ghcr.io/jackie264/docker2compose
• Ali Cloud Registry: registry.cn-hangzhou.aliyuncs.com/cherry4nas/docker2compose

🔧 Setup Requirements

To enable Docker Hub automation, add these GitHub Secrets:

• DOCKERHUB_USERNAME: Your Docker Hub username
• DOCKERHUB_TOKEN: Docker Hub access token

Detailed setup instructions: docs/DOCKER_HUB_SETUP.md

📁 New Files Added

Testing

• tests/ - Complete test suite with 40 tests
• pytest.ini - Test configuration
• run_tests.py - Test runner script
• tests/README.md - Test documentation

CI/CD & Docker

• .github/workflows/test.yml - Multi-Python testing workflow
• .github/workflows/docker-publish.yml - Enhanced Docker build workflow
• docker-compose.example.yml - Example deployment configuration
• docs/DOCKER_HUB_SETUP.md - Complete setup guide

Documentation

• Updated README.md with status badges and Docker Hub information
• Updated requirements.txt with testing dependencies

🎯 Benefits

1. Quality Assurance: 40 comprehensive tests ensure code reliability
2. Automated Deployment: Zero-touch Docker image builds and distribution
3. Multi-Platform Support: Works on AMD64, ARM64, and ARM v7 architectures
4. Developer Experience: Easy local testing with python run_tests.py
5. Documentation: Complete setup guides and usage examples
6. Monitoring: GitHub Actions badges show build and test status

🚀 Usage Examples

# Pull and run from Docker Hub
docker pull jackie264/docker2compose:latest
docker run -d -p 5000:5000 -v /var/run/docker.sock:/var/run/docker.sock jackie264/docker2compose:latest

# Run tests locally
python run_tests.py

# Use docker-compose
cp docker-compose.example.yml docker-compose.yml
docker-compose up -d

This PR transforms the project into a fully automated, well-tested, and professionally deployed application with comprehensive CI/CD pipeline.

[openhands-ai]

Looks like there are a few issues preventing this PR from being merged!

• GitHub Actions are failing:
  • Run Tests

If you'd like me to help, just leave a comment, like

@OpenHands please fix the failing actions on PR #1

Feel free to include any additional details that might help me get this PR into a better state.

_{^{You can manage your notification settings}}