From a98b504fd3563fecaa6d82e419ec65e16101d7d6 Mon Sep 17 00:00:00 2001
From: Animesh Pathak
Date: Fri, 6 Sep 2024 11:57:54 +0530
Subject: [PATCH 1/6] feat: update slack urls
Signed-off-by: Animesh Pathak
---
CODE_OF_CONDUCT.md | 4 ++--
README.md | 4 ++--
docusaurus.config.js | 2 +-
src/components/Community.js | 2 +-
versioned_docs/version-2.0.0/concepts/support.md | 2 +-
5 files changed, 7 insertions(+), 7 deletions(-)
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
index 165ab389a..589ba35c0 100644
--- a/CODE_OF_CONDUCT.md
+++ b/CODE_OF_CONDUCT.md
@@ -20,7 +20,7 @@ The following behaviors are expected and requested of all community members:
- Show consideration and respect in all your actions and speech. Avoid any behavior that is demeaning, discriminatory, or harassing.
- Seek collaboration as an initial step instead of conflict.
- Refrain from demeaning, discriminatory, or harassing behavior and speech.
-- Report any unsafe situations, distress or violations of the code of conduct to the maintainers through [Slack](https://join.slack.com/t/keploy/shared_invite/zt-2dno1yetd-Ec3el~tTwHYIHgGI0jPe7A).
+- Report any unsafe situations, distress or violations of the code of conduct to the maintainers through [Slack](https://join.slack.com/t/keploy/shared_invite/zt-2poflru6f-_VAuvQfCBT8fDWv1WwSbkw).
- Practice empathy and kindness towards other community members.
- Respect diverse opinions, perspectives, and experiences.
- Give and receive constructive feedback in a gracious manner.
@@ -116,7 +116,7 @@ the community.
## Contact info
-- [Slack](https://join.slack.com/t/keploy/shared_invite/zt-2dno1yetd-Ec3el~tTwHYIHgGI0jPe7A)
+- [Slack](https://join.slack.com/t/keploy/shared_invite/zt-2poflru6f-_VAuvQfCBT8fDWv1WwSbkw)
- [Mail](hello@keploy.io)
## Support đ
diff --git a/README.md b/README.md
index 5b6840ac5..987b85570 100644
--- a/README.md
+++ b/README.md
@@ -38,7 +38,7 @@ Page slugs (URLs), menu labels, and the location of information are a few of the
The documentation in this repository is published to https://docs.keploy.io.
-If information you are looking for seems to be missing, visit the [Keploy community](https://join.slack.com/t/keploy/shared_invite/zt-2dno1yetd-Ec3el~tTwHYIHgGI0jPe7A) forum for help.
+If information you are looking for seems to be missing, visit the [Keploy community](https://join.slack.com/t/keploy/shared_invite/zt-2poflru6f-_VAuvQfCBT8fDWv1WwSbkw) forum for help.
Please read the [CONTRIBUTING](/CONTRIBUTING.md) guide and the [STYLE](/STYLE.md) guide before you submit any pull requests.
@@ -129,7 +129,7 @@ Keploy welcomes contributions to the docs website. If you have an idea for a new
Reach out to us. We're here to help!
-[![Slack](https://img.shields.io/badge/Slack-4A154B?style=for-the-badge&logo=slack&logoColor=white)](https://join.slack.com/t/keploy/shared_invite/zt-2dno1yetd-Ec3el~tTwHYIHgGI0jPe7A)
+[![Slack](https://img.shields.io/badge/Slack-4A154B?style=for-the-badge&logo=slack&logoColor=white)](https://join.slack.com/t/keploy/shared_invite/zt-2poflru6f-_VAuvQfCBT8fDWv1WwSbkw)
[![LinkedIn](https://img.shields.io/badge/linkedin-%230077B5.svg?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/company/keploy/)
[![YouTube](https://img.shields.io/badge/YouTube-%23FF0000.svg?style=for-the-badge&logo=YouTube&logoColor=white)](https://www.youtube.com/channel/UC6OTg7F4o0WkmNtSoob34lg)
[![Twitter](https://img.shields.io/badge/Twitter-%231DA1F2.svg?style=for-the-badge&logo=Twitter&logoColor=white)](https://twitter.com/Keployio)
diff --git a/docusaurus.config.js b/docusaurus.config.js
index 9b56db547..65e5099b6 100644
--- a/docusaurus.config.js
+++ b/docusaurus.config.js
@@ -171,7 +171,7 @@ module.exports = {
-
- );
+ );
}
function UTG() {
diff --git a/src/components/QuickStart.js b/src/components/QuickStart.js
index 515767039..1cef9e76a 100644
--- a/src/components/QuickStart.js
+++ b/src/components/QuickStart.js
@@ -22,7 +22,6 @@ export const QuickStart = () => {
With features like API testing, unit test generation, and schema/PRD-based test automation, Keploy helps teams release faster while maintaining high reliability.
Itâs easy to use, extensible, and integrates seamlessly into CI/CD pipelines, making backend testing efficient and productive.
-
- Welcome to Keployâs documentation! Whether you're new to backend testing or an experienced developer, this guide will help you get started with Keploy quickly and effectively.đşď¸
+ Welcome to Keployâs documentation! Whether you're new to backend testing
+ or an experienced developer, this guide will help you get started with
+ Keploy quickly and effectively.đşď¸
What is Keploy? đ¤
- Keploy is an open-source backend testing tool that helps developers quickly create and run tests by capturing
- real user traffic. It generates test cases and data mocks to ensure your code is reliable and helps speed up your release cycle..đ ď¸
-
- With features like API testing, unit test generation, and schema/PRD-based test automation, Keploy helps teams release faster while maintaining high reliability.
- Itâs easy to use, extensible, and integrates seamlessly into CI/CD pipelines, making backend testing efficient and productive.
+ Keploy is an open-source backend testing tool that helps developers
+ quickly create and run tests by capturing real user traffic. It
+ generates test cases and data mocks to ensure your code is reliable and
+ helps speed up your release cycle..đ ď¸
+
+
+ With features like API testing, unit test generation, and
+ schema/PRD-based test automation, Keploy helps teams release faster
+ while maintaining high reliability. Itâs easy to use, extensible, and
+ integrates seamlessly into CI/CD pipelines, making backend testing
+ efficient and productive.
- â ď¸ Important Note: Keploy v2 is currently in Beta, and the best experience is on Linux. Docker support is experimental, and some limitations may apply.
+ â ď¸ Important Note: Keploy v2 is currently in Beta, and the best
+ experience is on Linux. Docker support is experimental, and some
+ limitations may apply.
);
diff --git a/src/css/custom.css b/src/css/custom.css
index b52d1313b..2f58b44a0 100644
--- a/src/css/custom.css
+++ b/src/css/custom.css
@@ -9,7 +9,6 @@
font-size:18px;
line-height: 1.6;
--ifm-color-primary: #000;
-
--ifm-color-primary-lighter: #FFF;
--ifm-color-primary: #ff914d;
--ifm-color-primary-dark: #e67643;
@@ -87,6 +86,24 @@ html[data-theme="light"] {
--ifm-card-shadow-color: rgba(0, 0, 0, 0.2); /* Dark shadow for light theme */
}
+html[data-theme='light'] .theme-doc-sidebar-container {
+ border-right: 1px solid #676565;
+}
+
+/* Sidebar border for dark theme */
+html[data-theme='dark'] .theme-doc-sidebar-container {
+ border-right: 1px solid #676565;
+}
+
+html[data-theme='light'] .col--3 {
+ border-left: 1px solid #676565;
+}
+
+/* TOC column border for dark theme */
+html[data-theme='dark'] .col--3 {
+ border-left: 1px solid #676565;
+}
+
@font-face {
font-family: "Roboto";
src: url("../fonts/Roboto-Light.woff2");
diff --git a/tailwind.config.js b/tailwind.config.js
index 01d960f96..281b45496 100644
--- a/tailwind.config.js
+++ b/tailwind.config.js
@@ -14,7 +14,7 @@ module.exports = {
"./src/theme/**/*.{js,ts,jsx,tsx}",
],
corePlugins: {
- preflight: false,
+ preflight: false,
},
// corePlugins: {
// // preflight: false, // to use Docusaurus base styles
diff --git a/versioned_docs/version-2.0.0/ci-cd/github.md b/versioned_docs/version-2.0.0/ci-cd/github.md
index 010dbca90..330308e71 100644
--- a/versioned_docs/version-2.0.0/ci-cd/github.md
+++ b/versioned_docs/version-2.0.0/ci-cd/github.md
@@ -13,6 +13,7 @@ tags:
- cd
- plugin
---
+
Integrating with GitHub CI | Keploy Docs
diff --git a/versioned_docs/version-2.0.0/ci-cd/gitlab.md b/versioned_docs/version-2.0.0/ci-cd/gitlab.md
index a5f72205d..c36c02174 100644
--- a/versioned_docs/version-2.0.0/ci-cd/gitlab.md
+++ b/versioned_docs/version-2.0.0/ci-cd/gitlab.md
@@ -13,6 +13,7 @@ tags:
- cd
- plugin
---
+
Integrating with GitLab CI | Keploy Docs
diff --git a/versioned_docs/version-2.0.0/ci-cd/jenkins.md b/versioned_docs/version-2.0.0/ci-cd/jenkins.md
index ec648519f..46ea0cb26 100644
--- a/versioned_docs/version-2.0.0/ci-cd/jenkins.md
+++ b/versioned_docs/version-2.0.0/ci-cd/jenkins.md
@@ -13,6 +13,7 @@ tags:
- cd
- plugin
---
+
Integrating with Jenkins | Keploy Docs
diff --git a/versioned_docs/version-2.0.0/concepts/installation.md b/versioned_docs/version-2.0.0/concepts/installation.md
index 486303d0c..eef71610c 100644
--- a/versioned_docs/version-2.0.0/concepts/installation.md
+++ b/versioned_docs/version-2.0.0/concepts/installation.md
@@ -20,6 +20,7 @@ keywords:
- installation-guide
- server-setup
---
+
Installation | Keploy Docs
@@ -70,111 +71,3 @@ Use "keploy [command] --help" for more information about a command.
```
đ Wohoo! You are all set to use Keploy.
-
-## Other Installation Methods
-
-
-Install using Docker
-
-### Downloading and running Keploy in Docker
-
-#### On macOS
-
-Note : Keploy is not supported natively on MacOS, so you can follow the below method to run with docker
-
-1. Open up a terminal window.
-
-2. Create a bridge network in Docker using the following docker network create command:
-
-```bash
-docker network create keploy-network
-```
-
-3. Run the following command to start the Keploy container:
-
-```bash
-alias keploy="docker run --name keploy-v2 -p 16789:16789 --network keploy-network --privileged --pid=host -v $(pwd):$(pwd) -w $(pwd) -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"
-```
-
-
-
-
-Downloading and running Keploy in Native
-
-### Downloading and running Keploy in Native
-
-**Prequisites:**
-
-- Linux Kernel version 5.15 or higher
-- Run `uname -a` to verify the system architecture.
-- In case of Windows, use WSL with Ubuntu 20.04 LTS or higher.
-
-Downloading and running Keploy On WSL/Linux AMD
-
-#### On WSL/Linux AMD
-
-1. Open the terminal Session.
-2. Run the following command to download and install Keploy:
-
-```bash
-curl --silent --location "https://github.com/keploy/keploy/releases/latest/download/keploy_linux_amd64.tar.gz" | tar xz --overwrite -C /tmp
-sudo mkdir -p /usr/local/bin && sudo mv /tmp/keploy /usr/local/bin/keploy
-```
-
-#### On WSL/Linux ARM
-
-1. Open the terminal Session
-2. Run the following command to download and install Keploy:
-
-```bash
-curl --silent --location "https://github.com/keploy/keploy/releases/latest/download/keploy_linux_arm64.tar.gz" | tar xz --overwrite -C /tmp
-sudo mkdir -p /usr/local/bin && sudo mv /tmp/keploy /usr/local/bin/keploy
-
-```
-
-> Note: Keploy is not supported on MacOS natively.
-
-### Setting up the Docker Desktop for WSL 2
-
-1. Install Docker Desktop for Windows from [here](https://docs.docker.com/desktop/windows/install/).
-
-When developing on Windows with Docker Desktop and WSL 2, it's crucial to configure Docker Desktop to allow WSL 2 distributions to access the Docker daemon. This setup enables seamless integration between your Windows environment, WSL 2 Linux distros, and Docker.
-
-By default, Docker Desktop may not be configured to work with all WSL 2 distros out of the box. Proper configuration ensures that you can run Docker commands from within your WSL 2 environment, allowing for a more native Linux development experience while leveraging the power of Windows.
-
-> This setup is essential for Keploy to function correctly in a WSL 2 environment, as it needs to interact with the Docker daemon to manage containers and networks effectively.
-> For detailed instructions on how to configure `Docker Desktop` for WSL 2, please refer to the [official Docker documentation](https://docs.docker.com/desktop/wsl/).
-
-
-
-
-With Arkade
-
-### With Arkade
-
-1. Installing Arkade
-
-```bash
-# Note: you can also run without `sudo` and move the binary yourself
-curl -sLS https://get.arkade.dev | sudo sh
-
-arkade --help
-ark --help # a handy alias
-
-# Windows users with Git Bash
-curl -sLS https://get.arkade.dev | sh
-```
-
-2. Install Keploy
-
-```bash
-arkade get keploy
-```
-
-Or you can also download specific version of Keploy using the following command:
-
-```bash
-arkade get keploy@2.2.0-alpha23
-```
-
-
diff --git a/versioned_docs/version-2.0.0/concepts/what-are-keploy-features.md b/versioned_docs/version-2.0.0/concepts/what-are-keploy-features.md
index 18c1f267c..f06271558 100644
--- a/versioned_docs/version-2.0.0/concepts/what-are-keploy-features.md
+++ b/versioned_docs/version-2.0.0/concepts/what-are-keploy-features.md
@@ -17,6 +17,7 @@ keywords:
- record replay test
- mock mutations
---
+
What are Keploy Features? | Keploy Docs
diff --git a/versioned_docs/version-2.0.0/concepts/what-is-a-keploy-ebpf.md b/versioned_docs/version-2.0.0/concepts/what-is-a-keploy-ebpf.md
index 814f14ec3..ebe5482df 100644
--- a/versioned_docs/version-2.0.0/concepts/what-is-a-keploy-ebpf.md
+++ b/versioned_docs/version-2.0.0/concepts/what-is-a-keploy-ebpf.md
@@ -10,6 +10,7 @@ keywords:
- ebpf
- Testing API
---
+
What is Keploy eBPF | Keploy Docs
diff --git a/versioned_docs/version-2.0.0/concepts/what-is-keploy.md b/versioned_docs/version-2.0.0/concepts/what-is-keploy.md
index 9546cd02b..5ad36675a 100644
--- a/versioned_docs/version-2.0.0/concepts/what-is-keploy.md
+++ b/versioned_docs/version-2.0.0/concepts/what-is-keploy.md
@@ -18,6 +18,7 @@ keywords:
- API Tests
- AI Generated Tests
---
+
What is Keploy? | Keploy Docs
@@ -62,9 +63,3 @@ Now, when the application starts:
You can test with Keploy locally or can integrate Keploy with popular testing-frameworks and existing CI pipelines.
> **Note:** You can generate test cases from any environment which has all the infrastructure dependencies setup. Please consider using this to generate tests from low-traffic environments first. The deduplication feature necessary for high-traffic environments is currently experimental.
-
-Hope this helps you out, if you still have any questions, reach out to us .
-
-import GetSupport from '../concepts/support.md'
-
-
diff --git a/versioned_docs/version-2.0.0/dependencies/http.md b/versioned_docs/version-2.0.0/dependencies/http.md
index 1f0b0f606..546ddf7e2 100644
--- a/versioned_docs/version-2.0.0/dependencies/http.md
+++ b/versioned_docs/version-2.0.0/dependencies/http.md
@@ -3,6 +3,7 @@ id: http
title: HTTP Support
sidebar_label: HTTP
---
+
HTTP Support | Keploy Docs
diff --git a/versioned_docs/version-2.0.0/dependencies/mongo.md b/versioned_docs/version-2.0.0/dependencies/mongo.md
index 30b400761..121f7cfc7 100644
--- a/versioned_docs/version-2.0.0/dependencies/mongo.md
+++ b/versioned_docs/version-2.0.0/dependencies/mongo.md
@@ -3,6 +3,7 @@ id: mongo
title: MongoDB Support
sidebar_label: MongoDB Support
---
+
MongoDB Support | Keploy Docs
diff --git a/versioned_docs/version-2.0.0/dependencies/postgresql.md b/versioned_docs/version-2.0.0/dependencies/postgresql.md
index 75ed42d3c..fcb37435f 100644
--- a/versioned_docs/version-2.0.0/dependencies/postgresql.md
+++ b/versioned_docs/version-2.0.0/dependencies/postgresql.md
@@ -3,6 +3,7 @@ id: postgres
title: PostgresSQL Support
sidebar_label: PostgresSQL
---
+
PostgresSQL Support | Keploy Docs
diff --git a/versioned_docs/version-2.0.0/dependencies/redis.md b/versioned_docs/version-2.0.0/dependencies/redis.md
index 775157d98..7d8fac634 100644
--- a/versioned_docs/version-2.0.0/dependencies/redis.md
+++ b/versioned_docs/version-2.0.0/dependencies/redis.md
@@ -3,6 +3,7 @@ id: redis
title: Redis Support
sidebar_label: Redis Support
---
+
Redis Support | Keploy Docs
diff --git a/versioned_docs/version-2.0.0/keploy-cloud/deduplication.md b/versioned_docs/version-2.0.0/keploy-cloud/deduplication.md
index 4c9825566..857e2b657 100644
--- a/versioned_docs/version-2.0.0/keploy-cloud/deduplication.md
+++ b/versioned_docs/version-2.0.0/keploy-cloud/deduplication.md
@@ -17,6 +17,7 @@ keywords:
- node
- testcases
---
+
Remove Duplicates Tests | Keploy Docs
diff --git a/versioned_docs/version-2.0.0/keploy-cloud/installation.md b/versioned_docs/version-2.0.0/keploy-cloud/installation.md
index 6da4fe040..dd1054a4b 100644
--- a/versioned_docs/version-2.0.0/keploy-cloud/installation.md
+++ b/versioned_docs/version-2.0.0/keploy-cloud/installation.md
@@ -12,6 +12,7 @@ keywords:
- installation
- API key
---
+
Keploy Cloud Installation | Keploy Docs
diff --git a/versioned_docs/version-2.0.0/keploy-cloud/keploy-console.md b/versioned_docs/version-2.0.0/keploy-cloud/keploy-console.md
index b108cd103..7aba0f5ae 100644
--- a/versioned_docs/version-2.0.0/keploy-cloud/keploy-console.md
+++ b/versioned_docs/version-2.0.0/keploy-cloud/keploy-console.md
@@ -12,6 +12,7 @@ keywords:
- installation
- API key
---
+
Keploy Console | Keploy Docs
diff --git a/versioned_docs/version-2.0.0/keploy-cloud/mock-registry.md b/versioned_docs/version-2.0.0/keploy-cloud/mock-registry.md
index 6e45b12c5..f5a73caa5 100644
--- a/versioned_docs/version-2.0.0/keploy-cloud/mock-registry.md
+++ b/versioned_docs/version-2.0.0/keploy-cloud/mock-registry.md
@@ -12,6 +12,7 @@ keywords:
- efficient testing
- cloud storage
---
+
Mock Registry | Keploy Docs
diff --git a/versioned_docs/version-2.0.0/keploy-cloud/new-application.md b/versioned_docs/version-2.0.0/keploy-cloud/new-application.md
index b7ce16ba2..4cc962489 100644
--- a/versioned_docs/version-2.0.0/keploy-cloud/new-application.md
+++ b/versioned_docs/version-2.0.0/keploy-cloud/new-application.md
@@ -14,6 +14,7 @@ keywords:
- installation
- API key
---
+
Adding New Application to Keploy Cloud | Keploy Docs
diff --git a/versioned_docs/version-2.0.0/keploy-cloud/testgeneration.md b/versioned_docs/version-2.0.0/keploy-cloud/testgeneration.md
index c1e9252fc..57f0d71b5 100644
--- a/versioned_docs/version-2.0.0/keploy-cloud/testgeneration.md
+++ b/versioned_docs/version-2.0.0/keploy-cloud/testgeneration.md
@@ -13,6 +13,7 @@ keywords:
- OpenAPI
- Test Automation
---
+
Auto Test Generation đ | Keploy Docs
diff --git a/versioned_docs/version-2.0.0/keploy-cloud/time-freezing.md b/versioned_docs/version-2.0.0/keploy-cloud/time-freezing.md
index 22bb8eb5a..06985327c 100644
--- a/versioned_docs/version-2.0.0/keploy-cloud/time-freezing.md
+++ b/versioned_docs/version-2.0.0/keploy-cloud/time-freezing.md
@@ -13,6 +13,7 @@ keywords:
- jwt
- time sensitive fields
---
+
Time Freezing | Keploy Docs
diff --git a/versioned_docs/version-2.0.0/keploy-explained/debugger-guide.md b/versioned_docs/version-2.0.0/keploy-explained/debugger-guide.md
index e6f0d951c..08ba01f80 100644
--- a/versioned_docs/version-2.0.0/keploy-explained/debugger-guide.md
+++ b/versioned_docs/version-2.0.0/keploy-explained/debugger-guide.md
@@ -10,8 +10,6 @@ tags:
# Debugger Guide đ¨âđ§
-In this blog, we will learn how to debug keploy using Visual Studio Code integrated debugger.
-
## Setting Up Configuration File
To bring up the **Run and Debug** view, select the **Run and Debug** icon in the **Activity Bar** on the side of VS Code. You can also use the keyboard shortcut `Cmd + Shift + D` for MacOS and `Ctrl + shift + D` for Windows.
diff --git a/versioned_docs/version-2.0.0/keploy-explained/mac-linux.md b/versioned_docs/version-2.0.0/keploy-explained/mac-linux.md
index 564563c83..b83429b36 100644
--- a/versioned_docs/version-2.0.0/keploy-explained/mac-linux.md
+++ b/versioned_docs/version-2.0.0/keploy-explained/mac-linux.md
@@ -27,10 +27,9 @@ brew install lima
limactl show-ssh --format=config debian-12 & add it to its ssh config
```
-5. Open a remote window on your code editor
-6. Click on connect to host
-7. Now select the configured SSH as "lima-debian"
-8. Once you are in the terminal run the following commands to go into your directory
+5. Open a remote window on your code editor and Click on connect to host
+6. Now select the configured SSH as "lima-debian"
+7. Once you are in the terminal run the following commands to go into your directory
```bash
cd /Users
@@ -40,82 +39,33 @@ cd /Users
cd /{Username}
```
-9. Run the following command to install Keploy
+8. Run the following command to install Keploy
```bash
curl --silent --location "https://github.com/keploy/keploy/releases/latest/download/keploy_linux_arm64.tar.gz" | tar xz --overwrite -C /tmp
sudo mkdir -p /usr/local/bin && sudo mv /tmp/keploy /usr/local/bin/keploy
```
-10. Run the following command to install Zsh
-
-```bash
-sudo apt-get -y install zsh
-```
-
-**Why?** : zsh (Z Shell) is an advanced shell that offers enhanced features compared to the default bash shell. It provides better autocompletion, advanced globbing, improved history management, and more customization options.
-
-11. Install Git
-
-```bash
-sudo apt-get -y install git
-```
-
-12. Install 'Oh-my-zsh'
-
-```bash
-sh -c "$(wget https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh -O -)"
-```
-
-**Why?** : oh-my-zsh is a framework for managing your zsh configuration. It comes with a collection of plugins, themes, and helpful features that enhance the zsh experience.
-
-13. Commands to Install docker
+9. Commands to Install docker
```bash
sudo apt-get -y update
-```
-
-```bash
sudo apt-get -y install ca-certificates curl
-```
-
-```bash
sudo install -m 0755 -d /etc/apt/keyrings
-```
-
-```bash
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
-```
-
-```bash
sudo chmod a+r /etc/apt/keyrings/docker.asc
-```
-```bash
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
-```
-
-```bash
-sudo apt-get -y update
-```
-
-```bash
-sudo apt-get -y update
-```
-```bash
sudo apt-get -y install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```
-14. Add docker to sudoers
+10. Add docker to sudoers
```bash
sudo groupadd docker
-```
-
-```bash
sudo gpasswd -a $USER docker
```
diff --git a/versioned_docs/version-2.0.0/keploy-explained/why-keploy.md b/versioned_docs/version-2.0.0/keploy-explained/why-keploy.md
index df995a6c0..696d02d4e 100644
--- a/versioned_docs/version-2.0.0/keploy-explained/why-keploy.md
+++ b/versioned_docs/version-2.0.0/keploy-explained/why-keploy.md
@@ -11,6 +11,8 @@ tags:
- record replay test
---
+Keploy is designed to enhance your testing process by giving superpowers to developers. Whether you're looking for automated test scripting, easy CI/CD integration, or enhanced test coverage with zero effort, Keploy provides everything you need to elevate your testing workflow.
+
| **Feature** | **Automated Test-Scripting Tools** | **Record-Replay Traffic Tools** | **Keploy** |
| ------------------------------------------ | ------------------------------------------------------- | --------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| **Test Scripting** | Manual test script creation. | Record user traffic as tests scripts. | Automatic user traffic recording as test scripts. |
diff --git a/versioned_docs/version-2.0.0/migrate/index.md b/versioned_docs/version-2.0.0/migrate/index.md
index 373ec806e..613a46c62 100644
--- a/versioned_docs/version-2.0.0/migrate/index.md
+++ b/versioned_docs/version-2.0.0/migrate/index.md
@@ -11,4 +11,4 @@ minutes. âąď¸
- [Linux](versioned_docs/version-2.0.0/server/linux/installation.md)
- [MacOS](versioned_docs/version-2.0.0/server/macos/installation.md)
-â ď¸ Please note that Keploy v2 is currently in development, with the best experience on Linux. Docker support is experimental and may have some limitations for certain use cases.
\ No newline at end of file
+â ď¸ Please note that Keploy v2 is currently in development, with the best experience on Linux. Docker support is experimental and may have some limitations for certain use cases.
diff --git a/versioned_docs/version-2.0.0/quickstart/csharp-dotnet-postgres.md b/versioned_docs/version-2.0.0/quickstart/csharp-dotnet-postgres.md
index 02da93e20..214800c04 100644
--- a/versioned_docs/version-2.0.0/quickstart/csharp-dotnet-postgres.md
+++ b/versioned_docs/version-2.0.0/quickstart/csharp-dotnet-postgres.md
@@ -28,10 +28,9 @@ keyword:
đŞ Dive into the world of User Authentication apps and see how seamlessly Keploy integrates with [.Net](https://dotnet.microsoft.com/en-us/) and [Postgres](https://www.postgresql.org/). Buckle up, it's gonna be a fun ride! đ˘
-
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
@@ -44,7 +43,7 @@ Or, you can follow the detailed instructions [here](https://keploy.io/docs/serve
### Clone a sample user authentication app đ§Ş
```bash
-git clone https://github.com/keploy/samples-csharp.git
+git clone https://github.com/keploy/samples-csharp.git
cd samples-csharp/crud-app
# start the database instance
diff --git a/versioned_docs/version-2.0.0/quickstart/express-postgresql-prisma.md b/versioned_docs/version-2.0.0/quickstart/express-postgresql-prisma.md
index 9dabdf77a..a74379ca4 100644
--- a/versioned_docs/version-2.0.0/quickstart/express-postgresql-prisma.md
+++ b/versioned_docs/version-2.0.0/quickstart/express-postgresql-prisma.md
@@ -29,7 +29,7 @@ A sample Task Management application and see how seamlessly Keploy integrates wi
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/quickstart/flask-redis.md b/versioned_docs/version-2.0.0/quickstart/flask-redis.md
index 488c2dd26..b96a4ca19 100644
--- a/versioned_docs/version-2.0.0/quickstart/flask-redis.md
+++ b/versioned_docs/version-2.0.0/quickstart/flask-redis.md
@@ -32,7 +32,7 @@ keyword:
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/quickstart/go-fasthttp-postgres.md b/versioned_docs/version-2.0.0/quickstart/go-fasthttp-postgres.md
index fd608f367..104722623 100644
--- a/versioned_docs/version-2.0.0/quickstart/go-fasthttp-postgres.md
+++ b/versioned_docs/version-2.0.0/quickstart/go-fasthttp-postgres.md
@@ -30,7 +30,7 @@ keyword:
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/quickstart/go-gin-redis.md b/versioned_docs/version-2.0.0/quickstart/go-gin-redis.md
index d08dda465..a45c2cbf1 100644
--- a/versioned_docs/version-2.0.0/quickstart/go-gin-redis.md
+++ b/versioned_docs/version-2.0.0/quickstart/go-gin-redis.md
@@ -30,7 +30,7 @@ keyword:
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/quickstart/go-mux-mysql.md b/versioned_docs/version-2.0.0/quickstart/go-mux-mysql.md
index 946e0d09e..9b3b56462 100644
--- a/versioned_docs/version-2.0.0/quickstart/go-mux-mysql.md
+++ b/versioned_docs/version-2.0.0/quickstart/go-mux-mysql.md
@@ -31,7 +31,7 @@ A sample url shortener app to test Keploy integration capabilities using [Mux](h
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/quickstart/go-mux-sql.md b/versioned_docs/version-2.0.0/quickstart/go-mux-sql.md
index 15da942cc..cfa421b73 100644
--- a/versioned_docs/version-2.0.0/quickstart/go-mux-sql.md
+++ b/versioned_docs/version-2.0.0/quickstart/go-mux-sql.md
@@ -19,6 +19,7 @@ keyword:
- API Test generator
- Auto Testcase generation
---
+
Mux + Postgres | Keploy Docs
@@ -30,7 +31,7 @@ keyword:
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/quickstart/java-spring-boot-mongo.md b/versioned_docs/version-2.0.0/quickstart/java-spring-boot-mongo.md
index 24b93123c..2fe6b3c37 100644
--- a/versioned_docs/version-2.0.0/quickstart/java-spring-boot-mongo.md
+++ b/versioned_docs/version-2.0.0/quickstart/java-spring-boot-mongo.md
@@ -23,6 +23,7 @@ keyword:
- Auto Testcase generation
- Junit
---
+
Spring-Boot + MongoDB | Keploy Docs
@@ -34,7 +35,7 @@ keyword:
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
@@ -42,7 +43,6 @@ Get Started with One-Click Command: -
Or, you can follow the detailed instructions [here](https://keploy.io/docs/server/installation/).
-
## Pre-Requisite đ ď¸
- JDK and add JAVA_HOME in environment variable.
diff --git a/versioned_docs/version-2.0.0/quickstart/java-spring-postgres.md b/versioned_docs/version-2.0.0/quickstart/java-spring-postgres.md
index f95bb05c5..db230a4cd 100644
--- a/versioned_docs/version-2.0.0/quickstart/java-spring-postgres.md
+++ b/versioned_docs/version-2.0.0/quickstart/java-spring-postgres.md
@@ -24,6 +24,7 @@ keyword:
- Test PetClinic
- Junit
---
+
Keploy with PetClinic | Keploy Docs
@@ -35,7 +36,7 @@ import Link from '@docusaurus/Link'
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/quickstart/nextjs-postgres.md b/versioned_docs/version-2.0.0/quickstart/nextjs-postgres.md
index 5f257a912..50460d4b8 100644
--- a/versioned_docs/version-2.0.0/quickstart/nextjs-postgres.md
+++ b/versioned_docs/version-2.0.0/quickstart/nextjs-postgres.md
@@ -24,7 +24,7 @@ This is a sample app to test Keploy integration capabilities using NextJS and Po
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/quickstart/node-express-mongoose.md b/versioned_docs/version-2.0.0/quickstart/node-express-mongoose.md
index e3bdbc87c..80f405b3e 100644
--- a/versioned_docs/version-2.0.0/quickstart/node-express-mongoose.md
+++ b/versioned_docs/version-2.0.0/quickstart/node-express-mongoose.md
@@ -1,6 +1,6 @@
---
id: samples-nodejs
-title: NodeJS + MongoDB
+title: NodeJS + MongoDB
sidebar_label: NodeJS - Express + Mongoose
description: The following sample app showcases how to use NodeJS framework and the Keploy Platform.
tags:
@@ -28,7 +28,7 @@ A simple sample CRUD application and see how seamlessly Keploy integrates with [
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/quickstart/node-jwt-sql.md b/versioned_docs/version-2.0.0/quickstart/node-jwt-sql.md
index 9f631fa3b..9382f0e6d 100644
--- a/versioned_docs/version-2.0.0/quickstart/node-jwt-sql.md
+++ b/versioned_docs/version-2.0.0/quickstart/node-jwt-sql.md
@@ -28,7 +28,7 @@ A simple sample CRUD application to test using Keploy build with Node, JWT and P
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/quickstart/python-django-sql.md b/versioned_docs/version-2.0.0/quickstart/python-django-sql.md
index d449ffd26..6b97c450f 100644
--- a/versioned_docs/version-2.0.0/quickstart/python-django-sql.md
+++ b/versioned_docs/version-2.0.0/quickstart/python-django-sql.md
@@ -31,11 +31,12 @@ keyword:
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
```
+
Or, you can follow the detailed instructions [here](https://keploy.io/docs/server/installation/).
## Get Started! đŹ
diff --git a/versioned_docs/version-2.0.0/quickstart/python-fastapi-sql.md b/versioned_docs/version-2.0.0/quickstart/python-fastapi-sql.md
index 3c57b1852..1640bd75d 100644
--- a/versioned_docs/version-2.0.0/quickstart/python-fastapi-sql.md
+++ b/versioned_docs/version-2.0.0/quickstart/python-fastapi-sql.md
@@ -20,6 +20,7 @@ keyword:
- API Test generator
- Auto case generation
---
+
FastAPI + Postgres | Keploy Docs
@@ -31,7 +32,7 @@ keyword:
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
@@ -62,6 +63,10 @@ We will be using Docker compose to run the application as well as Postgres on Do
### Lights, Camera, Record! đĽ
+Since we have setup our sample-app with docker, we need to update the container name to postgres on line 6, in `application/database.py`, from `postgresql://postgres:postgres@localhost:5432/studentdb` to `postgresql://postgres:postgres@postgres:5432/studentdb`.\*\*
+
+> **Also, we need to update the container name to postgres on line 11, of `application/main.py`, from `postgresql://postgres:postgres@localhost:5432/studentdb` to `postgresql://postgres:postgres@postgres:5432/studentdb`.**
+
Capture the test-cases-
```shell
@@ -238,6 +243,12 @@ We'll be running our sample application right on Linux, but just to make things
### đź Roll the Tape - Recording Time!
+Start the database on Docker:
+
+```bash
+docker compose up -d postgres
+```
+
Ready, set, record! Here's how:
```bash
diff --git a/versioned_docs/version-2.0.0/quickstart/python-fastapi-twilio.md b/versioned_docs/version-2.0.0/quickstart/python-fastapi-twilio.md
index 1a7ff9283..8f1876055 100644
--- a/versioned_docs/version-2.0.0/quickstart/python-fastapi-twilio.md
+++ b/versioned_docs/version-2.0.0/quickstart/python-fastapi-twilio.md
@@ -22,6 +22,7 @@ keyword:
- API Test generator
- Auto case generation
---
+
FastAPI + Twilio | Keploy Docs
@@ -33,7 +34,7 @@ keyword:
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/quickstart/python-flask-mongo.md b/versioned_docs/version-2.0.0/quickstart/python-flask-mongo.md
index 6d27a6801..9096444dd 100644
--- a/versioned_docs/version-2.0.0/quickstart/python-flask-mongo.md
+++ b/versioned_docs/version-2.0.0/quickstart/python-flask-mongo.md
@@ -20,6 +20,7 @@ keyword:
- API Test generator
- Auto case generation
---
+
Flask + Mongo | Keploy Docs
@@ -31,7 +32,7 @@ keyword:
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/quickstart/rust-wrap-mongo.md b/versioned_docs/version-2.0.0/quickstart/rust-wrap-mongo.md
index 4b8911e5e..4e14b7b7e 100644
--- a/versioned_docs/version-2.0.0/quickstart/rust-wrap-mongo.md
+++ b/versioned_docs/version-2.0.0/quickstart/rust-wrap-mongo.md
@@ -12,6 +12,7 @@ keyword:
- API Test generator
- Auto Testcase generation
---
+
Warp + Mongo | Keploy Docs
@@ -23,7 +24,7 @@ This is a sample app to test Keploy integration capabilities using rust and Mong
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/quickstart/sample-rust-crud-mongo.md b/versioned_docs/version-2.0.0/quickstart/sample-rust-crud-mongo.md
index 5f7b2ea98..d561aaf8e 100644
--- a/versioned_docs/version-2.0.0/quickstart/sample-rust-crud-mongo.md
+++ b/versioned_docs/version-2.0.0/quickstart/sample-rust-crud-mongo.md
@@ -27,7 +27,7 @@ This is a sample CRUD REST API application to showcase Keploy integration capabi
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
@@ -35,7 +35,6 @@ Get Started with One-Click Command: -
Or, you can follow the detailed instructions [here](https://keploy.io/docs/server/installation/).
-
## Get Started! đŹ
### Setup app
diff --git a/versioned_docs/version-2.0.0/quickstart/sample-ts.md b/versioned_docs/version-2.0.0/quickstart/sample-ts.md
index 1fa626672..c782297fd 100644
--- a/versioned_docs/version-2.0.0/quickstart/sample-ts.md
+++ b/versioned_docs/version-2.0.0/quickstart/sample-ts.md
@@ -24,7 +24,7 @@ This is a sample app to test Keploy integration capabilities using Typescript an
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
@@ -32,7 +32,6 @@ Get Started with One-Click Command: -
Or, you can follow the detailed instructions [here](https://keploy.io/docs/server/installation/).
-
## Get Started! đŹ
### Setup app
diff --git a/versioned_docs/version-2.0.0/quickstart/samples-bunjs.md b/versioned_docs/version-2.0.0/quickstart/samples-bunjs.md
index 03a30c6ed..75af21734 100644
--- a/versioned_docs/version-2.0.0/quickstart/samples-bunjs.md
+++ b/versioned_docs/version-2.0.0/quickstart/samples-bunjs.md
@@ -32,7 +32,7 @@ This is a sample app to test Keploy integration capabilities using [Bun.js](http
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/quickstart/samples-echo.md b/versioned_docs/version-2.0.0/quickstart/samples-echo.md
index 0a0811aa1..e1d0a34ec 100644
--- a/versioned_docs/version-2.0.0/quickstart/samples-echo.md
+++ b/versioned_docs/version-2.0.0/quickstart/samples-echo.md
@@ -30,7 +30,7 @@ A sample url shortener app to test Keploy integration capabilities using [Echo](
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/quickstart/samples-express-mongoose.md b/versioned_docs/version-2.0.0/quickstart/samples-express-mongoose.md
index c7c6fea47..a86e15954 100644
--- a/versioned_docs/version-2.0.0/quickstart/samples-express-mongoose.md
+++ b/versioned_docs/version-2.0.0/quickstart/samples-express-mongoose.md
@@ -28,7 +28,7 @@ A simple sample CRUD application and see how seamlessly Keploy integrates with [
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/quickstart/samples-go-gin-mongo.md b/versioned_docs/version-2.0.0/quickstart/samples-go-gin-mongo.md
index 130d93977..b1bfb298d 100644
--- a/versioned_docs/version-2.0.0/quickstart/samples-go-gin-mongo.md
+++ b/versioned_docs/version-2.0.0/quickstart/samples-go-gin-mongo.md
@@ -30,7 +30,7 @@ keyword:
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/quickstart/samples-go-sse-svelte.md b/versioned_docs/version-2.0.0/quickstart/samples-go-sse-svelte.md
index 4dd2e5d3d..020ac77ae 100644
--- a/versioned_docs/version-2.0.0/quickstart/samples-go-sse-svelte.md
+++ b/versioned_docs/version-2.0.0/quickstart/samples-go-sse-svelte.md
@@ -30,7 +30,7 @@ keyword:
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/quickstart/samples-java.md b/versioned_docs/version-2.0.0/quickstart/samples-java.md
index 1841d16a7..4889fc577 100644
--- a/versioned_docs/version-2.0.0/quickstart/samples-java.md
+++ b/versioned_docs/version-2.0.0/quickstart/samples-java.md
@@ -38,7 +38,7 @@ and **PostgreSQL**.
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
@@ -46,7 +46,6 @@ Get Started with One-Click Command: -
Or, you can follow the detailed instructions [here](https://keploy.io/docs/server/installation/).
-
## Setup Employee-Manager App
### Application Pre-Requisites đ
diff --git a/versioned_docs/version-2.0.0/quickstart/samples-node-mongo.md b/versioned_docs/version-2.0.0/quickstart/samples-node-mongo.md
index 4f9e80955..8b9c2633e 100644
--- a/versioned_docs/version-2.0.0/quickstart/samples-node-mongo.md
+++ b/versioned_docs/version-2.0.0/quickstart/samples-node-mongo.md
@@ -20,6 +20,7 @@ keyword:
- API Test generator
- Auto Testcase generation
---
+
NodeJS - Express + Mongoose | Keploy Docs
@@ -31,7 +32,7 @@ A sample **_CRUD_** application to see how Keploy integrates effortlessly with *
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/quickstart/samples-rust.md b/versioned_docs/version-2.0.0/quickstart/samples-rust.md
index 64a28c3e6..0d0b8d783 100644
--- a/versioned_docs/version-2.0.0/quickstart/samples-rust.md
+++ b/versioned_docs/version-2.0.0/quickstart/samples-rust.md
@@ -14,6 +14,7 @@ keyword:
- API Test generator
- Auto Testcase generation
---
+
Rust + Mongo (GraphQL) | Keploy Docs
@@ -25,7 +26,7 @@ This is a sample app to test Keploy integration capabilities using rust and Mong
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
@@ -33,7 +34,6 @@ Get Started with One-Click Command: -
Or, you can follow the detailed instructions [here](https://keploy.io/docs/server/installation/). đ Wohoo! We are all set to use Keploy.
-
## Get Started! đŹ
## Setup app
diff --git a/versioned_docs/version-2.0.0/quickstart/sanic-mongo.md b/versioned_docs/version-2.0.0/quickstart/sanic-mongo.md
index d1ef31921..7ef32f296 100644
--- a/versioned_docs/version-2.0.0/quickstart/sanic-mongo.md
+++ b/versioned_docs/version-2.0.0/quickstart/sanic-mongo.md
@@ -34,7 +34,7 @@ This application is a simple movie management API built using Python's [Sanic fr
## Install Keploy CLI đ
-Get Started with One-Click Command: -
+Get Started with One-Click Command: -
```bash
curl -O -L https://keploy.io/install.sh && source install.sh
diff --git a/versioned_docs/version-2.0.0/running-keploy/cli-commands.md b/versioned_docs/version-2.0.0/running-keploy/cli-commands.md
index d13971160..094fe357e 100755
--- a/versioned_docs/version-2.0.0/running-keploy/cli-commands.md
+++ b/versioned_docs/version-2.0.0/running-keploy/cli-commands.md
@@ -13,6 +13,7 @@ keywords:
- keploy running guide
- keploy oss
---
+
CLI Commands | Keploy Docs
@@ -30,14 +31,14 @@ You can use `--help, -h` flag for all the commands to see available flag options
Here are some examples of how to use some common flags:
-| Mode | Flags Available|
-| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `record` | `-a, --app-id`,`--app-name`,`-b, --build-delay`,`--cmd-type`,`-c, --command`,`--config-path`, `--containerName`, `--dns-port`,`--in-ci`,`-n, --networkName`, `--passThroughPorts`, `-p, --path`, `--proxyport`, `--record-timer`,`--debug`|
+| Mode | Flags Available |
+| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `record` | `-a, --app-id`,`--app-name`,`-b, --build-delay`,`--cmd-type`,`-c, --command`,`--config-path`, `--containerName`, `--dns-port`,`--in-ci`,`-n, --networkName`, `--passThroughPorts`, `-p, --path`, `--proxyport`, `--record-timer`,`--debug` |
| `test` | `--apiTimeout`,`-a, --app-id`,`--app-name`,`-b, --build-delay`,`--cmd-type`,`-c, --command`, `--config-path`, `--containerName`, `-d, --delay`, `--disable-line-coverage`, `--disableMockUpload `,`--dns-port`, `--fallBack-on-miss`,`--host`, `--mocking`, `--mongoPassword`, `-n, --net, --networkName`, `--passThroughPorts`, `-p, --path`, `--proxyport`, `-t, --testsets`, `--debug`, `-g, --generateTestReport`, `--removeUnusedMocks`, `--ignoreOrdering`, `--skip-preview`, `--update-temp`, `--useLocalMock` |
-| `gen` | `--sourceFilePath`, `--testFilePath`,`--coverageReportPath`,`--testCommand`,`--coverageFormat`,`--expectedCoverage`,`--maxIterations`,`--testDir`,`--llmBaseUrl`,`--model`,`--llmApiVersion`|
-| `normailze` | `-p, --path`, `--test-run`, `--tests`|
-| `rerecord` | `--test-sets`, `-t`|
-| `config` | `--generate`,`-p, --path`|
+| `gen` | `--sourceFilePath`, `--testFilePath`,`--coverageReportPath`,`--testCommand`,`--coverageFormat`,`--expectedCoverage`,`--maxIterations`,`--testDir`,`--llmBaseUrl`,`--model`,`--llmApiVersion` |
+| `normailze` | `-p, --path`, `--test-run`, `--tests` |
+| `rerecord` | `--test-sets`, `-t` |
+| `config` | `--generate`,`-p, --path` |
### [Record](#Record)
@@ -72,9 +73,11 @@ keploy record [flags]
```bash
keploy record -c "node src/app.js" --config-path "./config-dir/"
```
+
In the above command, `config-dir` is the directory in the CWD where the Keploy configuration file `keploy.yml` is stored.
- `--container-name string` - Name of the docker container in which the user application is running.
+
```bash
keploy record -c "docker compose up" --container-name "my-app-container"
```
@@ -98,6 +101,7 @@ keploy record [flags]
```bash
keploy record -c "node src/app.js" -p "./tests"
```
+
Where `tests` is the directory with the recorded testcases and generated mocks are to be stored.
- `--proxy-port uint32` - Port to choose to run Keploy as a proxy. The default is 16789.
@@ -235,6 +239,7 @@ keploy test [flags]
```bash
keploy test -c "node src/app.js" --delay 10 --remove-unused-mocks
```
+
- `--update-temp` - Update the template with the result of the testcases.
- `--useLocalMock` - Use local mocks instead of fetching from the cloud
diff --git a/versioned_docs/version-2.0.0/running-keploy/docker-tls.md b/versioned_docs/version-2.0.0/running-keploy/docker-tls.md
index b27ed07ba..b92fb6e56 100644
--- a/versioned_docs/version-2.0.0/running-keploy/docker-tls.md
+++ b/versioned_docs/version-2.0.0/running-keploy/docker-tls.md
@@ -19,15 +19,17 @@ keywords:
## Prerequisites
+
Before proceeding, ensure the following prerequisites are met:
### Docker Compose Setup:
+
- Add the `` under your application service in your docker-compose.yml file. Example.
- Ensure all containers are on the same network.
### Docker Run Setup:
-- When using the docker run command, include the --network flag to specify a custom network name.
+- When using the docker run command, include the --network flag to specify a custom network name.
## Recording Testcases and Data Mocks
diff --git a/versioned_docs/version-2.0.0/running-keploy/rename-testcases.md b/versioned_docs/version-2.0.0/running-keploy/rename-testcases.md
index 9a256e682..4a3693b00 100644
--- a/versioned_docs/version-2.0.0/running-keploy/rename-testcases.md
+++ b/versioned_docs/version-2.0.0/running-keploy/rename-testcases.md
@@ -12,6 +12,7 @@ keywords:
- rename
- testsets
---
+
How to Rename Test-names? | Keploy Docs
diff --git a/versioned_docs/version-2.0.0/running-keploy/unit-test-generator.md b/versioned_docs/version-2.0.0/running-keploy/unit-test-generator.md
index ee08876d4..cf7efa347 100644
--- a/versioned_docs/version-2.0.0/running-keploy/unit-test-generator.md
+++ b/versioned_docs/version-2.0.0/running-keploy/unit-test-generator.md
@@ -1,13 +1,14 @@
---
id: unit-test-generator
-title: Unit Testing with Keploy
-sidebar_label: Unit Test Generator
+title: Keploy Unit Testing Agent
+sidebar_label: Unit Testing
description: This section documents usecase of Keploy's Unit Test Generator
tags:
- utg
- unit test generator
- generate unit test
- unit test
+ - unit testing
keywords:
- unit test generator
- unit testing
@@ -17,10 +18,13 @@ keywords:
- AI testing
- Gemini
- OpenAI
+ - testing agent
+ - unit testing agent
+ - opensource testing agent
---
- Unit Test Generator | Keploy Docs
+ Unit Testing Agent | Keploy Docs
@@ -158,9 +162,10 @@ _Voila!! The Generated Testcases have provided with 71% coverage in just 2 itera
## Generate Unit Tests with VS Code Extension
-The [Keploy VS Code extension](https://marketplace.visualstudio.com/items?itemName=Keploy.keployio) simplifies unit test generation by allowing users to create tests directly within their editor, eliminating the need for CLI commands or API key setup. With just a right-click on any source file, the extension auto-detects the necessary parameters and generates unit tests seamlessly. It integrates effortlessly into your workflow, saving generated test cases to the appropriate files and providing coverage reports within VS Code itself.
+The [Keploy VS Code extension](https://marketplace.visualstudio.com/items?itemName=Keploy.keployio) simplifies unit test generation by allowing users to create tests directly within their editor, eliminating the need for CLI commands or API key setup. With just a right-click on any source file, the extension auto-detects the necessary parameters and generates unit tests seamlessly. It integrates effortlessly into your workflow, saving generated test cases to the appropriate files and providing coverage reports within VS Code itself.
+
+For example, in the [express-mongoose](https://github.com/keploy/samples-typescript/tree/main/express-mongoose) sample app:
-For example, in the [express-mongoose](https://github.com/keploy/samples-typescript/tree/main/express-mongoose) sample app:
1. You can open `routes.js`, right-click, and select **Generate Unit Tests with Keploy** to instantly generate tests for `test/routes.test.js`.
2. The extension makes unit testing faster, easier, and more accessible for developers.
diff --git a/versioned_docs/version-2.0.0/server/installation.md b/versioned_docs/version-2.0.0/server/installation.md
index 7d737280c..3356957d2 100644
--- a/versioned_docs/version-2.0.0/server/installation.md
+++ b/versioned_docs/version-2.0.0/server/installation.md
@@ -55,4 +55,31 @@ To run the testcases and see if there are any regressions introduced, use this t
keploy test -c "CMD_TO_RUN_APP" --delay 10
```
+## Install Keploy via Arkade
+
+1. Installing Arkade
+
+```bash
+# Note: you can also run without `sudo` and move the binary yourself
+curl -sLS https://get.arkade.dev | sudo sh
+
+arkade --help
+ark --help # a handy alias
+
+# Windows users with Git Bash
+curl -sLS https://get.arkade.dev | sh
+```
+
+2. Install Keploy
+
+```bash
+arkade get keploy
+```
+
+Or you can also download specific version of Keploy using the following command:
+
+```bash
+arkade get keploy@2.3.0-beta47
+```
+
Explore the [Test Coverage Generation Guide](https://keploy.io/docs/server/sdk-installation/go/) for seeing test-coverage with your unit testing library and [Keploy Running Guide](https://keploy.io/docs/running-keploy/configuration-file/) for additional options and tips on customizing your Keploy setup to perfection.
diff --git a/versioned_sidebars/version-2.0.0-sidebars.json b/versioned_sidebars/version-2.0.0-sidebars.json
index 01e001530..a65023772 100644
--- a/versioned_sidebars/version-2.0.0-sidebars.json
+++ b/versioned_sidebars/version-2.0.0-sidebars.json
@@ -2,7 +2,7 @@
"sidebarExplanation": [
{
"type": "category",
- "label": "Explanation",
+ "label": "Learn about Keploy",
"collapsible": true,
"collapsed": true,
"items": [
@@ -17,13 +17,9 @@
"id": "server/installation"
},
{
- "type": "category",
+ "type": "doc",
"label": "Unit Testing",
- "collapsible": true,
- "collapsed": false,
- "items": [
- "running-keploy/unit-test-generator"
- ]
+ "id": "running-keploy/unit-test-generator"
},
{
"type": "category",
@@ -123,7 +119,18 @@
"items": ["quickstart/samples-csharp"]
}
]
- },
+ },
+ {
+ "type": "category",
+ "label": "CI/CD",
+ "collapsible": true,
+ "collapsed": false,
+ "items": [
+ "ci-cd/github",
+ "ci-cd/gitlab",
+ "ci-cd/jenkins"
+ ]
+ },
{
"type": "category",
"label": "Dependencies",
@@ -140,25 +147,23 @@
},
{
"type": "category",
- "label": "CI/CD Integrations",
+ "label": "Code Coverage",
"collapsible": true,
- "collapsed": false,
+ "collapsed": true,
"items": [
- "ci-cd/github",
- "ci-cd/gitlab",
- "ci-cd/jenkins"
+ "server/sdk-installation/go",
+ "server/sdk-installation/java",
+ "server/sdk-installation/javascript",
+ "server/sdk-installation/python"
]
},
{
"type": "category",
- "label": "Code Coverage",
+ "label": "Troubleshooting",
"collapsible": true,
"collapsed": true,
"items": [
- "server/sdk-installation/go",
- "server/sdk-installation/java",
- "server/sdk-installation/javascript",
- "server/sdk-installation/python"
+ "keploy-explained/faq"
]
}
],
@@ -183,10 +188,10 @@
"collapsible": true,
"items": [
"keploy-cloud/cloud-installation",
+ "keploy-cloud/auto-test-generation",
"keploy-cloud/time-freezing",
"keploy-cloud/mock-registry",
"keploy-cloud/keploy-console",
- "keploy-cloud/auto-test-generation",
"keploy-cloud/deduplication"
]
}
From e56a3e15cc5a9652e279e19f73fcc2616d7090c2 Mon Sep 17 00:00:00 2001
From: Animesh Pathak
Date: Fri, 3 Jan 2025 12:49:55 +0530
Subject: [PATCH 6/6] feat: final revamp
Signed-off-by: Animesh Pathak
---
src/css/custom.css | 2 +-
.../glossary/behaviour-driven-development.md | 19 +-
.../reference/glossary/idempotency.md | 46 +++-
.../glossary/test-driven-development.md | 115 +++++++---
.../glossary/unit-test-automation.md | 37 +++-
.../reference/glossary/unit-testing.md | 24 +++
.../keploy-explained/common-errors.md | 202 ++++++++++++++++++
.../keploy-explained/mac-linux.md | 2 +-
.../version-2.0.0-sidebars.json | 5 +-
9 files changed, 400 insertions(+), 52 deletions(-)
create mode 100644 versioned_docs/version-2.0.0/keploy-explained/common-errors.md
diff --git a/src/css/custom.css b/src/css/custom.css
index 02b1ed500..074c00172 100644
--- a/src/css/custom.css
+++ b/src/css/custom.css
@@ -6,7 +6,7 @@
/* Hotfix: Changed primary color to black to resolve conflict with Docusaurus' default primary orange after disabling Tailwind preflight CSS. Added font size and line height adjustments to compensate for the removal of Tailwind preflight. */
/* --ifm-color-primary-lighter: #ffb575; */
- font-size:18px;
+ font-size:14px;
line-height: 1.6;
--ifm-color-primary: #000;
--ifm-color-primary-lighter: #FFF;
diff --git a/versioned_docs/version-2.0.0/concepts/reference/glossary/behaviour-driven-development.md b/versioned_docs/version-2.0.0/concepts/reference/glossary/behaviour-driven-development.md
index 8d50de2b4..4b6d57ab7 100644
--- a/versioned_docs/version-2.0.0/concepts/reference/glossary/behaviour-driven-development.md
+++ b/versioned_docs/version-2.0.0/concepts/reference/glossary/behaviour-driven-development.md
@@ -1,8 +1,10 @@
---
id: behaviour-driven-development
-title: What is Behavior Driven Development (BDD)?
+title: "Behavior Driven Development : Beginner's Guide to Collaboration"
sidebar_label: Behaviour Driven Development
-description: Collaborative approach aligning software development with business goals through clear, readable test scenarios.
+description: Learn how BDD bridges the gap between developers, testers, and business stakeholders with practical examples, tools, and techniques.
+seoTitle: "Behavior Driven Development : Beginner's Guide to Collaboration"
+seoDescription: Learn how BDD bridges the gap between developers, testers, and business stakeholders with practical examples, tools, and techniques.
tags:
- explanation
- Glossary
@@ -10,6 +12,13 @@ keywords:
- API
- BDD
- Behavior Driven Development
+ - Behavior Driven Development Tools
+ - BDD Testing Tools
+ - Behavior Driven Testing
+ - Test Automation
+ - Software Testing
+ - Software Testing Best Practices
+ - Test Automation
---
Behavior-driven development (BDD) is an Agile software development methodology that encourages collaboration between developers, testers, and business stakeholders. BDD is based on the idea that the best way to ensure that software meets the needs of its users is to write tests that describe the desired behavior of the software in plain language.
@@ -136,17 +145,17 @@ One of the core practices in BDD is the creation of automated tests based on the
Here are some of the popular BDD automation tools:
-1. **Cucumber:** [Cucumber](https://github.com/cucumber/cucumber-js) is a free and open-source BDD tool that uses the Gherkin syntax for writing test cases in plain English. It can be programmed in several languages, including Java, Ruby, and JavaScript.
+1. **Cucumber:** Cucumber is a free and open-source BDD tool that uses the Gherkin syntax for writing test cases in plain English. It can be programmed in several languages, including Java, Ruby, and JavaScript. Learn how to implement BDD with tools like Cucumber - [read now](https://keploy.io/blog/community/bdd-testing-with-cucumber)!
2. **Behave:** Behave is a behavior-driven testing tool written in Python that supports the Gherkin syntax and can be used in tandem with other testing frameworks like Pytest and Unittest.
3. **JBehave:** JBehave is a Gherkin-based, Java-based BDD tool that supports many testing frameworks, including JUnit and TestNG.
-4. **SpecFlow:** [SpecFlow](https://github.com/SpecFlowOSS/SpecFlow) is a BDD tool that interfaces with Microsoft Studio and other .NET tools and employs the Gherkin syntax for writing specifications. It can be programmed in C# and Visual Basic, among other languages.
+4. **SpecFlow:** SpecFlowis a BDD tool that interfaces with Microsoft Studio and other .NET tools and employs the Gherkin syntax for writing specifications. It can be programmed in C# and Visual Basic, among other languages.
5. **Gauge:** Gauge is an open-source BDD tool that employs a markdown-based syntax to describe tests. It can be programmed in Java, Ruby, and Python, among others.
-6. **Reqnroll:** [Reqnroll](https://github.com/reqnroll/Reqnroll) is an open-source Cucumber-style BDD test automation framework for .NET.
+6. **Reqnroll:** Reqnroll is an open-source Cucumber-style BDD test automation framework for .NET.
These tools can help to streamline the testing process and improve communication between developers, testers, and stakeholders. This can help to ensure that the software meets the needs of the business and is of high quality.
diff --git a/versioned_docs/version-2.0.0/concepts/reference/glossary/idempotency.md b/versioned_docs/version-2.0.0/concepts/reference/glossary/idempotency.md
index c75f8be45..a2ad1a4ea 100644
--- a/versioned_docs/version-2.0.0/concepts/reference/glossary/idempotency.md
+++ b/versioned_docs/version-2.0.0/concepts/reference/glossary/idempotency.md
@@ -2,7 +2,7 @@
id: idempotency
title: How Idempotent REST APIs Boost Reliability and Error Handling
sidebar_label: Idempotency
-description: Discover how idempotent APIs enhance user experience, reliability, and error handling. Learn best practices for implementing and testing idempotent methods.
+description: Learn how idempotent REST APIs ensure reliability, error recovery, and fault tolerance in distributed systems. Discover best practices and testing strategies for idempotent methods
tags:
- explanation
- glossary
@@ -30,9 +30,9 @@ Idempotency is often associated with specific HTTP methods in RESTful APIs:
![Methods](https://www.hubspot.com/hs-fs/hubfs/Google%20Drive%20Integration/Idempotent%20Api%20Draft-1.png?width=650&name=Idempotent%20Api%20Draft-1.png)
-## How Idempotency Ensures Reliability ?
+## Key Benefits of Idempotent APIs
-In distributed systems, where network failures and message duplication can occur, idempotent operations ensure reliability by:
+In distributed systems, where multiple components often interact asynchronously, achieving consistency can be challenging. Network failures, latency, and message duplication can lead to unintended consequences if not handled carefully. This is where idempotency plays a pivotal role. Idempotent operations ensure reliability by:
- **Preventing Duplicate Effects:** Even if a request is duplicated due to network issues or client retries, idempotent operations ensure that the system's state remains unchanged after the initial request.
- **Simplifying Error Recovery:** Idempotent APIs simplify error recovery mechanisms by allowing clients to retry requests without causing additional modifications or inconsistencies in the system.
@@ -46,9 +46,9 @@ Implementing idempotent APIs involves adopting best practices such as:
- **Request Idempotency Tokens:** Use request headers or tokens (e.g., UUIDs) to uniquely identify and handle idempotent requests to prevent duplication or unintended re-execution.
- **Idempotent Database Operations:** Implement database transactions and queries in a way that ensures data modifications are idempotent, even under concurrent or distributed execution scenarios.
-### Challenges in Idempotent API Implementation
+## Common Challenges in Implementing Idempotent APIs
-Implementing and testing idempotent APIs can pose challenges such as:
+Although idempotency is a desirable property in many RESTful APIs, implementing it in real-world systems can be challenging like :
- **Ensuring Correctness Across Systems:** Guaranteeing idempotency in distributed systems with multiple interacting components requires careful design and coordination.
- **Handling Edge Cases:** Identifying and addressing edge cases where idempotency might be violated due to specific system behaviors or failure scenarios.
@@ -58,7 +58,7 @@ Implementing and testing idempotent APIs can pose challenges such as:
Idempotency becomes particularly critical in distributed systems where network failures, message duplication, and out-of-order message delivery can occur. In such environments, ensuring that operations are idempotent helps prevent unintended side effects and ensures that the system can recover gracefully from failures without compromising data integrity.
-### Idempotency important in RESTful APIs
+### What is Idempotency in REST APIs?
Idempotent APIs offer several benefits that contribute to the reliability, scalability, and consistency of systems. Here are some key advantages:
@@ -95,13 +95,39 @@ Idempotent operations yield the same result regardless of repetitions. Safe meth
![Idempotent vs Safe](https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSNpJRr8DjkwYCknq1yp0PNVbGQ9Gy0rcBwtg&s)
+## Leveraging Keploy for Idempotency in API Testing
+
+[Keploy](https://keploy.io), a powerful testing tool, plays a crucial role in handling **idempotency** during the development and testing phases of API design. By offering an **automated testing framework** that can simulate various API scenarios, including retries and error recovery, Keploy ensures that your idempotent APIs are functioning as expected across all edge cases.
+
+### How Keploy Helps Ensure Idempotency?
+
+- **Automated Test Cases for Idempotent Operations:**
+ Keploy enables developers to create automated test cases that simulate repeated API requests under various conditions, such as network failures, timeouts, or duplicate submissions. This ensures that idempotent operations like **PUT**, **DELETE**, and **GET** methods behave correctly, even when called multiple times. Keployâs test cases can automatically validate that these methods do not introduce unexpected side effects or inconsistencies, regardless of how many times the request is repeated.
+
+- **Simulating Failures and Retrying Requests:**
+ With Keployâs capabilities, teams can simulate failure scenarios, including transient network issues or service unavailability, to ensure that retry logic in idempotent APIs works as intended. This is especially important in distributed systems where failure recovery is crucial. Keploy verifies that retries do not modify the systemâs state and that the response to a repeated request is consistent with the first execution, maintaining data integrity.
+
+- **Request and Response Pairing:**
+ Keploy also tracks requests and their corresponding responses, allowing you to easily identify whether repeated requests with the same data produce identical results. This pairing feature helps test whether the API is handling **idempotent tokens** (e.g., UUIDs) correctly and consistently across different test runs, ensuring that requests are not duplicated or re-executed unnecessarily.
+
+- **Advanced Mocking and Stubbing:**
+ In scenarios where you need to test idempotent behaviors in isolation or in specific conditions, Keploy allows you to mock external services and interactions. By simulating service responses, you can ensure that your idempotent APIs are handling edge cases effectively and returning the same results even in the event of temporary failures or delays.
+
+### Example Use Case
+
+Letâs say you are building an API that allows users to update their profile information using the **PUT** method. To ensure the operation is idempotent, you would create automated tests with Keploy to verify that:
+
+1. **Multiple PUT requests with identical data** will result in the same updated resource without introducing new records or changes.
+2. **Simulated network failures** will not lead to multiple updates or changes to the userâs profile when the request is retried.
+3. **Caching behaviors** are respected, ensuring that multiple requests for the same resource return the same data without additional overhead.
+
## Conclusion
Idempotency is a fundamental principle in designing reliable and scalable RESTful APIs. By ensuring that operations can be safely retried without adverse effects, idempotent APIs contribute to system reliability, consistency, and performance. Implementing idempotent APIs involves careful consideration of HTTP methods, data handling, and error recovery mechanisms to maintain data integrity and simplify client interactions.
-Certainly! Here are 6 FAQs about idempotent REST APIs:
+Tools such as Keploy simplifies handling of idempotency during testing by providing a robust platform to simulate real-world API usage and edge cases, ensuring your APIs maintain their idempotency even under adverse conditions.
-## Frequently Asked Questions
+## FAQ
### What does it mean for an HTTP method to be idempotent?
@@ -119,7 +145,7 @@ Examples of idempotent HTTP methods include:
- **PUT:** Updating a resource with PUT results in the same state regardless of how many times it's applied.
- **DELETE:** Deleting a resource using DELETE remains unchanged if the resource is already deleted or does not exist.
-### How does idempotency contribute to error handling and fault tolerance?
+### How does idempotency improve error handling in distributed systems?
Idempotent APIs simplify error handling and fault tolerance by allowing clients to retry requests safely. If a request fails due to network issues or timeouts, clients can resend the request without worrying about introducing inconsistencies or unintended modifications in the server's state.
@@ -131,6 +157,6 @@ To ensure idempotency in API implementations, developers should:
- Implement operations in a way that does not change the server's state if the request is repeated.
- Use request headers or tokens to uniquely identify and handle idempotent requests to prevent duplicate execution.
-### How can developers test for idempotency in REST APIs?
+### How to test idempotent APIs?
Testing for idempotency involves creating test cases that simulate scenarios where requests may be duplicated or retried due to network failures or client retries. Developers should verify that repeating the same request does not result in different outcomes or unintended side effects in the system's state.
diff --git a/versioned_docs/version-2.0.0/concepts/reference/glossary/test-driven-development.md b/versioned_docs/version-2.0.0/concepts/reference/glossary/test-driven-development.md
index 43e3f05af..313b93ae5 100644
--- a/versioned_docs/version-2.0.0/concepts/reference/glossary/test-driven-development.md
+++ b/versioned_docs/version-2.0.0/concepts/reference/glossary/test-driven-development.md
@@ -1,18 +1,28 @@
---
id: test-driven-development
-title: What is Test Driven Development (TDD)?
+title: What is Test Driven Development (TDD)? Benefits, Process, and Tools
sidebar_label: Test Driven Development
-description: Collaborative approach aligning software development with business goals through clear, readable test scenarios.
+description: Learn about Test Driven Development (TDD), its benefits, best practices, and how it ensures high-quality code through structured testing before implementation. Explore the TDD workflow and integration with tools like Keploy.
tags:
- explanation
- Glossary
keywords:
- API
+ - test Driven Development (TDD)
+ - TDD Best Practices
+ - TDD Workflow
+ - Keploy and Test Driven Development
+ - Continuous Integration with TDD
+ - How to Implement TDD
+ - TDD Testing Tools
+ - Challenges of Test Driven Development
---
-Test Driven Development (TDD) is a software development approach that aligns software development with business goals through clear, readable test scenarios. Test Driven Development is a collaborative approach that involves developers, testers, and business analysts working together to define the requirements and test scenarios before writing the code.
+Test Driven Development (TDD) is a dynamic and collaborative approach to software development that brings together developers, testers, and business analysts to ensure code aligns perfectly with business objectives. Instead of diving straight into writing code, TDD starts with a clear plan â in the form of well-defined, readable test scenarios. These tests act as a blueprint, guiding the development process and ensuring that the code will meet the desired requirements right from the start.
-## When to work with TDD ?
+The best part? By writing tests before code, TDD helps catch issues early, fosters cleaner and more modular code, and ensures that each feature is thoroughly tested as itâs built. This not only leads to higher-quality software but also keeps the development process aligned with business goals, making it a win-win for everyone involved.
+
+## How TDD Works ?
Test Driven Development or TDD is particularly useful in the following scenarios:
@@ -29,9 +39,13 @@ Test Driven Development or TDD is particularly useful in the following scenarios
### Fundamentals of TDD
1. **Write a Failing Test**:
+
- Start by writing a test that defines a new function or improvement. This test should fail initially as the feature is not yet implemented.
+
2. **Implement the Minimum Code**:
+
- Write the minimum amount of code required to make the test pass. Focus on functionality rather than optimization.
+
3. **Refactor the Code**:
- Once the test passes, refactor the code to improve its structure and maintainability. Ensure the test still passes after refactoring.
@@ -56,11 +70,60 @@ Test Driven Development or TDD is particularly useful in the following scenarios
6. **Behavioral Testing**:
- Although primarily focused on unit testing, incorporate behavioral tests to ensure that the system behaves as expected from the user's perspective. Use tools like JUnit for Java or pytest for Python.
-## How Keploy works with Test Driven Development ?
+## **Why TDD is Important?**
+
+Test Driven Development (TDD) is important because it lays a solid foundation for reliable, maintainable, and bug-free software. By writing tests before writing the code, TDD helps ensure that each piece of functionality is clearly defined, easy to validate, and meets the specified requirements. Here are a few reasons why TDD is crucial:
+
+- **Early Detection of Bugs**: Writing tests before implementing the code means that any errors or issues in the logic are caught right at the beginning of the development process, reducing the chances of defects slipping through unnoticed.
+- **Improved Code Quality**: TDD encourages developers to write modular and testable code. As tests are written first, developers are more likely to design smaller, more focused code units, making the software more maintainable in the long term.
+
+- **Clearer Requirements**: Writing tests based on business requirements ensures that the software will meet expectations. TDD pushes teams to think about the functionality and edge cases up front, promoting clearer and better communication among developers, testers, and business stakeholders.
+
+- **Refactoring Safety**: One of the key benefits of TDD is that it provides a safety net for refactoring. When you have tests in place, you can confidently make changes to the codebase knowing that the tests will verify whether your changes break any functionality.
+
+- **Faster Debugging**: Since tests are written incrementally, you can easily pinpoint the origin of a bug by identifying which test failed. This allows you to debug the application more efficiently.
+
+- **Continuous Feedback**: By running tests continuously throughout the development process, developers get rapid feedback on the quality and correctness of their code, allowing for quick adjustments when necessary.
+
+## **Why Choose TDD over BDD?**
+
+Test Driven Development offers a systematic approach that benefits both developers and the larger development process. Hereâs why you should choose TDD:
+
+- **Reduces Debugging Time**: By catching issues early in the development process through unit tests, developers spend less time debugging in the later stages. The continuous feedback loop from TDD helps catch defects before they propagate and complicate the development process.
+
+- **Promotes Better Design**: TDD encourages developers to write clean, modular, and decoupled code. The need to write tests first forces developers to think about the code structure and design, which leads to a more maintainable and scalable architecture.
-Keploy can be integrated into your Test Driven Development workflow to automate testing processes and streamline development.
+- **Supports Continuous Integration**: TDD naturally fits into continuous integration (CI) workflows. Since tests are written upfront, they can be easily integrated into a CI/CD pipeline, ensuring that the code is continuously validated as new changes are made.
+
+- **Increased Confidence in Code**: With TDD, youâre constantly testing the code as you write it, which gives you confidence in the functionality and quality of your work. You also get the reassurance that your code behaves as expected, which is especially important in high-stakes environments like production.
+
+- **Facilitates Collaboration**: TDD bridges the gap between developers and testers, as everyone works off the same set of predefined tests. It also involves business analysts or product owners in the test design process, ensuring that the code delivered is aligned with business objectives.
+
+- **Helps with Legacy Code**: When dealing with legacy systems or refactoring old code, TDD can help ensure that existing functionality is not broken. The tests act as a safeguard, providing assurance that your changes do not inadvertently introduce bugs into existing features.
+
+- **Focus on What to Build, Not How**: By focusing on the behavior of the system through tests, TDD helps clarify the user story or requirement before developers begin writing code. This clarity leads to more focused and purpose-driven development.
+
+## **Common Challenges with TDD**
+
+While Test Driven Development offers many advantages, it does come with its own set of challenges. Here are some common hurdles teams face when implementing TDD and how to overcome them:
+
+- **Initial Learning Curve**: Adopting TDD can be challenging for developers who are not familiar with the approach. It requires a shift in mindset, where writing tests before writing code becomes the norm. To overcome this, teams can start with smaller, simpler projects and gradually increase their adoption of TDD practices over time. Pair programming is also a useful way to mentor developers through the process.
+
+- **Time-Consuming Initially**: TDD requires writing tests before coding, which might seem like it slows down development at first. However, in the long run, the reduced need for debugging and the prevention of defects often leads to faster development. To mitigate this challenge, ensure that the team understands the long-term benefits of TDD and integrates it gradually into their workflow.
+
+- **Difficulty Writing Tests for Complex Logic**: For systems with highly complex logic or deep dependencies, writing meaningful unit tests can be a challenge. It may be difficult to determine how to isolate certain pieces of functionality for testing. Using **mocking** and **stubbing** techniques can help simulate external dependencies and make testing easier.
+
+- **Test Maintenance Overhead**: As the codebase evolves, tests may require updates to accommodate changes in the code. If not maintained carefully, tests can become stale and difficult to manage. To counter this, focus on writing clean, simple tests that are easy to update as the code changes. Automated refactoring tools and regular code reviews can help manage this challenge.
+
+- **Not Suitable for All Types of Testing**: TDD is highly effective for unit tests but may not always be the best approach for more complex system tests or UI-level testing. Some projects, such as those with rapidly changing UIs or where the external system dependencies are difficult to mock, may benefit from a more flexible testing strategy, such as [**Behavior Driven Development (BDD)**](https://keploy.io/docs/concepts/reference/glossary/behaviour-driven-development/) or [**Exploratory Testing**](https://keploy.io/blog/community/how-exploratory-testing-can-improve-software-quality).
+
+- **Overemphasis on Test Coverage**: While TDD encourages writing tests, itâs important not to focus solely on achieving 100% test coverage. Sometimes, writing tests for trivial code or edge cases that arenât critical to the application can introduce unnecessary complexity. It's better to prioritize writing meaningful, high-quality tests that ensure the most critical functionality works as expected.
+
+- **Pressure to Stick to Small Increments**: TDD encourages writing small, incremental code changes, but this can sometimes feel slow, especially for developers used to working in larger chunks. It's important to strike a balance between small iterations and the need to implement features in a reasonable timeframe. Communication with stakeholders about the benefits of TDD and its impact on overall software quality can help set realistic expectations.
+
+## How Keploy works with Test Driven Development ?
-Here's how you can perform TDD with Keploy:
+[Keploy](https://keploy.io) can be integrated into your Test Driven Development workflow to automate testing processes and streamline development.Here's how you can perform TDD with Keploy:
- **Write a Failing Test**: Begin by writing a test case for a specific functionality or requirement of your application. The test should fail initially since the corresponding functionality has not been implemented yet.
@@ -79,18 +142,18 @@ Here's how you can perform TDD with Keploy:
## Comparison Table: TDD vs. BDD vs. Traffic Driven Testing
-| Aspect | Test Driven Development (TDD) | Behavior Driven Development (BDD) | Traffic Driven Testing (Traffic) |
-| ---------------------- | ---------------------------------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------- |
-| **Primary Focus** | Unit testing and code design | Collaboration and end-user behavior | Real-world traffic simulation and testing |
-| **Tests Written By** | Developers | Collaboration between developers, testers, and business stakeholders | Developers and testers using real traffic data |
-| **Language for Tests** | Programming language of the application | Natural language (Gherkin syntax) | Real traffic data captured from production |
-| **Testing Levels** | Primarily unit testing | Acceptance, integration, and system testing | End-to-end, performance, and load testing |
-| **Tools** | JUnit, pytest, NUnit | Cucumber, SpecFlow, Behave | Traffic simulators, load testing tools, Keploy |
-| **Documentation** | Code-focused tests that serve as documentation | Plain language scenarios accessible to non-technical stakeholders | Traffic patterns and logs |
-| **Target Audience** | Primarily developers | Both technical and non-technical team members | Developers, testers, and operations teams |
-| **Cycle** | Write tests, implement code, refactor | Define behavior, write scenarios, automate tests, validate behavior | Capture traffic, simulate/test traffic, analyze results |
-| **Emphasis** | Code correctness | Meeting user expectations and business goals | Real-world user behavior and system performance |
-| **Collaboration** | Primarily within development team | High collaboration across all stakeholders | Collaboration between development, testing, and operations teams |
+| Aspect | Test Driven Development (TDD) | Behavior Driven Development (BDD) | Traffic Driven Testing (Traffic) |
+| ---------------------- | --------------------------------------------------------------- | -------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| **Primary Focus** | Unit testing and code design | Collaboration and end-user behavior | Real-world traffic simulation and testing |
+| **Tests Written By** | Developers | Collaboration between developers, testers, and business stakeholders | Developers and testers using real traffic data |
+| **Language for Tests** | Programming language of the application | Natural language (Gherkin syntax) | Real traffic data captured from production |
+| **Testing Levels** | Primarily [unit testing](https://keploy.io/unit-test-generator) | Acceptance, integration, and system testing | End-to-end, performance, and [load testing](https://keploy.io/blog/community/all-about-load-testing-a-detailed-guide) |
+| **Tools** | JUnit, pytest, NUnit | Cucumber, SpecFlow, Behave | Traffic simulators, load testing tools, Keploy |
+| **Documentation** | Code-focused tests that serve as documentation | Plain language scenarios accessible to non-technical stakeholders | Traffic patterns and logs |
+| **Target Audience** | Primarily developers | Both technical and non-technical team members | Developers, testers, and operations teams |
+| **Cycle** | Write tests, implement code, refactor | Define behavior, write scenarios, automate tests, validate behavior | Capture traffic, simulate/test traffic, analyze results |
+| **Emphasis** | Code correctness | Meeting user expectations and business goals | Real-world user behavior and system performance |
+| **Collaboration** | Primarily within development team | High collaboration across all stakeholders | Collaboration between development, testing, and operations teams |
![TDD vs. BDD vs. Traffic Driven Testing](https://images.ctfassets.net/vrc8wif0t20g/6YGzPeOoQlewSQ07sX7a9P/6815d8dffd1523e43040b17e78a39f73/BDD_vs._TDD__Differences_Explained.png)
@@ -98,28 +161,28 @@ Here's how you can perform TDD with Keploy:
In conclusion, Test Driven Development (TDD) is a valuable approach for software development. It provides numerous benefits such as ensuring code quality, facilitating bug fixing and troubleshooting, and encouraging modular and maintainable code. By writing tests first, developers can define the expected behavior of their code and verify that it meets the specified requirements. TDD can be integrated into the development workflow with tools like Keploy, automating testing processes and streamlining development. While TDD may not be suitable for all projects, it is a powerful technique that can greatly enhance the quality and reliability of software.
-## FAQs about Test Driven Development (TDD)
+## FAQ
-### 1. **What is Test Driven Development (TDD)?**
+### **What is Test Driven Development (TDD)?**
Test Driven Development (TDD) is a software development approach where tests are written before the actual code. It focuses on defining the requirements and test scenarios upfront to ensure that the code meets the specified functionality.
-### 2. **What are the main benefits of TDD?**
+### **What are the main benefits of TDD?**
TDD helps ensure code quality, encourages modular and maintainable code, facilitates bug fixing and troubleshooting, and provides a safety net for refactoring legacy code.
-### 3. **How does TDD differ from BDD?**
+### **How does TDD differ from BDD?**
TDD focuses on writing unit tests before coding, emphasizing code correctness and design. BDD, on the other hand, focuses on collaboration and defining behavior from the user's perspective using natural language scenarios.
-### 4. **Can TDD be used for all types of projects?**
+### **Can TDD be used for all types of projects?**
While TDD is highly effective for many types of projects, it may not be suitable for all. Projects with rapidly changing requirements or those that require extensive UI testing might benefit more from complementary approaches like BDD or Traffic Driven Testing.
-### 5. **What are the challenges of implementing TDD?**
+### **What are the challenges of implementing TDD?**
Challenges include the initial learning curve, the need for disciplined test writing, potential increased development time upfront, and the difficulty of writing tests for complex or legacy codebases.
-### 6. **How can TDD be integrated into a CI/CD pipeline?**
+### **How can TDD be integrated into a CI/CD pipeline?**
TDD can be integrated into a CI/CD pipeline by automating the execution of tests with each code commit, monitoring code coverage, and ensuring that tests are consistently run to maintain code quality throughout the development lifecycle.
diff --git a/versioned_docs/version-2.0.0/concepts/reference/glossary/unit-test-automation.md b/versioned_docs/version-2.0.0/concepts/reference/glossary/unit-test-automation.md
index e90cff4cf..92e35eae2 100644
--- a/versioned_docs/version-2.0.0/concepts/reference/glossary/unit-test-automation.md
+++ b/versioned_docs/version-2.0.0/concepts/reference/glossary/unit-test-automation.md
@@ -1,15 +1,38 @@
---
id: unit-test-automation
-title: What is Unit Test Automation?
-seoTitle: "Understanding Unit Test Automation: A Comprehensive Guide"
-seoDescription: "Discover what unit test automation is, its benefits, best practices, and how it streamlines software development for better quality."
+title: "Master Unit Test Automation: A Developerâs Essential Guide"
+seoTitle: "Master Unit Test Automation: A Developerâs Essential Guide"
+seoDescription: Discover how to simplify testing workflows with our expert guide to unit test automation. Tools, benefits, and best practices all in one place!
sidebar_label: Unit Test Automation
-description: Simplify Your Testing Workflow with Unit Test Automation. Streamline processes for efficient and effective software testing.
+description: Discover how to simplify testing workflows with our expert guide to unit test automation. Tools, benefits, and best practices all in one place!
tags:
- explanation
- Glossary
keywords:
- API
+ - Unit testing tools
+ - Test automation
+ - Automated testing frameworks
+ - Unit test best practices
+ - Continuous integration
+ - Test-driven development (TDD)
+ - Software testing
+ - Code quality assurance
+ - Automated testing benefits
+ - Unit testing examples
+ - Python unit tests
+ - Java unit testing
+ - Unit testing frameworks comparison
+ - Mock testing
+ - Code reliability
+ - CI/CD testing automation
+ - Unit test automation for developers
+ - Unit testing in software development
+ - Automated test scripts
+ - Bug detection through unit testing
+ - Software development testing tools
+ - ai testing agent
+ - opensource testing agent
---
Automating Unit Test is the practice of using automated tools and scripts to execute a set of predefined tests on individual units of code. These tests verify that each unit functions as intended, isolating and validating specific functionalities in an automated and repeatable manner.
@@ -94,11 +117,11 @@ Integrate your unit tests into your CI/CD pipeline to ensure they run automatica
- **Ignoring Test Failures**: Treat failing tests as a critical issue rather than a minor inconvenience. Investigate and fix them promptly to maintain the integrity of your code.
-## What are some unit test automation tools?
+## Best Tools for Automated Unit Testing
There are many unit testing tools available for a wide range of languages and environments. Some popular tools include:
-### Keploy
+### How to Use Keploy for Unit Testing
Keploy offers a one-click unit test generation tool that streamlines the testing process for developers. Instead of spending time writing test cases from scratch, you can generate them instantly, allowing you to focus on coding and delivering new features.
@@ -109,7 +132,7 @@ Keploy offers a one-click unit test generation tool that streamlines the testing
- **Focus on Quality**: Spend more time writing high-quality code while ensuring thorough validation.
![Keploy](../../../../../static/img/glossary/keploy_VS.png)
-Get started by downloading the tool from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=Keploy.keployio) and boost your development workflow today!
+Learn how to automate unit tests with these tools - [click to explore](https://keploy.io/blog/community/boost-unit-test-efficiency-using-ai-powered-extensions-for-vs-code)!
### pytest (Python)
diff --git a/versioned_docs/version-2.0.0/concepts/reference/glossary/unit-testing.md b/versioned_docs/version-2.0.0/concepts/reference/glossary/unit-testing.md
index 2bc42c959..a31c6b9a5 100644
--- a/versioned_docs/version-2.0.0/concepts/reference/glossary/unit-testing.md
+++ b/versioned_docs/version-2.0.0/concepts/reference/glossary/unit-testing.md
@@ -13,6 +13,30 @@ keywords:
- software testing
- e2e testing
- integration testing
+ - automated unit testing
+ - unit test automation tools
+ - test case generation
+ - test-driven development
+ - debugging tools for testing
+ - JUnit integration
+ - PHPUnit testing
+ - PyTest unit tests
+ - Selenium testing
+ - test case validation
+ - dynamic test cases
+ - unit testing frameworks
+ - Keploy test automation
+ - continuous integration testing
+ - automated testing for developers
+ - bug detection in unit tests
+ - test automation best practices
+ - software quality assurance
+ - automated test debugging
+ - unit testing benefits
+ - test coverage tools
+ - CI/CD and testing
+ - ai testing agent
+ - opensource testing agent
---
## What is Unit Testing?
diff --git a/versioned_docs/version-2.0.0/keploy-explained/common-errors.md b/versioned_docs/version-2.0.0/keploy-explained/common-errors.md
new file mode 100644
index 000000000..db15e9afe
--- /dev/null
+++ b/versioned_docs/version-2.0.0/keploy-explained/common-errors.md
@@ -0,0 +1,202 @@
+---
+id: errors
+title: Common Errors in Keploy
+sidebar_label: Common Errors
+tags:
+ - explanation
+ - faq
+---
+
+Let's check some of the common errors that you might encounter while working with Keploy!
+
+[](https://camo.githubusercontent.com/74cbc79070c04e7077cfd86981c110678fe434e9269ea8f52eafb37b781cfb4a/68747470733a2f2f646f63732e6b65706c6f792e696f2f696d672f6b65706c6f792d6c6f676f2d6461726b2e7376673f733d32303026763d34)
+
+### 1. Dependency Not Found Error
+
+#### Description:
+
+This error occurs when Keploy cannot locate or access a required dependency, such as a database or external service.
+
+#### Possible Cause:
+
+- The dependency may not be running or is incorrectly configured.
+- Networking issues may be preventing Keploy from connecting to external dependencies.
+
+#### Solution:
+
+- Verify that all required services (e.g., databases, third-party APIs) are active and accessible.
+- Check the environment variables or configuration files to confirm the correct host and port details.
+- Use network diagnostic tools (e.g., ping, traceroute) to identify connectivity issues.
+
+### 2. Unable to Record API Calls
+
+#### Description:
+
+Keploy fails to record incoming API traffic, meaning no tests are generated.
+
+#### Possible Cause:
+
+- Incorrect integration with the application.
+- Keploy may not be correctly started with the application, or the SDK is not configured properly.
+- The application may not be making API calls that are recognizable by Keploy.
+
+#### Solution:
+
+- Double-check the integration guide for the programming language youâre using.
+- Ensure that Keploy is properly hooked into the API layer.
+- Check Keploy logs for any missed or skipped requests.
+
+### 3. Test Replay Failure
+
+#### Description:
+
+Keploy is unable to replay recorded API requests.
+
+#### Possible Cause:
+
+- External services or databases may be in a different state than they were during recording.
+- Non-deterministic values like timestamps, UUIDs, or random values are causing failures.
+
+#### Solution:
+
+- Leverage Keployâs mocking capabilities to simulate external services and databases.
+- Use configurations to handle or exclude non-deterministic values for consistent comparisons.
+- Regularly reset the database state to match the conditions during recording.
+
+### 4. Response Mismatch Error
+
+#### Description:
+
+When Keploy replays API calls, it detects a mismatch between the recorded response and the current response.
+
+#### Possible Cause:
+
+- The applicationâs behavior has changed, leading to different responses.
+- Changes in the response format, status codes, or headers that werenât present during recording.
+
+#### Solution:
+
+- Review the application changes and determine if the mismatch is expected (e.g., new features).
+- If the change is acceptable, update the test baseline to reflect the new behavior.
+- Use Keployâs flexible comparison options to ignore certain fields or values (like timestamps or version numbers).
+
+### 5. Incorrect Test Generation
+
+#### Description:
+
+Keploy generates tests that donât properly reflect the API interactions.
+
+#### Possible Cause:
+
+- The API interaction may be too complex or involve custom logic that Keploy cannot automatically handle.
+- API parameters may be missing or misinterpreted during recording.
+
+#### Solution:
+
+- Review the recorded test cases for correctness.
+- Manually adjust the generated tests to include missing or misinterpreted parameters.
+- Make use of Keployâs API to refine the recording process if necessary.
+
+### 6. Database Connection Error during Test Replay
+
+#### Description:
+
+Keploy cannot connect to the database or other external systems during the replay of tests.
+
+#### Possible Cause:
+
+- The test environment may not have access to the same database as the original recording.
+- Database credentials or host information could be incorrect or missing in the test environment.
+
+#### Solution:
+
+- Mirror the test environment configuration with the recording setup.
+- Use database mocks or stubs for isolated testing.
+- Double-check connection strings, credentials, and database availability.
+
+### 7. Missing or Invalid Configuration Error
+
+#### Description:
+
+Keploy cannot find a valid configuration file or encounters errors in the configuration.
+
+#### Possible Cause:
+
+- The Keploy configuration file (keploy.yaml or similar) is missing or contains invalid values.
+- Environment variables required by Keploy may not be set.
+
+#### Solution:
+
+- Ensure the configuration file exists and follows the correct format.
+- Populate all required fields with valid values.
+- Check that environment variables are properly set.
+
+### 8. Timeout Errors
+
+#### Description:
+
+Keploy times out while recording or replaying API calls.
+
+#### Possible Cause:
+
+- Long-running API requests or slow external dependencies can cause timeout issues.
+- Keploy may have low timeout settings for API calls.
+
+#### Solution:
+
+- Increase timeout settings in the Keploy configuration.
+- Identify and optimize slow-performing APIs or dependencies.
+- Use monitoring tools to analyze API performance.
+
+### 9. Insufficient Permissions
+
+#### Description:
+
+Keploy fails due to insufficient permissions when accessing files, networks, or other resources.
+
+#### Possible Cause:
+
+The user or service running Keploy may not have sufficient permissions to access resources like databases, APIs, or file systems.
+
+#### Solution:
+
+- Ensure that the user or service running Keploy has the necessary permissions.
+- Review system permissions and provide the required access rights for Keploy to function properly.
+
+### 10. Version Compatibility Issues
+
+#### Description:
+
+Errors occur because of version mismatches between Keploy, its dependencies, or the application itâs testing.
+
+#### Possible Cause:
+
+- Using incompatible versions of Keploy or related SDKs with your application.
+- Dependencies of Keploy (e.g., for mocking or replaying) may have updated and broken compatibility.
+
+#### Solution:
+
+- Verify version compatibility for Keploy and its SDKs.
+- Consult Keploy documentation or release notes for known issues.
+- Use version pinning to maintain a stable environment.
+
+### 11. Unsupported Protocol or API
+
+#### Description:
+
+Keploy does not support the protocol or API structure you are using (e.g., gRPC, SOAP, etc.).
+
+#### Possible Cause:
+
+- The application might use an API or protocol that Keploy doesnât yet support (e.g., WebSocket, gRPC).
+
+#### Solution:
+
+- Confirm the supported protocols (currently HTTP/REST and GraphQL).
+- Consider alternative tools or frameworks for unsupported protocols.
+
+If youâre still encountering issues after trying these solutions, feel free to reach out to the Keploy team or consult the community forums for additional support. Happy testing!
+
+import GetSupport from '../concepts/support.md'
+
+
diff --git a/versioned_docs/version-2.0.0/keploy-explained/mac-linux.md b/versioned_docs/version-2.0.0/keploy-explained/mac-linux.md
index b83429b36..eecf4f1b0 100644
--- a/versioned_docs/version-2.0.0/keploy-explained/mac-linux.md
+++ b/versioned_docs/version-2.0.0/keploy-explained/mac-linux.md
@@ -1,7 +1,7 @@
---
id: mac-linux
title: "Running Keploy Natively on MacOS by setting up a linux env"
-sidebar_label: Keploy on MacOS native
+sidebar_label: MacOS Native
---
# Running Keploy Natively on MacOS by setting up a linux env
diff --git a/versioned_sidebars/version-2.0.0-sidebars.json b/versioned_sidebars/version-2.0.0-sidebars.json
index a65023772..71daa0687 100644
--- a/versioned_sidebars/version-2.0.0-sidebars.json
+++ b/versioned_sidebars/version-2.0.0-sidebars.json
@@ -45,7 +45,7 @@
"type": "category",
"label": "Quickstart Guide",
"collapsible": true,
- "collapsed": true,
+ "collapsed": false,
"items": [
{
"type": "category",
@@ -163,7 +163,8 @@
"collapsible": true,
"collapsed": true,
"items": [
- "keploy-explained/faq"
+ "keploy-explained/faq",
+ "keploy-explained/errors"
]
}
],