Refactor testing framework with pytest fixtures and modular architecture

Author: sanketsabharwal

tests/README.md

@@ -237,4 +237,103 @@ Example output structure:
     "parameters": {...}
   }
 }
+```
+
+---
+
+# Testing Framework
+
+## Project Structure
+
+```
+tests/
+├── feature_test_cli.py       # Main CLI tool
+├── conftest.py                # Pytest fixtures & helpers
+├── test_helpers/              # Reusable utilities
+│   ├── cli_formatting.py      # Colors & formatting
+│   ├── thresholds.py          # Threshold values
+│   └── base_tester.py         # Base tester class
+└── unit/
+    └── test_complete.py       # Unit tests (50 tests)
+```
+
+## Running Tests
+
+```bash
+# Run all tests
+python -m pytest tests/unit/test_complete.py -v
+
+# Run quietly
+python -m pytest tests/unit/test_complete.py -q
+
+# Run specific test class
+python -m pytest tests/unit/test_complete.py::TestSynchronizationTester -v
+
+# Run specific test
+python -m pytest tests/unit/test_complete.py::TestSynchronizationTester::test_basic_sync_test -v
+```
+
+## Writing Tests
+
+We will be using fixtures from `conftest.py` instead of creating test files manually:
+
+```python
+def test_example(sync_tester):
+    """Test synchronization."""
+    result = sync_tester.test('sine', length=100, freq=1.0)
+    assert_valid_result(result, ['plv', 'phase_status'])
+    assert result['plv'] > 0.5
+```
+
+Available fixtures:
+- `sync_tester` - SynchronizationTester
+- `smoothness_tester` - SmoothnessTester
+- `symmetry_tester` - BilateralSymmetryTester
+- `equilibrium_tester` - EquilibriumTester
+- `contraction_tester` - ContractionExpansionTester
+
+Helper function `assert_valid_result(result, expected_keys)` validates results contain expected keys.
+
+## Parametrized Tests
+
+Test multiple scenarios efficiently:
+
+```python
+@pytest.mark.parametrize("signal_type", ['sine', 'square', 'triangle'])
+def test_multiple_signals(sync_tester, signal_type):
+    result = sync_tester.test(signal_type, length=100)
+    assert_valid_result(result, ['plv'])
+```
+
+## Thresholds
+
+Threshold values are in `test_helpers/thresholds.py`:
+
+```python
+from tests.test_helpers import FeatureThresholds
+
+thresholds = FeatureThresholds()
+thresholds.sync.HIGH                    # 0.8
+thresholds.smoothness.VERY_SMOOTH       # -1.6
+thresholds.equilibrium.HIGH_STABILITY   # 0.9
+thresholds.symmetry.HIGH_SYMMETRY       # 0.95
+```
+
+Edit that file to change threshold values globally.
+
+## Troubleshooting
+
+**Import errors**: Install package in editable mode
+```bash
+pip install -e .
+```
+
+**Fixtures not found**: Verify conftest.py location
+```bash
+python -m pytest tests/ --collect-only
+```
+
+**Slow tests**: Use quiet mode
+```bash
+python -m pytest tests/unit/test_complete.py -q --tb=line
 ```

tests/__init__.py

@@ -0,0 +1 @@
+"""PyEyesWeb Testing Framework."""

tests/conftest.py

@@ -0,0 +1,60 @@
+"""Pytest configuration and shared fixtures for tests."""
+import pytest
+from tests.feature_test_cli import (
+    SynchronizationTester,
+    SmoothnessTester,
+    BilateralSymmetryTester,
+    EquilibriumTester,
+    ContractionExpansionTester
+)
+
+
+# ============================================================================
+# FIXTURES FOR FEATURE TESTERS
+# ============================================================================
+
+@pytest.fixture
+def sync_tester():
+    """Fixture for SynchronizationTester with verbose=False."""
+    return SynchronizationTester(verbose=False)
+
+
+@pytest.fixture
+def smoothness_tester():
+    """Fixture for SmoothnessTester with verbose=False."""
+    return SmoothnessTester(verbose=False)
+
+
+@pytest.fixture
+def symmetry_tester():
+    """Fixture for BilateralSymmetryTester with verbose=False."""
+    return BilateralSymmetryTester(verbose=False)
+
+
+@pytest.fixture
+def equilibrium_tester():
+    """Fixture for EquilibriumTester with verbose=False."""
+    return EquilibriumTester(verbose=False)
+
+
+@pytest.fixture
+def contraction_tester():
+    """Fixture for ContractionExpansionTester with verbose=False."""
+    return ContractionExpansionTester(verbose=False)
+
+
+# ============================================================================
+# HELPER FUNCTIONS
+# ============================================================================
+
+def assert_valid_result(result, expected_keys):
+    """
+    Assert that a test result is valid and contains expected keys.
+
+    Args:
+        result: The result dictionary to validate
+        expected_keys: List of keys that should be present
+    """
+    assert result is not None, "Result should not be None"
+    for key in expected_keys:
+        assert key in result, f"Result should contain key '{key}'"