testing-integration

Purpose

This skill facilitates integration testing for APIs and services, focusing on tools like Supertest (Node.js), httpx (Python), Testcontainers for managing test environments, and Pact for contract testing. It ensures end-to-end verification of service interactions, database integrations, and API contracts.

When to Use

Use this skill when verifying API endpoints in a real environment, testing service integrations (e.g., with databases or external services), running containerized tests, or enforcing contracts between microservices. Apply it in CI/CD pipelines for regression testing or when mocking dependencies is insufficient.

Key Capabilities

• Perform HTTP API testing with Supertest for Node.js apps, including mocking and assertions.
• Use httpx in Python for asynchronous HTTP requests and integration with databases.
• Manage test containers via Testcontainers to spin up isolated environments (e.g., Docker-based databases).
• Conduct contract testing with Pact to define and verify API provider-consumer agreements.
• Support for service integration testing, such as linking APIs to external services or databases.

Usage Patterns

To use this skill, first install required dependencies (e.g., via npm or pip). Set up test files in your project, configure environments with variables like $API_BASE_URL, and run tests using a test runner. For API tests, structure code to send requests and assert responses. For contract testing, define pacts in separate files and verify them against providers. Always isolate tests with containers to avoid side effects. Example pattern: Import the tool, define a test function, send requests, and handle assertions within 2-3 lines.