algo/tests

Tests

Running Tests

# Run all linters (same as CI)
ansible-lint . && yamllint . && ruff check . && shellcheck scripts/*.sh

# Run Python unit tests
pytest tests/unit/ -q

# Run E2E connectivity tests (requires deployed Algo on localhost)
sudo tests/e2e/test-vpn-connectivity.sh both

Directory Structure

tests/
├── unit/                    # Python unit tests (pytest)
│   ├── test_basic_sanity.py
│   ├── test_config_validation.py
│   ├── test_template_rendering.py
│   └── ...
├── e2e/                     # End-to-end connectivity tests
│   └── test-vpn-connectivity.sh
├── integration/             # Integration test helpers
│   └── mock_modules/
├── fixtures/                # Shared test data
│   └── test_variables.yml
└── conftest.py              # Pytest configuration

Test Coverage

Category	Tests	What's Verified
Sanity	test_basic_sanity.py	Python version, config syntax, playbook validity
Config	test_config_validation.py	WireGuard/IPsec config formats, key validation
Templates	test_template_rendering.py	Jinja2 template syntax, filter compatibility
Certificates	test_certificate_validation.py	OpenSSL compatibility, PKCS#12 export
Cloud Providers	test_cloud_provider_configs.py	Region formats, instance types, OS images
E2E	test-vpn-connectivity.sh	WireGuard handshake, IPsec connection, DNS through VPN

CI Workflows

Workflow	Trigger	What It Does
lint.yml	All PRs	ansible-lint, yamllint, ruff, shellcheck
main.yml	Push to master	Syntax check, unit tests, Docker build
integration-tests.yml	PRs to roles/	Full localhost deployment + E2E tests
smart-tests.yml	All PRs	Runs subset based on changed files

Writing Tests

Python Unit Tests

Place in tests/unit/. Use fixtures from conftest.py:

def test_something(mock_ansible_module, jinja_env):
    # mock_ansible_module - mocked AnsibleModule
    # jinja_env - Jinja2 environment with Ansible filters
    pass

Shell Scripts

Use bash strict mode and pass shellcheck:

#!/bin/bash
set -euo pipefail

Troubleshooting

E2E tests fail with "namespace already exists"

sudo ip netns del algo-client

Template tests fail with "filter not found" Add the filter to the mock in conftest.py.

CI fails but local passes Check Python/Ansible versions match CI (Python 3.11, Ansible 12+).