feat: Set up comprehensive Python testing infrastructure

[llbbl]

Set up comprehensive Python testing infrastructure

Summary

This PR establishes a complete testing infrastructure for the btcpay-python project, transitioning from the legacy setup.py approach to a modern Poetry-based development environment with comprehensive testing capabilities.

Changes Made

Package Management

• Migrated to Poetry: Created pyproject.toml with full Poetry configuration
• Updated Python requirement: Changed minimum version from 3.6 to 3.8 for better compatibility
• Preserved existing dependencies: Migrated requests and ecdsa from setup.py
• Added development dependencies: pytest, pytest-cov, pytest-mock in separate test group

Testing Configuration

• pytest configuration: Comprehensive setup in pyproject.toml with:
  • Test discovery patterns for multiple file naming conventions
  • Coverage reporting with 80% threshold requirement
  • HTML and XML coverage output formats
  • Custom markers: unit, integration, slow
  • Strict configuration and verbose output

Directory Structure

• Organized test layout:

  tests/
  ├── __init__.py
  ├── conftest.py          # Shared fixtures and test utilities
  ├── unit/                # Unit tests directory
  │   └── __init__.py
  ├── integration/         # Integration tests directory  
  │   └── __init__.py
  └── test_setup_validation.py  # Infrastructure validation tests
  

Shared Test Utilities

• conftest.py fixtures:
  • temp_dir: Temporary directory for test files
  • mock_config: Mock BTCPay configuration object
  • mock_requests: Mock requests library responses
  • sample_invoice_data: Sample invoice data for testing
  • mock_btcpay_client: Mock BTCPay client instance
  • env_vars: Environment variable setup for tests

Development Environment

• Updated .gitignore: Added testing artifacts, IDE files, virtual environments
• Coverage configuration: Source inclusion/exclusion rules, reporting thresholds
• Validation tests: Comprehensive tests to verify infrastructure setup

Running Tests

Basic Usage

# Install dependencies
poetry install

# Run all tests
poetry run pytest

# Run with coverage
poetry run pytest --cov=btcpay

# Run specific test categories
poetry run pytest -m unit          # Unit tests only
poetry run pytest -m integration   # Integration tests only
poetry run pytest -m slow          # Slow tests only

Coverage Reporting

# Generate HTML coverage report
poetry run pytest --cov=btcpay --cov-report=html

# View coverage in browser
open htmlcov/index.html

Validation

The infrastructure has been validated with:

• ✅ All validation tests passing (10/10)
• ✅ Poetry installation and dependency resolution working
• ✅ pytest configuration properly loaded
• ✅ Coverage reporting generating HTML and XML output
• ✅ Custom markers functioning correctly
• ✅ Shared fixtures accessible to tests

Notes

• Python 3.8+ required: Updated from 3.6 to ensure compatibility with latest testing tools
• No lock files in .gitignore: poetry.lock is intentionally tracked for reproducible builds
• Ready for development: Infrastructure is complete and ready for writing actual tests
• Backward compatibility: Existing package functionality unchanged, only development tooling added

The project is now equipped with a modern, comprehensive testing infrastructure that follows Python best practices and provides excellent developer experience.

🤖 Generated with Claude Code