Integration Testing

Integration Testing with External Services

Quick Start

This skill helps you set up integration tests with external services:

When to Use This Skill

Use this skill when you need to:

Setup Options

Testcontainers Setup

For integration tests with real services:

# Basic testcontainers example
from testcontainers.postgres import PostgresContainer
def test_with_postgres():
    with PostgresContainer("postgres:15") as postgres:
        connection_string = postgres.get_connection_url()
        # Run tests with real PostgreSQL

See testcontainers-guide.md for detailed setup.

WireMock Setup

For mocking HTTP services:

# WireMock configuration example
from wiremock import WireMockServer
def test_with_wiremock():
    with WireMockServer() as wiremock:
        wiremock.stub_for(
            request_method="GET",
            request_url="/api/users",
            response_body='{"users": []}'
        )
        # Test against mocked API

See wiremock-patterns.md for common patterns.

LocalStack Setup

For testing S3 without AWS:

# LocalStack S3 testing example
import boto3
from localstack import start_localstack
def test_s3_with_localstack():
    with start_localstack(services=["s3"]) as localstack:
        s3 = boto3.client('s3', endpoint_url=localstack.endpoint_url)
        # Test S3 operations locally

See localstack-s3-config.md for S3 configuration.

SFTP Integration Testing

For testing SFTP connectivity and operations:

# SFTP integration test example
from paramiko import SSHClient
def test_sftp_operations():
    with SSHClient() as ssh:
        ssh.connect('sftp-server', username='test', password='test')
        sftp = ssh.open_sftp()
        # Test SFTP file operations

Available Templates

Ready-to-use test templates for common scenarios:

Helper Scripts

Setup scripts to initialize test environments:

Best Practices

1. Container Management: Always use context managers for container lifecycle 2. Port Conflicts: Configure ports to avoid conflicts with local services 3. Cleanup: Ensure proper cleanup of resources in test teardown 4. Environment Variables: Use env vars for configuration, avoid hardcoded values 5. Parallel Testing: Design tests to run in parallel where possible

Getting Help

For detailed setup and patterns, see:

Security & Compliance

This skill is designed SOLELY for legitimate integration testing purposes in isolated development environments.

⚠️ Important Security Notes

For detailed security information, see SECURITY.md

This skill helps you set up integration tests with external services:

1. Container Management: Always use context managers for container lifecycle 2. Port Conflicts: Configure ports to avoid conflicts with local services 3. Cleanup: Ensure proper cleanup of resources in test teardown 4. Environment Variables: Use env vars for configuration, avoid hardcoded values 5. Parallel Testing: Design tests to run in parallel where possible