Add GitHub Actions CI/CD workflow and badges

- Add tests.yml workflow for automated testing
- Run unit tests on Python 3.12 and 3.13
- Check code formatting with Black
- Run integration tests on main branch (with API key secret)
- Upload coverage to Codecov
- Add badges to README (tests, python version, license, code style)
- Add CI/CD and Contributing sections to README

Author: howethomas

.github/workflows/tests.yml

@@ -0,0 +1,85 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13"]
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+
+    - name: Run unit tests with coverage
+      run: |
+        pytest tests/ --cov=speechmatics_vcon_link --cov-report=xml --cov-report=term-missing -v
+
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v4
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}
+        files: ./coverage.xml
+        flags: unittests
+        name: codecov-umbrella
+        fail_ci_if_error: false
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.12"
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install black
+
+    - name: Check code formatting with Black
+      run: |
+        black --check speechmatics_vcon_link/ tests/
+
+  integration:
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    needs: test
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.12"
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+
+    - name: Run integration tests
+      if: env.SPEECHMATICS_API_KEY != ''
+      env:
+        SPEECHMATICS_API_KEY: ${{ secrets.SPEECHMATICS_API_KEY }}
+      run: |
+        pytest tests/test_integration.py --run-integration -v
+

README.md

@@ -1,5 +1,10 @@
 # Speechmatics vCon Link
 
+[![Tests](https://github.com/vcon-dev/speechmatics-link/actions/workflows/tests.yml/badge.svg)](https://github.com/vcon-dev/speechmatics-link/actions/workflows/tests.yml)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+
 A vCon server link for transcribing audio dialogs using the [Speechmatics](https://www.speechmatics.com/) API. This link processes vCon objects and stores transcription results in both Speechmatics native format and the standardized [World Transcription Format (WTF)](https://datatracker.ietf.org/doc/draft-howe-vcon-wtf-extension/).
 
 ## Features
@@ -305,6 +310,33 @@ speechmatics-link/
 - Check module name in config matches: `speechmatics_vcon_link`
 - Restart vcon-server after installation
 
+## CI/CD
+
+This project uses GitHub Actions for continuous integration:
+
+- **Unit Tests**: Run on every push and PR (Python 3.12 and 3.13)
+- **Code Formatting**: Checked with Black
+- **Integration Tests**: Run on main branch pushes (requires `SPEECHMATICS_API_KEY` secret)
+- **Coverage**: Uploaded to Codecov
+
+### Setting Up Secrets
+
+For integration tests to run in CI, add the following secrets to your GitHub repository:
+
+1. `SPEECHMATICS_API_KEY` - Your Speechmatics API key
+2. `CODECOV_TOKEN` - (Optional) Codecov token for coverage reports
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes
+4. Run tests (`pytest tests/ -v`)
+5. Format code (`black speechmatics_vcon_link/ tests/`)
+6. Commit your changes (`git commit -m 'Add amazing feature'`)
+7. Push to the branch (`git push origin feature/amazing-feature`)
+8. Open a Pull Request
+
 ## License
 
 MIT License - see [LICENSE](LICENSE) for details.