Add integration tests and fix Speechmatics API client

- Add live integration tests that call real Speechmatics API
- Fix client to use multipart/form-data format (required by API)
- Add conftest.py with --run-integration flag support
- Save real transcription outputs to fixtures for reference
- Update unit tests for new multipart request format

Integration tests: 9 tests, requires SPEECHMATICS_API_KEY env var
Unit tests: 116 tests, 93% coverage

Author: howethomas

speechmatics_vcon_link/client.py

@@ -161,6 +161,8 @@ def submit_job(
             SpeechmaticsAuthError: If API key is invalid
             SpeechmaticsError: If job submission fails
         """
+        import json as json_module
+        
         if config is None:
             config = TranscriptionConfig()
 
@@ -176,9 +178,15 @@ def submit_job(
         logger.info(f"Submitting transcription job for: {audio_url}")
 
         try:
+            # Speechmatics API requires multipart/form-data
+            # The config is sent as a JSON string in the 'config' field
+            files = {
+                'config': (None, json_module.dumps(job_config), 'application/json')
+            }
+            
             response = self._session.post(
                 url,
-                json=job_config,
+                files=files,
                 timeout=self.timeout
             )
 
@@ -202,7 +210,7 @@ def submit_job(
         except requests.HTTPError as e:
             error_detail = ""
             try:
-                error_detail = e.response.json().get("detail", str(e))
+                error_detail = e.response.json().get("message", str(e))
             except Exception:
                 error_detail = str(e)
             raise SpeechmaticsError(f"Failed to submit job: {error_detail}") from e

tests/conftest.py

@@ -0,0 +1,32 @@
+"""Pytest configuration and fixtures for speechmatics_vcon_link tests."""
+
+import pytest
+
+
+def pytest_addoption(parser):
+    """Add command line option for running integration tests."""
+    parser.addoption(
+        "--run-integration",
+        action="store_true",
+        default=False,
+        help="Run integration tests that make real API calls",
+    )
+
+
+def pytest_configure(config):
+    """Register custom markers."""
+    config.addinivalue_line(
+        "markers", "integration: mark test as integration test (requires --run-integration)"
+    )
+
+
+def pytest_collection_modifyitems(config, items):
+    """Skip integration tests unless --run-integration is passed."""
+    if config.getoption("--run-integration"):
+        return
+    
+    skip_integration = pytest.mark.skip(reason="Need --run-integration option to run")
+    for item in items:
+        if "integration" in item.keywords:
+            item.add_marker(skip_integration)
+