Welcome to Keploy 👋

Keploy

Keploy is a functional testing toolkit for developers. It generates E2E tests for APIs (KTests) along with mocks or stubs(KMocks) by recording real API calls. KTests can be imported as mocks for consumers and vice-versa.

Merge KTests with unit testing libraries(like Go-Test, JUnit..) to track combined test-coverage.

KMocks can also be referenced in existing tests or use anywhere (including any testing framework). KMocks can also be used as tests for the server.

Keploy is testing itself with without writing many test-cases or data-mocks. 😎

Language Support

How it works?

Safely replays all CRUD operations (including non-idempotent APIs)

Keploy act as a proxy in your application that captures and replays all network interaction served to application from any source.

Visit How Keploy Works ? to read more in detail.

Documentation

Here you can find the complete Documentation which you can refer.

Contributing

Whether you are a community member or not, we would love your point of view! Feel free to first check out our:-

Contribution Guidelines - The guide outlines the process for creating an issue and submitting a pull request.
Code of Conduct - By following the guide we've set, your contribution will more likely be accepted if it enhances the project.

Features

1. Export tests and mocks and maintain alongside existing tests

2. Integrates with existing Unit testing frameworks

Keploy has native interoperability as it integrates with popular testing libraries like go-test, junit. Code coverage will be reported with existing plus KTests. It'll also be integrated in CI pipelines/infrastructure automatically if you already have go-test, junit integrated.

3. Accurate Noise Detection

Filters noisy fields in API responses like (timestamps, random values) to ensure high quality tests.

4. Statistical De-duplication

Ensures that redundant testcases are not generated.

Quick Installation

Docker

Keploy can be used on Linux & Windows through Docker.

Support for MacOS is work in progress.

Creating Alias

We need to create a custom network for Keploy since we are using the Docker.

docker network create keploy-network

Once the Custom Network is created, now we have to create the alias for the Keploy.

alias keploy='sudo docker run --name keploy-v2 -p 16789:16789 --network keploy-network --privileged --pid=host -it -v "$(pwd)":/files -v /sys/fs/cgroup:/sys/fs/cgroup -v /sys/kernel/debug:/sys/kernel/debug -v /sys/fs/bpf:/sys/fs/bpf -v /var/run/docker.sock:/var/run/docker.sock --rm ghcr.io/keploy/keploy'

Capture the Testcases

Now, we will use the newly created Alias keploy to record the testcases. Run the following command in root directory of the you're application.

Note :- add the container_name under your application service inside the 'docker-compose.yaml'if you are running via docker-compose up.

keploy record -c "Docker_CMD_to_run_user_container --network keploy-network" --containerName "<contianerName>"

Make API Calls using Hoppscotch, Postman or cURL command.

Keploy will capture the API calls you had made to generate the test-suites which will contain the testcases and data mocks into YAML format.

Run the Testcases

Now, we will use the newly created Alias keployV2 to test the testcases.Run the following command in root directory of the you're application.

keploy test -c "Docker_CMD_to_run_user_container --network keploy-network" --containerName "<contianerName>" --delay 20

Docker_CMD_to_run_user_container is the docker command to run the application.

If you are using docker-compose command to start the application, --containerName is required.

Note :- add the container_name under your application service inside the 'docker-compose.yaml'if you are running via docker-compose up.

Voilà! 🧑🏻‍💻 We have the server running!

Using Binary ( Linux / WSL)

Keploy can be used on Linux natively and via WSL on Winodows. Support for MacOS using Colima is work in progress.

Guide for native Installation

Download the Keploy Binary.

AMD Architecture

curl --silent --location "https://github.com/keploy/keploy/releases/latest/download/keploy_linux_amd64.tar.gz" | tar xz -C /tmp

sudo mkdir -p /usr/local/bin && sudo mv /tmp/keploy /usr/local/bin && keploy

ARM Architecture

curl --silent --location "https://github.com/keploy/keploy/releases/latest/download/keploy_linux_arm64.tar.gz" | tar xz -C /tmp

sudo mkdir -p /usr/local/bin && sudo mv /tmp/keploy /usr/local/bin && keploy

Capture the Testcases.

Run this command on your terminal to start the recording of API calls:-

sudo -E keploy record -c "CMD_TO_RUN_APP"

for example, if you are golang framework then the command would be:-

sudo -E keploy record -c "relative_path_of_go_binary of your application"

Run the Testcases.

Run this command on your terminal to run the testcases and generate the test coverage report:-

sudo -E keploy test -c "CMD_TO_RUN_APP" --delay 10