Skip to content

docs: list the calls Keploy 3.9.4 understands natively on macOS - #993

Merged
slayerjain merged 1 commit into
mainfrom
docs/macos-parsers-394-next
Nov 20, 2026
Merged

slayerjain merged 1 commit into
mainfrom
docs/macos-parsers-394-next

Conversation

@slayerjain

Copy link
Copy Markdown
Member

What changes

The platform pages said that, natively on a Mac, Keploy understands only HTTP/HTTPS, gRPC, MySQL and MongoDB calls, and keeps PostgreSQL calls and those of every other service as raw bytes that usually don't replay. That is out of date: Keploy 3.9.4's macOS CLI also decodes PostgreSQL, Aerospike, Couchbase, Memcached, Apache HBase and Apache ZooKeeper calls. It records them as mocks of their own protocol and replays them with the service stopped.

Each macOS line now lists them. Redis, Kafka and Apache Pulsar calls are still captured only as raw bytes on macOS, and the lines name them as the services that need Docker there. On Windows the native list is unchanged, since no Windows record-and-replay run has been done for these parsers yet. The shared sentence now names Apache Pulsar among the raw-bytes services and no longer names Amazon SQS, whose calls are HTTPS and are recorded by the HTTP parser.

Pages changed:

  • Concepts: Installation, Platform requirements
  • Installation: macOS
  • Keploy explained: Dev guide
  • Server: Installation, Installation tabs, macOS installation
  • content/llms-full-root.txt (the platform section and the Docker section)

How it was checked

  • The lines were read against Keploy 3.9.4's macOS build: it registers the Aerospike, Couchbase, Memcached, HBase and ZooKeeper parsers on every OS, and its macOS release build is a cgo build, which registers the PostgreSQL parser. Redis, Kafka and Pulsar are registered on Linux only in that release.
  • PostgreSQL on macOS was also run end to end on the release's own darwin build: the macOS native e2e passed 61 of 61 rows, Postgres record and replay with the server stopped among them.
  • On an Apple Silicon Mac, with each server in a container on a separate Linux host on the LAN, an app recorded its Aerospike, Couchbase, Memcached, HBase and ZooKeeper calls with keploy record and replayed them with keploy test with the server stopped, with KEPLOY_PROVEN unset and set to 1. The calls were recorded as mocks of their own protocol, none as raw bytes, and a changed answer failed the test. These runs used keploy built from the changes that shipped in 3.9.4.
  • prettier --check (the repo's prettier) on every changed Markdown file, then yarn install --frozen-lockfile, yarn build and the five yarn verify-* checks, as build_and_check.yml runs them.

The platform pages said a native macOS run keeps PostgreSQL calls, and
those of every service but HTTP/HTTPS, gRPC, MySQL and MongoDB, as raw
bytes that usually don't replay. Keploy 3.9.4's macOS CLI also decodes
PostgreSQL, Aerospike, Couchbase, Memcached, Apache HBase and Apache
ZooKeeper calls, records them as mocks of their own protocol and
replays them with the service stopped. Each macOS line now lists them.

Redis, Kafka and Apache Pulsar calls are still captured as raw bytes on
macOS, and the lines say so. The Windows lines are unchanged.

Signed-off-by: slayerjain <shubhamkjain@outlook.com>
@slayerjain
slayerjain merged commit 3d46eaa into main Nov 20, 2026
6 checks passed
@slayerjain
slayerjain deleted the docs/macos-parsers-394-next branch November 20, 2026 21:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant