Keploy: API, Integration, and E2E Testing Agent for Developers

Summary

Keploy is an innovative developer-centric tool designed to simplify API and integration testing. It automatically generates tests and data mocks directly from user traffic, leveraging eBPF for code-less and language-agnostic operation. This powerful agent helps developers achieve high test coverage and streamline their testing workflows efficiently.

Use at your own risk

OSRepos shares public repositories for knowledge and discovery only. Any installation, execution, configuration, or use of code from these repositories is the user's own responsibility. Always review the repository, source code, dependencies, licenses, and security implications before running or installing anything. OSRepos is not responsible for issues, damages, or losses resulting from third-party repositories.

Introduction

Keploy is an open-source, developer-centric API and integration testing tool that revolutionizes how developers approach testing. It automatically generates tests and data mocks by recording API calls, database queries, and streaming events from your application's real user traffic. By utilizing eBPF under the hood, Keploy offers a completely code-less and language-agnostic solution, making it incredibly versatile for any stack.

With over 14,000 stars on GitHub, Keploy is rapidly gaining traction as a must-have tool for achieving 90% test coverage in the AI-Gen era. It aims to make API tests faster than unit tests, significantly reducing the effort required for comprehensive testing.

Installation

Getting started with Keploy is straightforward. You can install the Keploy agent with a single command:

curl --silent -O -L https://keploy.io/install.sh && source install.sh

Examples

Once installed, you can easily record test cases and run tests for your application.

Record Test Cases

Start your application under Keploy to automatically convert real API calls into tests and mocks:

keploy record -c "CMD_TO_RUN_APP"

For a Python application, an example would be:

keploy record -c "python main.py"

Run Tests

Run your generated tests offline without needing external dependencies:

keploy test -c "CMD_TO_RUN_APP" --delay 10

Why Use Keploy?

Keploy offers several compelling features that make it an indispensable tool for modern development:

No Code Changes: Keploy captures traffic at the network layer using eBPF, eliminating the need for SDKs or code modifications. Just run your app with keploy record.
Record and Replay Complex Flows: It can record and replay intricate, distributed API flows as mocks and stubs, acting as a lightweight time machine for your tests.
Complete Infra-Virtualization: Beyond just HTTP endpoints, Keploy records and replays interactions with databases (Postgres, MySQL, MongoDB), streaming/queues (Kafka, RabbitMQ), and external APIs, allowing tests to run deterministically without re-provisioning infrastructure.
Combined Test Coverage: Keploy calculates statement, branch, API schema, and business use-case coverage, providing comprehensive insights for both developers and QA teams.
Expand API Coverage using AI: Leveraging existing recordings and OpenAPI schemas, Keploy uses AI to identify boundary values, missing fields, wrong types, and more, expanding API schema, statement, and branch coverage.
CI/CD Integration: Seamlessly integrate Keploy tests into your CI pipeline (Jenkins, GitHub Actions) or across Kubernetes clusters.
Multi-Purpose Mocks: Use Keploy-generated mocks not only for testing but also as server tests.
Reporting: Get unified reports for API, integration, unit, and E2E coverage directly in your CI or PRs.
Time Freezing: Deterministically replay tests by freezing system time during execution.
Mock Registry: A centralized registry to manage, reuse, and version mocks across teams and environments.
Language and Framework Agnostic: Thanks to its eBPF-based approach, Keploy works with virtually any language, framework, or runtime, including Go, Java, Node.js, Python, Rust, and many more.