internal/

directory
v0.7.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 11, 2026 License: Apache-2.0

Directories

Path Synopsis
Package audit implements FR-CLI-07: an audit record of every run — trigger source, target, parameters, and timestamp — appended to a local, append-only JSONL file.
Package audit implements FR-CLI-07: an audit record of every run — trigger source, target, parameters, and timestamp — appended to a local, append-only JSONL file.
Package compare diffs two report.Result values (typically JSON from `vegaload run -out`) so a later run can be checked against a baseline without a baseline registry or history store — just two files.
Package compare diffs two report.Result values (typically JSON from `vegaload run -out`) so a later run can be checked against a baseline without a baseline registry or history store — just two files.
Package diagnose implements the rule-based half of FR-MCP-05's diagnose_failure / vegaload diagnose: a set of fixed heuristics over a report.Result that flag the failure patterns a human reviewing a load test would look for first, plus a pure-arithmetic threshold suggester.
Package diagnose implements the rule-based half of FR-MCP-05's diagnose_failure / vegaload diagnose: a set of fixed heuristics over a report.Result that flag the failure patterns a human reviewing a load test would look for first, plus a pure-arithmetic threshold suggester.
Package doctor implements `vegaload doctor`: a set of small, independent checks that answer "will VegaLoad work from here?" for the CLI, for each agent host (Cursor, Claude Code, Claude Desktop), and for a target.
Package doctor implements `vegaload doctor`: a set of small, independent checks that answer "will VegaLoad work from here?" for the CLI, for each agent host (Cursor, Claude Code, Claude Desktop), and for a target.
Package engine implements VegaLoad's core execution engine: the virtual user (VU) scheduler and the load-shape executors that decide how many VUs run, and when, over the life of a scenario.
Package engine implements VegaLoad's core execution engine: the virtual user (VU) scheduler and the load-shape executors that decide how many VUs run, and when, over the life of a scenario.
Package eval implements FR-MCP-04's versioned MCP tool-calling evaluation suite: a fixed set of {tool, arguments, expected outcome} cases, embedded into the binary and versioned by directory (v1, and any v2+ added later without touching v1's cases) so a suite someone has pinned to doesn't silently change underneath them.
Package eval implements FR-MCP-04's versioned MCP tool-calling evaluation suite: a fixed set of {tool, arguments, expected outcome} cases, embedded into the binary and versioned by directory (v1, and any v2+ added later without touching v1's cases) so a suite someone has pinned to doesn't silently change underneath them.
Package har turns a HAR file (the recording a browser's network tab can save) into a VegaLoad JavaScript scenario.
Package har turns a HAR file (the recording a browser's network tab can save) into a VegaLoad JavaScript scenario.
Package hosts describes the agent hosts VegaLoad integrates with (Cursor, Claude Code, Claude Desktop) in one place: where each host keeps its MCP server config, which rules or skill files it reads, and how to detect that it is installed.
Package hosts describes the agent hosts VegaLoad integrates with (Cursor, Claude Code, Claude Desktop) in one place: where each host keeps its MCP server config, which rules or skill files it reads, and how to detect that it is installed.
Package inputs gives scenario scripts the data and settings they read from outside the script (FR-CLI-17): data files whose rows feed virtual users, and environment variables the run exposes by name.
Package inputs gives scenario scripts the data and settings they read from outside the script (FR-CLI-17): data files whose rows feed virtual users, and environment variables the run exposes by name.
Package llm implements FR-MCP-05's optional BYO-LLM narrative layer: turning a diagnose.Findings into a short plain-English explanation by calling a user-configured LLM endpoint.
Package llm implements FR-MCP-05's optional BYO-LLM narrative layer: turning a diagnose.Findings into a short plain-English explanation by calling a user-configured LLM endpoint.
Package mcp implements FR-MCP-01/02/03's agent-native layer: a hand-rolled JSON-RPC 2.0 server speaking the Model Context Protocol over stdio (no third-party SDK — see go.mod's dependency-pinning history for why this project prefers stdlib-only solutions).
Package mcp implements FR-MCP-01/02/03's agent-native layer: a hand-rolled JSON-RPC 2.0 server speaking the Model Context Protocol over stdio (no third-party SDK — see go.mod's dependency-pinning history for why this project prefers stdlib-only solutions).
Package mcpprobe is a minimal MCP client for health checks.
Package mcpprobe is a minimal MCP client for health checks.
Package openapi implements FR-MCP-06's `vegaload new --from-openapi` and the generate_from_spec MCP tool: turning an OpenAPI document into a ready-to-run starting point for load testing its endpoints.
Package openapi implements FR-MCP-06's `vegaload new --from-openapi` and the generate_from_spec MCP tool: turning an OpenAPI document into a ready-to-run starting point for load testing its endpoints.
Package protocol defines the shared interface every wire protocol driver (HTTP/1.1, HTTP/2, gRPC, WebSocket, TCP, UDP) implements, plus the request and result types they exchange with the engine.
Package protocol defines the shared interface every wire protocol driver (HTTP/1.1, HTTP/2, gRPC, WebSocket, TCP, UDP) implements, plus the request and result types they exchange with the engine.
ftp
Package ftp implements the "ftp" protocol.Protocol driver.
Package ftp implements the "ftp" protocol.Protocol driver.
ftp/ftptest
Package ftptest is a small FTP server for tests.
Package ftptest is a small FTP server for tests.
grpc
Package grpc implements a protocol.Protocol driver for gRPC.
Package grpc implements a protocol.Protocol driver for gRPC.
grpc/grpctest
Package grpctest runs a small in-process gRPC server for tests in other packages.
Package grpctest runs a small in-process gRPC server for tests in other packages.
http1
Package http1 implements a protocol.Protocol driver that speaks plain HTTP/1.1.
Package http1 implements a protocol.Protocol driver that speaks plain HTTP/1.1.
http2
Package http2 implements a protocol.Protocol driver that speaks HTTP/2, over TLS (the normal case, negotiated via ALPN) or over plain TCP ("h2c") when the target is an http:// URL — many internal services run h2c precisely to skip TLS termination, and a load tester that only understood h2-over-TLS would be unable to test them at all.
Package http2 implements a protocol.Protocol driver that speaks HTTP/2, over TLS (the normal case, negotiated via ALPN) or over plain TCP ("h2c") when the target is an http:// URL — many internal services run h2c precisely to skip TLS termination, and a load tester that only understood h2-over-TLS would be unable to test them at all.
kafka
Package kafka implements the "kafka" protocol.Protocol driver, for load testing an Apache Kafka cluster (or any broker that speaks the Kafka protocol).
Package kafka implements the "kafka" protocol.Protocol driver, for load testing an Apache Kafka cluster (or any broker that speaks the Kafka protocol).
kafka/kafkatest
Package kafkatest is a small fake Kafka broker for tests, so the Kafka driver and the scripting layer can be tested without Docker.
Package kafkatest is a small fake Kafka broker for tests, so the Kafka driver and the scripting layer can be tested without Docker.
mqtt
Package mqtt implements the "mqtt" protocol.Protocol driver, for load testing an MQTT 3.1.1 broker.
Package mqtt implements the "mqtt" protocol.Protocol driver, for load testing an MQTT 3.1.1 broker.
mqtt/mqtttest
Package mqtttest is a very small MQTT 3.1.1 broker for tests in other packages, so scripts can be tested without a real broker.
Package mqtttest is a very small MQTT 3.1.1 broker for tests in other packages, so scripts can be tested without a real broker.
mysql
Package mysql implements the "mysql" protocol.Protocol driver, for load testing a MySQL or MariaDB server (or a database that speaks the same wire protocol, such as TiDB).
Package mysql implements the "mysql" protocol.Protocol driver, for load testing a MySQL or MariaDB server (or a database that speaks the same wire protocol, such as TiDB).
mysql/mysqltest
Package mysqltest is a small fake MySQL server for tests, in this package and in others.
Package mysqltest is a small fake MySQL server for tests, in this package and in others.
postgres
Package postgres implements the "postgres" protocol.Protocol driver, for load testing a PostgreSQL server (or a database that speaks its wire protocol, such as CockroachDB, YugabyteDB or Aurora).
Package postgres implements the "postgres" protocol.Protocol driver, for load testing a PostgreSQL server (or a database that speaks its wire protocol, such as CockroachDB, YugabyteDB or Aurora).
postgres/postgrestest
Package postgrestest is a small fake PostgreSQL server for tests, in this package and in others.
Package postgrestest is a small fake PostgreSQL server for tests, in this package and in others.
rabbitmq
Package rabbitmq implements the "rabbitmq" protocol.Protocol driver, for load testing a RabbitMQ 3.12 or later broker (and other brokers that speak AMQP 0-9-1).
Package rabbitmq implements the "rabbitmq" protocol.Protocol driver, for load testing a RabbitMQ 3.12 or later broker (and other brokers that speak AMQP 0-9-1).
rabbitmq/rabbitmqtest
Package rabbitmqtest is a small AMQP 0-9-1 broker for tests.
Package rabbitmqtest is a small AMQP 0-9-1 broker for tests.
redis
Package redis implements the "redis" protocol.Protocol driver, for load testing a Redis server or a store that speaks the same wire protocol (Valkey, and often KeyDB, Dragonfly and Garnet).
Package redis implements the "redis" protocol.Protocol driver, for load testing a Redis server or a store that speaks the same wire protocol (Valkey, and often KeyDB, Dragonfly and Garnet).
redis/redistest
Package redistest is a small Redis server for tests.
Package redistest is a small Redis server for tests.
socket
Package socket implements the "tcp" and "udp" protocol.Protocol drivers: raw sockets, for a service that speaks its own wire protocol (a custom binary protocol, SMTP, Redis, a syslog or DNS port) and has no driver of its own.
Package socket implements the "tcp" and "udp" protocol.Protocol drivers: raw sockets, for a service that speaks its own wire protocol (a custom binary protocol, SMTP, Redis, a syslog or DNS port) and has no driver of its own.
sqlcommon
Package sqlcommon holds the small pieces the SQL drivers share: reading the args option, and the min_rows and expect checks.
Package sqlcommon holds the small pieces the SQL drivers share: reading the args option, and the min_rows and expect checks.
websocket
Package websocket implements a protocol.Protocol driver for WebSocket.
Package websocket implements a protocol.Protocol driver for WebSocket.
xfercommon
Package xfercommon holds helpers for a file transfer that do not know which protocol is moving the bytes.
Package xfercommon holds helpers for a file transfer that do not know which protocol is moving the bytes.
Package pyfind finds a Python 3 interpreter.
Package pyfind finds a Python 3 interpreter.
Package report implements FR-RPT-01 through 04 and FR-CLI-05: turning a run's recorded iterations into the structured data a self-contained HTML report, a JSON summary, and (eventually) the MCP get_results tool all read from.
Package report implements FR-RPT-01 through 04 and FR-CLI-05: turning a run's recorded iterations into the structured data a self-contained HTML report, a JSON summary, and (eventually) the MCP get_results tool all read from.
Package safety implements FR-CLI-06: a target allowlist plus hard caps on RPS, duration, and concurrency, enforced by default on every run.
Package safety implements FR-CLI-06: a target allowlist plus hard caps on RPS, duration, and concurrency, enforced by default on every run.
scripting
js
Package js runs a scenario written as a JavaScript or TypeScript file, using the embedded Goja ECMAScript runtime — no Node.js, no network fetch of a runtime, and no separate build step for the author.
Package js runs a scenario written as a JavaScript or TypeScript file, using the embedded Goja ECMAScript runtime — no Node.js, no network fetch of a runtime, and no separate build step for the author.
netapi
Package netapi gives VegaLoad's scripting runtimes (internal/scripting/js and /python) the real HTTP and WebSocket access FR-CLI-08 asks for: a scenario script can make an actual network call and read the response (status, headers, body) back into the script, unlike internal/protocol's drivers, which exist to repeat one fixed Target and discard the response body entirely -- see protocol.Result's doc comment, and http1.Driver.Do, which io.Copy's the body straight to io.Discard.
Package netapi gives VegaLoad's scripting runtimes (internal/scripting/js and /python) the real HTTP and WebSocket access FR-CLI-08 asks for: a scenario script can make an actual network call and read the response (status, headers, body) back into the script, unlike internal/protocol's drivers, which exist to repeat one fixed Target and discard the response body entirely -- see protocol.Result's doc comment, and http1.Driver.Do, which io.Copy's the body straight to io.Discard.
python
Package python runs a scenario written as a Python file, by shelling out to a python3 interpreter the user has installed separately.
Package python runs a scenario written as a Python file, by shelling out to a python3 interpreter the user has installed separately.
Package secrets keeps the values a scenario read as secrets (FR-CLI-17) out of everything VegaLoad writes or prints.
Package secrets keeps the values a scenario read as secrets (FR-CLI-17) out of everything VegaLoad writes or prints.
Package skills implements FR-MCP-04's agent skill bundles and the `vegaload init` command built on them: the actual Markdown content Claude Code and Cursor read to know when and how to call VegaLoad's MCP tools, embedded into the compiled binary at build time (via go:embed) so `vegaload init` can write them out without needing the vegaload source tree to be present on the machine it's installed on.
Package skills implements FR-MCP-04's agent skill bundles and the `vegaload init` command built on them: the actual Markdown content Claude Code and Cursor read to know when and how to call VegaLoad's MCP tools, embedded into the compiled binary at build time (via go:embed) so `vegaload init` can write them out without needing the vegaload source tree to be present on the machine it's installed on.
Package threshold implements FR-CLI-11: pass/fail thresholds on a run's own results, so a run can gate a CI pipeline.
Package threshold implements FR-CLI-11: pass/fail thresholds on a run's own results, so a run can gate a CI pipeline.
Package urlerr keeps a password out of an error about a URL.
Package urlerr keeps a password out of an error about a URL.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL