Smoke Test
Getting Started
Getting Started
CLI Command
Skyramp Generate Command - Fuzz Testing
% skyramp generate fuzz rest --help
Generate fuzz tests for REST protocol
Usage:
skyramp generate fuzz rest <endpoint_url> -X <rest-method> --request-data <sample-request> [flags]
skyramp generate fuzz rest <endpoint_url> -X POST --form-params <form-params> [flags]
skyramp generate fuzz rest <endpoint_url> --api-schema <path-to-spec> [flags]
skyramp generate fuzz rest <endpoint_url> --trace <path-to-trace> [flags]
skyramp generate fuzz rest --help
Arguments:
endpoint_url Test is created for this endpoint url
Examples:
skyramp generate fuzz rest https://skyramp.dev/api/products -X POST --language python --request-data @request.json --output fuzz_POST_test.py --output-dir ./Documents/Skyramp/
Input Flags:
--api-schema Path to OpenAPI specification
--exclude Comma-separated list of svc/alias/FQDN to exclude from trace collection or test generation from trace
--include Comma-separated list of svc/alias/FQDN to only include in trace collection or test generation from trace
-X, --method REST method to be tested
--request-data Sample request data as JSON/YAML blob or @path to a file
--response-data Sample response data as JSON/YAML blob or @path to a file
--response-status-code Expected response status code
--trace Path to trace file from Skyramp worker
Param Flags:
--auth-header Authorization header type
--form-params Form parameters for POST methods
--path-params Comma-separated list of path parameters
--query-params Comma-separated list of query parameters
Output Flags:
--deploy-dashboard Deploy the Skyramp dashboard for test result collection [default: false]
--framework Testing framework for generated test [junit, playwright, pytest, robot] [default: pytest]
--language Language for generated test [java, javascript, python, typescript] [default: python]
--output Generated test name
--output-dir Location to write generated tests
--overwrite Overwrite existing tests without additional confirmation [default: false]
Runtime Flags:
--docker-network Docker network for skyramp worker [default: skyramp]
--docker-skyramp-port Docker port for skyramp worker [default: 35142]
-k, --insecure Skip ssl server verification [default: false]
--runtime Environment where test should run [docker, local]
Inherited Flags:
-h, --help Show help for command and list available subcommands
Skyramp Generate Command - Fuzz Testing
% skyramp generate fuzz rest --help
Generate fuzz tests for REST protocol
Usage:
skyramp generate fuzz rest <endpoint_url> -X <rest-method> --request-data <sample-request> [flags]
skyramp generate fuzz rest <endpoint_url> -X POST --form-params <form-params> [flags]
skyramp generate fuzz rest <endpoint_url> --api-schema <path-to-spec> [flags]
skyramp generate fuzz rest <endpoint_url> --trace <path-to-trace> [flags]
skyramp generate fuzz rest --help
Arguments:
endpoint_url Test is created for this endpoint url
Examples:
skyramp generate fuzz rest https://skyramp.dev/api/products -X POST --language python --request-data @request.json --output fuzz_POST_test.py --output-dir ./Documents/Skyramp/
Input Flags:
--api-schema Path to OpenAPI specification
--exclude Comma-separated list of svc/alias/FQDN to exclude from trace collection or test generation from trace
--include Comma-separated list of svc/alias/FQDN to only include in trace collection or test generation from trace
-X, --method REST method to be tested
--request-data Sample request data as JSON/YAML blob or @path to a file
--response-data Sample response data as JSON/YAML blob or @path to a file
--response-status-code Expected response status code
--trace Path to trace file from Skyramp worker
Param Flags:
--auth-header Authorization header type
--form-params Form parameters for POST methods
--path-params Comma-separated list of path parameters
--query-params Comma-separated list of query parameters
Output Flags:
--deploy-dashboard Deploy the Skyramp dashboard for test result collection [default: false]
--framework Testing framework for generated test [junit, playwright, pytest, robot] [default: pytest]
--language Language for generated test [java, javascript, python, typescript] [default: python]
--output Generated test name
--output-dir Location to write generated tests
--overwrite Overwrite existing tests without additional confirmation [default: false]
Runtime Flags:
--docker-network Docker network for skyramp worker [default: skyramp]
--docker-skyramp-port Docker port for skyramp worker [default: 35142]
-k, --insecure Skip ssl server verification [default: false]
--runtime Environment where test should run [docker, local]
Inherited Flags:
-h, --help Show help for command and list available subcommands
Skyramp Generate Command - Fuzz Testing
% skyramp generate fuzz rest --help
Generate fuzz tests for REST protocol
Usage:
skyramp generate fuzz rest <endpoint_url> -X <rest-method> --request-data <sample-request> [flags]
skyramp generate fuzz rest <endpoint_url> -X POST --form-params <form-params> [flags]
skyramp generate fuzz rest <endpoint_url> --api-schema <path-to-spec> [flags]
skyramp generate fuzz rest <endpoint_url> --trace <path-to-trace> [flags]
skyramp generate fuzz rest --help
Arguments:
endpoint_url Test is created for this endpoint url
Examples:
skyramp generate fuzz rest https://skyramp.dev/api/products -X POST --language python --request-data @request.json --output fuzz_POST_test.py --output-dir ./Documents/Skyramp/
Input Flags:
--api-schema Path to OpenAPI specification
--exclude Comma-separated list of svc/alias/FQDN to exclude from trace collection or test generation from trace
--include Comma-separated list of svc/alias/FQDN to only include in trace collection or test generation from trace
-X, --method REST method to be tested
--request-data Sample request data as JSON/YAML blob or @path to a file
--response-data Sample response data as JSON/YAML blob or @path to a file
--response-status-code Expected response status code
--trace Path to trace file from Skyramp worker
Param Flags:
--auth-header Authorization header type
--form-params Form parameters for POST methods
--path-params Comma-separated list of path parameters
--query-params Comma-separated list of query parameters
Output Flags:
--deploy-dashboard Deploy the Skyramp dashboard for test result collection [default: false]
--framework Testing framework for generated test [junit, playwright, pytest, robot] [default: pytest]
--language Language for generated test [java, javascript, python, typescript] [default: python]
--output Generated test name
--output-dir Location to write generated tests
--overwrite Overwrite existing tests without additional confirmation [default: false]
Runtime Flags:
--docker-network Docker network for skyramp worker [default: skyramp]
--docker-skyramp-port Docker port for skyramp worker [default: 35142]
-k, --insecure Skip ssl server verification [default: false]
--runtime Environment where test should run [docker, local]
Inherited Flags:
-h, --help Show help for command and list available subcommands